C
Layout QML Type
GridLayout 、RowLayout 、またはColumnLayout にプッシュされた項目に対して、添付プロパティを提供します。詳細...
| Import Statement: | import QtQuick.Layouts |
| Since: | Qt Quick Ultralite 2.8 |
アタッチドプロパティ
- alignment : Qt.Alignment
- bottomMargin : int
- column : int
- columnSpan : int
- fillHeight : bool
- fillWidth : bool
- leftMargin : int
- margins : int
- maximumHeight : int
- maximumWidth : int
- minimumHeight : int
- minimumWidth : int
- preferredHeight : int
- preferredWidth : int
- rightMargin : int
- row : int
- rowSpan : int
- topMargin : int
詳細な説明
Layout 型のオブジェクトがレイアウトの子要素に添付され、そのアイテムに関するレイアウト固有の情報を提供します。添付されたオブジェクトのプロパティは、レイアウトがアイテムをどのように配置するかに影響を与えます。
たとえば、デフォルト値が適切でない場合は、`minimumWidth`、`preferredWidth`、および`maximumWidth `を指定できます。
レイアウトのサイズが変更されると、アイテムのサイズも拡大または縮小する場合があります。このため、アイテムにはminimum size 、preferred size 、およびmaximum size が設定されています。
アイテムに対して最小サイズが明示的に指定されていない場合、そのサイズは `0` に設定されます。また、アイテムに対して最大サイズが明示的に指定されていない場合、そのサイズは `Number.POSITIVE_INFINITY` に設定されます。
レイアウトの場合、暗黙的な最小サイズと最大サイズは、レイアウトの内容によって異なります。
fillWidth およびfillHeight プロパティは、true またはfalse のいずれかになります。これらがfalse の場合、アイテムのサイズは推奨サイズに固定されます。それ以外の場合は、レイアウトのサイズ変更に伴い、最小サイズと最大サイズの範囲内でアイテムのサイズが拡大または縮小します。fillWidth （またはfillHeight ）がtrue に設定されているアイテムが複数ある場合、レイアウトは、それらの推奨サイズの比率に応じてアイテムのサイズを拡大または縮小します。
レイアウトアルゴリズムの詳細については、「Qt Quick Layouts の概要」も参照してください。
注： レイアウト内の項目の x、y、width、または height プロパティにバインドしないでください 。これは Layout の目的と矛盾するほか、バインディングループを引き起こす可能性があります。 width および height プロパティは、レイアウトエンジンが、minimum/preferred/maximum 添付プロパティから計算された項目の現在のサイズを格納するために使用され、項目のレイアウトが行われるたびに上書きされる可能性があります。項目の推奨サイズを指定するには、Layout.preferredWidth およびLayout.preferredHeight 、あるいはimplicitWidth およびimplicitHeight を使用してください。
GridLayout 、RowLayout 、およびColumnLayoutも参照してください 。
添付プロパティのドキュメント
Layout.alignment : Qt.Alignment
このプロパティを使用すると、アイテムが占めるセル内での配置を指定できます。
デフォルト値は0 であり、これはQt.AlignVCenter | Qt.AlignLeft を意味します。これらのデフォルト値は、水平または垂直のフラグのみが指定された場合にも適用されます。水平フラグのみが指定された場合、デフォルトの垂直フラグはQt.AlignVCenter となり、垂直フラグのみが指定された場合、デフォルトの水平フラグはQt.AlignLeft となります。
有効な配置は、以下のフラグの組み合わせとなります：
Layout.bottomMargin : int
アイテムの外側下部の余白を指定します。値が設定されていない場合は、margins の値が使用されます。
「margins」も参照してください 。
Layout.column : int [default]
このプロパティを使用すると、GridLayout 内の項目の列位置を指定できます。
row とこのプロパティの両方が設定されていない場合、そのアイテムにどのセルを割り当てるかはレイアウトに委ねられます。
「 row 」および「columnSpan 」も参照してください 。
Layout.columnSpan : int [default]
このプロパティを使用すると、GridLayout 内の項目のカラムスパンを指定できます。
「 rowSpan 」および「column 」も参照してください 。
Layout.fillHeight : bool
このプロパティが `true` の場合、指定された制約を満たす範囲で、アイテムの高さは可能な限り高くなります。プロパティが `false` の場合、アイテムの高さは `preferred` の値に固定されます。デフォルトは `false` ですが、レイアウト自体については例外で、デフォルトは `true` となります。
fillWidthも参照してください 。
Layout.fillWidth : bool
このプロパティが `true` の場合、指定された制約の範囲内で、アイテムの幅は可能な限り広くなります。プロパティが `false` の場合、アイテムの幅は `preferred` に設定された固定幅になります。デフォルトは `false` ですが、レイアウト自体については例外で、デフォルトは `true` となります。
fillHeightも参照してください 。
Layout.leftMargin : int
項目の外側にある左マージンを指定します。値が設定されていない場合は、margins の値が使用されます。
「margins」も参照してください 。
Layout.margins : int [default]
アイテムの外側の余白をすべて同じ値に設定します。アイテム自体は、自身の余白を計算しません。余白を計算するかどうかは、親要素が決定する役割です。
したがって、マージンを持つアイテムが別のItem の子要素である場合、その位置、サイズ、および暗黙のサイズは変更されません。
マージンと配置を組み合わせると、マージンを含めてアイテムが配置されます。たとえば、上マージンが `1 `、下マージンが `9 ` の垂直中央揃えのアイテムの場合、セル内でのそのアイテムの実際の配置は、中心から 4 ピクセル上になります。
leftMargin 、topMargin 、rightMargin 、およびbottomMarginも参照してください 。
Layout.maximumHeight : int
デフォルト値は、そのアイテムの暗黙的な最大高さです。
アイテムがレイアウトである場合、暗黙の最大高さは、そのレイアウトに含まれるどのアイテムも最大高さを超えて拡大することなく、レイアウトが持つことのできる最大高さとなります。その他のアイテムの暗黙の最大高さは、Number.POSITIVE_INFINITY です。
この値を `-1 ` に設定すると、高さは暗黙的な最大高さにリセットされます。
「 minimumHeight 」および「preferredHeight 」も参照してください 。
Layout.maximumWidth : int
このプロパティは、レイアウト内の項目の最大幅を指定します。デフォルト値は、その項目の暗黙的な最大幅です。
アイテムがレイアウトである場合、暗黙の最大幅は、そのレイアウト内のどのアイテムも最大幅を超えて拡大することなく、レイアウトが持つことができる最大幅となります。その他のアイテムの暗黙の最大幅は、Number.POSITIVE_INFINITY です。
この値を `-1 ` に設定すると、幅は暗黙の最大幅にリセットされます。
「 minimumWidth 」および「preferredWidth 」も参照してください 。
Layout.minimumHeight : int
このプロパティは、レイアウト内の項目の最小高さを指定します。デフォルト値は、その項目の暗黙的な最小高さです。
アイテムがレイアウトである場合、暗黙の最小高さは、そのレイアウト内のどのアイテムも最小高さ以下に縮小することなく、レイアウトが持つことができる最小高さとなります。その他のアイテムの暗黙の最小高さは、0 です。
この値を -1 に設定すると、高さが暗黙の最小高さにリセットされます。
「 preferredHeight 」および「maximumHeight 」も参照してください 。
Layout.minimumWidth : int
このプロパティは、レイアウト内の項目の最小幅を指定します。デフォルト値は、その項目の暗黙的な最小幅です。
アイテムがレイアウトである場合、暗黙的な最小幅は、そのレイアウトに含まれるどのアイテムも最小幅を下回ることなく、レイアウトが持つことのできる最小幅となります。その他のアイテムの暗黙的な最小幅は、0 です。
この値を -1 に設定すると、幅は暗黙の最小幅にリセットされます。
「 preferredWidth 」および「maximumWidth 」も参照してください 。
Layout.preferredHeight : int [default]
このプロパティは、レイアウト内の項目の推奨高さを保持します。推奨高さが `-1 ` の場合、それは無視され、レイアウトでは代わりに `implicitHeight ` が使用されます。
「 minimumHeight 」および「maximumHeight 」も参照してください 。
Layout.preferredWidth : int [default]
このプロパティは、レイアウト内の項目の推奨幅を保持します。推奨幅が `-1 ` の場合は無視され、レイアウトでは代わりに `implicitWidth ` が使用されます。
「 minimumWidth 」および「maximumWidth 」も参照してください 。
Layout.rightMargin : int
項目の外側の右余白を指定します。値が設定されていない場合は、margins の値が使用されます。
「margins」も参照してください 。
Layout.row : int [default]
このプロパティを使用すると、GridLayout 内の項目の行位置を指定できます。
column とこのプロパティの両方が設定されていない場合、そのアイテムにセルを割り当てるかどうかはレイアウトに委ねられます。
「 column 」および「rowSpan 」も参照してください 。
Layout.rowSpan : int [default]
このプロパティを使用すると、GridLayout 内の項目の行スパンを指定できます。
「 columnSpan 」および「row 」も参照してください 。
Layout.topMargin : int
アイテムの外側の上マージンを指定します。値が設定されていない場合は、margins の値が使用されます。
「margins」も参照してください 。
特定のQtライセンスの下で利用可能です。
詳細はこちらをご覧ください。
