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 概要も参照してください。
Note: レイアウトのアイテムのx、y、width、heightプロパティにバインドしないでください。widthプロパティとheightプロパティは、レイアウト・エンジンによって、最小／優先／最大添付プロパティから計算されたアイテムの現在のサイズを保存するために使用され、アイテムがレイアウトされるたびに書き換えることができます。アイテムの優先サイズを指定するには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 内の項目の列 ス パ ン を指定す る こ と がで き ます。
Layout.fillHeight : bool [attached]
このプロパティがtrue の場合、アイテムは指定された制約を尊重しながら、可能な限りの高さになる。このプロパティがfalse の場合、アイテムの高さは好みの高さに固定されます。デフォルトはfalse ですが、レイアウト自体のデフォルトはtrue です。
fillWidthも参照してください 。
Layout.fillWidth : bool [attached]
このプロパティがtrue の場合、アイテムは指定された制約を尊重しながら可能な限り幅が広くなる。このプロパティがfalse の場合、アイテムの幅は固定され、希望する幅に設定されます。デフォルトは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 とこのプロパティの両方が設定されていない場合、アイテムにセルを割り当てるかどうかはレイアウト次第です。
Layout.rowSpan : int [default attached]
こ のプ ロ パテ ィ を利用す る と 、GridLayout 内の項目の行送 り を指定す る こ と がで き ます。
columnSpan およびrowも参照のこと 。
Layout.topMargin : int [attached]
アイテムの外側の上マージンを指定します。値が設定されていない場合は、margins の値が使われます。
marginsも参照してください 。
特定の Qt ライセンスの下で利用可能です。
詳細はこちら。
