このページでは

ControlStyleProperties QML Type

コントロールのスタイラスプロパティを定義します。詳細...

Import Statement: import Qt.labs.StyleKit
Inherited By:

ControlStateStyle, ControlStyle, CustomControl, and StyleReader

プロパティ

詳細説明

ControlStyleProperties は、コントロールのスタイル可能なプロパティを定義します: ビジュアルビルディングブロックbackgroundindicatorhandletext 、およびpaddingspacingtransition のようなレイアウトプロパティ。

スタイル・プロパティは、ControlStyleStyleReader のような継承された型を通してアクセスされます。

注意: Qt.labs モジュールの型は、将来のバージョンでも互換性が保たれることを保証するものではありません。

ControlStyle,StyleReader,ControlStateStyle,DelegateStyleも参照してください

プロパティのドキュメント

background : DelegateStyle

コントロールの背景をスタイリングするためのグループ化されたプロパティ。

backgroundデリゲートは通常、コントロールの背後にあるメインの視覚的な四角形です。colors,borders,radii,shadows,gradients,images を設定するために使用します。

注意: デフォルトのfallback style は、CheckBoxRadioButtonSlider など、通常は背景を描画しないコントロールに対して、background.visible からfalse を設定します。背景を表示するには、background.visibletrue に明示的に設定する。

bottomPadding : real

コントロールのbottom padding 。設定されていない場合はpadding に戻る。

padding,topPadding,leftPadding,rightPaddingも参照のこと

handle : HandleStyle

コントロールのハンドルをスタイリングするためのグループ化されたプロパティ。

ハンドルは、SwitchSliderRangeSlider などのコントロールで使用されます。RangeSlider の場合、2つのハンドルはhandle.firsthandle.second を通して個別にスタイルを設定することができます。

HandleStyleDelegateStyleも参照して ください。

indicator : IndicatorStyle

コントロールのインジケータをスタイリングするためのグループ化されたプロパティ。checkBox の場合、インジケータは枠であり、そのforeground はチェックマークである。slider の場合、インジケータは溝で、前景は塗りつぶしです。

DelegateStyleも参照

leftPadding : real

コントロールのleft padding 。設定されていない場合はpadding に戻る。

padding,rightPadding,topPadding,bottomPaddingも参照のこと

padding : real

control's content area and the bounds of the control の一様な間隔。これを設定すると、leftPaddingrightPaddingtopPaddingbottomPadding のデフォルト値となる。各辺は個別にオーバーライドできる。

leftPadding,rightPadding,topPadding,bottomPaddingも参照

rightPadding : real

コントロールのright padding 。設定されていない場合はpadding に戻る。

padding,leftPadding,topPadding,bottomPaddingも参照のこと

spacing : real

コントロール内のビジュアル要素間の間隔、例えばインジケータとラベルの間隔。

text : TextStyle

コントロールのテキストラベルをスタイリングするためのグループ化されたプロパティ。

topPadding : real

コントロールのtop padding 。設定されていない場合はpadding に戻る。

padding,bottomPadding,leftPadding,rightPaddingも参照のこと

transition : Transition

Transition コントロールがホバーされた状態や押された状態など、新しい状態になったときにスタイル プロパティをアニメーション化するために使用されます。null (デフォルト)に設定すると、プロパティの変更はアニメーションなしで即座に適用されます。

button {
    background.color: "mistyrose"
    hovered.background.color: "plum"
    transition: Transition {
        ColorAnimation {
            properties: "background.color, background.shadow.color, handle.color"
            easing.type: Easing.OutQuad
            duration: 500
        }
        NumberAnimation {
            properties: "background.leftRadius, background.rightRadius"
            easing.type: Easing.OutQuad
            duration: 500
        }
    }

    // I only want a fade-out effect (not fade-in). So while the button
    // is hovered, remove the transition, so that it only applies in the
    // normal state. In other words, it's the state being entered that
    // determines the transition, not the state that is left.
    hovered.transition: null
}

デリゲートごとに同じターゲット プロパティが繰り返されるのを避けるために、StyleKit は、StyleAnimation を提供しており、標準アニメーションの代わりに、または標準アニメーションと組み合わせて使用できます:

comboBox {
    background.color: "mistyrose"
    hovered.background.color: "plum"
    transition: Transition {
        StyleAnimation {
            animateColors: true
            animateBackgroundRadii: true
            animateIndicatorRadii: true
            animateBackgroundShadow: true
            easing.type: Easing.OutQuad
            duration: 500
        }
    }
}

また、ColorAnimation は、propertyproperties が未設定のままだと、状態変更中に変更されたすべてのカラー・プロパティをアニメーション化する特別な機能を持っていることに注意してください。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.