Control QML Type

このプロパティは、コントロールのheight から垂直パディングを差し引いた後のcontentItem で利用可能な高さを保持します。

Control Layout,padding,topPadding, およびbottomPaddingも参照のこと 。

このプロパティは、コントロールのwidth から水平方向のパディングを差し引いた後の、contentItem で利用可能な幅を保持する。

Control Layout,padding,leftPadding, およびrightPadding も参照のこと 。

このプロパティは背景項目を保持する。

Button {
    id: control
    text: qsTr("Button")
    background: Rectangle {
        implicitWidth: 100
        implicitHeight: 40
        opacity: enabled ? 1 : 0.3
        color: control.down ? "#d0d0d0" : "#e0e0e0"
    }
}

Control Layoutも参照してください 。

このプロパティは、背景のボトムインセットを保持します。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

Control Layout およびtopInset も参照して ください。

このプロパティは、ボトムパディングを保持します。明示的に設定しない限り、値はverticalPadding と等しくなります。

Control Layout,padding,topPadding,verticalPadding,availableHeightも参照 。

このプロパティはビジュアル・コンテンツ・アイテムを保持する。

Button {
    id: control
    text: qsTr("Button")
    contentItem: Label {
        text: control.text
        verticalAlignment: Text.AlignVCenter
    }
}

Control Layout とpaddingも参照して ください。

このプロパティは、最後にフォーカスが変更された理由を保持します。

このプロパティの値は、フォーカスが移動するたびに Qt によって変更されるため、このプロパティを自分で設定する必要はありません。

Item::activeFocus およびvisualFocusも参照してください 。

このプロパティは、コントロールに現在設定されているフォントを保持する。

このプロパティは、コントロールが要求するフォントを記述する。フォントは、標準コンポーネントをレンダリングするときにコントロールのスタイルによって使用され、カスタムコントロールがネイティブプラットフォームのネイティブルックアンドフィールとの一貫性を維持できるようにする手段として利用できます。プラットフォームやスタイルが異なると、アプリケーションで使用するフォントも異なるのが一般的です。

デフォルト・フォントはシステム環境に依存します。ApplicationWindow は、すべてのコントロールのデフォルトとして機能するシステム/テーマ・フォントを維持します。また、特定の種類のコントロールには、特別なフォントのデフォルトがあるかもしれません。コントロールのデフォルト・フォントを設定するには、次のようにします：

• QML をロードする前にQGuiApplication::setFont() にカスタムフォントを渡す。
• qtquickcontrols2.conf ファイルでフォントを指定する。

最後に、フォントは Qt のフォントデータベースと照合され、最適なものが見つかります。

コントロールは、明示的なフォントプロパティを親から子へ伝搬します。コントロールのフォントの特定のプロパティを変更すると、そのプロパティはコントロールのすべての子に伝わり、そのプロパティのシステムデフォルトを上書きします。

Page {
    font.family: "Courier"

    Column {
        Label {
            text: qsTr("This will use Courier...")
        }

        Switch {
            text: qsTr("... and so will this")
        }
    }
}

利用可能なフォント・プロパティの完全なリストについては、font QML Value Type ドキュメントを参照してください。

このプロパティは水平方向のパディングを保持します。明示的に設定されない限り、値はpadding に等しい。

このプロパティは、QtQuick.Controls 2.5（Qt 5.12）で導入されました。

Control Layout,padding,leftPadding,rightPadding,verticalPaddingも参照してください 。

このプロパティは、コントロールがホバーイベントを受け入れるかどうかを決定します。デフォルト値はApplication.styleHints.useHoverEffects です。

このプロパティを設定すると、hoverEnabled が明示的に設定されていないすべての子コントロールに値が伝搬されます。

また、QT_QUICK_CONTROLS_HOVER_ENABLED 環境変数を設定することで、すべてのQt Quick Controls アプリケーションでホバー効果を有効または無効にすることができます。

hoveredも参照のこと 。

このプロパティは、コントロールがホバーされるかどうかを保持します。

hoverEnabled も参照の こと。

このプロパティは、暗黙の背景の高さを保持します。

値はbackground ? background.implicitHeight : 0 に等しい。

これは通常、implicitContentHeight と共に、implicitHeight を計算するために使用されます：

Control {
    implicitHeight: Math.max(implicitBackgroundHeight + topInset + bottomInset,
                             implicitContentHeight + topPadding + bottomPadding)
}

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitBackgroundWidth およびimplicitContentHeightも参照してください 。

このプロパティは、暗黙の背景幅を保持します。

値はbackground ? background.implicitWidth : 0 と同じです。

これは通常、implicitContentWidth とともに、implicitWidth を計算するために使用されます：

Control {
    implicitWidth: Math.max(implicitBackgroundWidth + leftInset + rightInset,
                            implicitContentWidth + leftPadding + rightPadding)
}

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

implicitBackgroundHeight およびimplicitContentWidthも参照してください 。

このプロパティは、暗黙のコンテンツの高さを保持します。

基本コントロールの場合、値はcontentItem ? contentItem.implicitHeight : 0 に等しくなります。Container または Pane を継承するタイプの場合、値はコンテンツの子に基づいて計算されます。

これは通常、implicitBackgroundHeight とともに、implicitHeight を計算するために使用されます：

Control {
    implicitHeight: Math.max(implicitBackgroundHeight + topInset + bottomInset,
                             implicitContentHeight + topPadding + bottomPadding)
}

このプロパティは、QtQuick.Controls 2.5（Qt 5.12）で導入されました。

implicitContentWidth およびimplicitBackgroundHeightも参照してください 。

このプロパティは、暗黙のコンテンツ幅を保持します。

基本コントロールの場合、値はcontentItem ? contentItem.implicitWidth : 0 に等しくなります。Container または Pane を継承するタイプでは、値はコンテンツの子に基づいて計算されます。

これは通常、implicitBackgroundWidth と共に、implicitWidth を計算するために使用されます：

Control {
    implicitWidth: Math.max(implicitBackgroundWidth + leftInset + rightInset,
                            implicitContentWidth + leftPadding + rightPadding)
}

このプロパティは、QtQuick.Controls 2.5（Qt 5.12）で導入されました。

implicitContentHeight およびimplicitBackgroundWidthも参照してください 。

このプロパティは、背景の左インセットを保持します。

このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

Control Layout およびrightInset も参照して ください。

このプロパティは、左パディングを保持します。明示的に設定しない限り、値はhorizontalPadding と等しくなります。

Control Layout,padding,rightPadding,horizontalPadding,availableWidthも参照 。

このプロパティはコントロールのロケールを保持する。

このプロパティには、データや数値をフォーマットするためのロケール固有のプロパティが含まれています。特別なロケールが設定されていない限り、これは親のロケールかデフォルトのロケールです。

コントロールは親から子へロケールを伝達します。コントロールのロケールを変更すると、そのロケールはコントロールのすべての子に伝わり、システムのデフォルトロケールを上書きします。

mirroredも参照してください 。

このプロパティは、コントロールがミラーされているかどうかを保持する。

このプロパティは便宜上提供されている。つまり、LayoutMirroring.enabled がtrue の場合です。

Qt 6.2 では、locale プロパティはこのプロパティに影響しなくなりました。

LayoutMirroring およびRight-to-left User Interfacesも参照してください 。

このプロパティは、デフォルトのパディングを保持します。

パディングは、コンテンツアイテムの各辺と背景アイテムの間にスペースを追加し、コンテンツアイテムのサイズを効果的に制御します。コントロールの特定の辺のパディング値を指定するには、関連するプロパティを設定します：

• leftPadding
• rightPadding
• topPadding
• bottomPadding

padding: 0

を設定する代わりに、各特定プロパティを設定します：

leftPadding: 0
rightPadding: 0
topPadding: 0
bottomPadding: 0

Control Layout,availableWidth,availableHeight,topPadding,leftPadding,rightPadding,bottomPaddingも参照してください 。

このプロパティは、背景の右インセットを保持します。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

Control Layout およびleftInsetも参照してください 。

このプロパティは、右のパディングを保持します。明示的に設定しない限り、値はhorizontalPadding と等しくなります。

Control Layout,padding,leftPadding,horizontalPadding,availableWidthも参照して ください。

このプロパティはスペーシングを保持する。

スペーシングは、複数の、または繰り返しの構成要素を持つコントロールに有用である。例えば、CheckBox のテキストとインジケータの間の距離を決定するために、スペーシングを使用するスタイルがあります。スペーシングはControlによって強制されるものではないので、各スタイルによって解釈が異なり、完全に無視するものもあります。

このプロパティは、背景のトップインセットを保持します。

このプロパティは、QtQuick.Controls 2.5（Qt 5.12）で導入されました。

Control Layout およびbottomInsetも参照してください 。

このプロパティは、上部のパディングを保持します。明示的に設定しない限り、値はverticalPadding と等しくなります。

Control Layout,padding,bottomPadding,verticalPadding,availableHeightも参照して ください。

このプロパティは垂直方向のパディングを保持します。明示的に設定しない限り、値はpadding に等しい。

このプロパティは QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

Control Layout,padding,topPadding,bottomPadding,horizontalPaddingも参照してください 。

このプロパティは、コントロールがビジュアル・フォーカスを持つかどうかを保持する。コントロールがアクティブなフォーカスを持ち、フォーカスの理由がQt.TabFocusReason,Qt.BacktabFocusReason,Qt.ShortcutFocusReason のいずれかの場合、このプロパティはtrue になります。

一般に、キー・フォーカスを視覚化するには、このプロパティをItem::activeFocus より優先する。これにより、タッチやマウスで操作する場合ではなく、キーで操作する場合にのみキーフォーカスが可視化されます。

focusReason およびItem::activeFocusも参照のこと 。

このプロパティは、コントロールがホイールイベントを処理するかどうかを決定する。デフォルト値はfalse です。