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 レイアウトの概要も参照してください。
Note: レイアウトのアイテムのx、y、width、heightプロパティをバインドしないでください。widthプロパティとheightプロパティは、レイアウトエンジンによって使用され、最小/優先/最大添付プロパティから計算されたアイテムの現在のサイズを保存します。アイテムの優先サイズを指定するにはLayout.preferredWidth とLayout.preferredHeight 、またはimplicitWidth とimplicitHeight を使います。
GridLayout 、RowLayout 、ColumnLayoutも参照のこと 。
Attached Property 文書
Layout.alignment : Qt.Alignment |
このプロパティでは、セル内の項目の配置を指定することができます。
デフォルト値は0 で、これはQt.AlignVCenter | Qt.AlignLeft になることを意味します。これらのデフォルトは、水平または垂直フラグのみが指定された場合にも適用されます：水平フラグのみが指定された場合、デフォルトの垂直フラグはQt.AlignVCenter となり、垂直フラグのみが指定された場合、デフォルトの水平フラグはQt.AlignLeft となります。
有効なアライメントは、以下のフラグの組み合わせである：
Layout.bottomMargin : int |
Layout.column : int |
このプロパティは、GridLayout における項目の列位置を指定できます。
row とこのプロパティの両方が設定されていない場合、項目にセルを割り当てるかどうかはレイアウト次第です。
row およびcolumnSpanも参照してください 。
Layout.columnSpan : int |
このプロパティで、GridLayout の項目の列スパンを指定できます。
Layout.fillHeight : bool |
このプロパティがtrue の場合、項目は指定された制約を尊重しながら、可能な限り高くなります。こ のプ ロ パテ ィ がfalse の場合、 項目の高 さ は固定 さ れて、 望ま し い高 さ に設定 さ れます。デフォルトはfalse で、レイアウト自体のデフォルトはtrue です。
fillWidthも参照してください 。
Layout.fillWidth : bool |
このプロパティがtrue の場合、アイテムは指定された制約を尊重しながら可能な限り広くなります。こ のプ ロ パテ ィ がfalse の場合、 項目の幅は固定 さ れ、 望ま し い幅に設定 さ れます。デフォルトはfalse ですが、レイアウト自体のデフォルトはtrue です。
fillHeightも参照してください 。
Layout.margins : int |
アイテムの外側のマージンをすべて同じ値に設定します。アイテム自身はマージンを評価しません。マージンを評価するかどうかは親の責任です。
したがって、マージンを持つアイテムが他のアイテム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 |
このプロパティは、レイアウト内のアイテムの好ましい高さを保持します。望ましい高さが-1 の場合、それは無視され、レイアウトはimplicitHeight を代わりに使用します。
minimumHeight およびmaximumHeightも参照して ください。
Layout.preferredWidth : int |
このプロパティは、レイアウト内のアイテムの優先幅を保持します。優先幅が-1 である場合、それは無視され、レイアウトはimplicitWidth を代わりに使用します。
minimumWidth およびmaximumWidthも参照して ください。
Layout.rightMargin : int |
Layout.row : int |
このプロパティは、GridLayout における項目の行位置を指定します。
column とこのプロパティの両方が設定されていない場合、項目にセルを割り当てるかどうかはレイアウト次第です。
Layout.rowSpan : int |
このプロパティで、GridLayout の項目の行スパンを指定できます。
columnSpan およびrowも参照して ください。
特定の Qt ライセンスの下で利用可能です。
詳細を参照してください。
