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