Layout QML Type

このプロパティでは、セル内の項目の配置を指定することができます。

デフォルト値は0 で、これはQt.AlignVCenter | Qt.AlignLeft になることを意味します。これらのデフォルトは、水平または垂直フラグのみが指定された場合にも適用されます：水平フラグのみが指定された場合、デフォルトの垂直フラグはQt.AlignVCenter になり、垂直フラグのみが指定された場合、デフォルトの水平フラグはQt.AlignLeft になります。

有効なアライメントは、以下のフラグの組み合わせである：

• Qt::AlignLeft
• Qt::AlignHCenter
• Qt::AlignRight
• Qt::AlignTop
• Qt::AlignVCenter
• Qt::AlignBottom
• Qt::AlignBaseline

項目の外側の下端マージンを指定します。値が設定されていない場合は、margins の値が使用されます。

このプロパティは QtQuick.Layouts 1.2 で導入されました。

marginsも参照してください 。

このプロパティを使用すると、GridLayout における項目の列位置を指定できます。

row とこのプロパティの両方が設定されていない場合、項目にセルを割り当てるかどうかはレイアウト次第です。

デフォルト値は0 です。

row およびcolumnSpanも参照してください 。

このプロパティを使うと、GridLayout の項目の列スパンを指定できます。

デフ ォル ト 値は1 です。

rowSpan およびcolumnも参照して ください。

このプロパティがtrue の場合、項目は、指定された制約を尊重しながら、可能な限りの高さになります。こ のプ ロパテ ィ がfalse の場合、 項目の高 さ は固定 さ れて、 望ま し い高 さ に設定 さ れます。デフォルトは、アイテムの暗黙的な（組み込みの）サイズポリシーに依存する。

fillWidthも参照のこと 。

このプロパティがtrue の場合、アイテムは与えられた制約を尊重しつつ、可能な限り広くなる。このプロパティがfalse の場合、アイテムの幅は固定され、望ましい幅に設定される。デフォルトは、アイテムの暗黙の（組み込みの）サイズポリシーに依存する。

fillHeightも参照 。

このプロパティでは、水平方向の伸縮率を指定することができます。デフォルトでは、線形レイアウトに配置された2つの同じアイテムは同じサイズを持ちますが、最初のアイテムのストレッチファクターが1で、2番目のアイテムのストレッチファクターが2である場合、最初のアイテムは利用可能なスペースの1/3を、2番目のアイテムは利用可能なスペースの2/3を取得することを目指します。ただし、1/3と2/3のスペースが正確に確保されるかどうかは、ヒントのサイズに依存する。これは、例えば横長のレイアウトが最小幅で表示される場合、すべての子アイテムも結果として最小幅になるからです。

同様に、横長レイアウトが優先幅を持つ場合、すべての子アイテムは優先幅を持ち、横長レイアウトが最大幅を持つ場合、すべての子アイテムは最大幅を持ちます。この戦略は、個々のストレッチ・ファクターが何であるかに関係なく適用されます。この結果、ストレッチ・ファクターはpreferredWidth からmaximumWidth の範囲の子アイテムの成長率のみを決定します。

デフォルト値は-1 で、ストレッチファクターは適用されません。

このプロパティは Qt 6.5 で導入されました。

verticalStretchFactorも参照してください 。

項目の外側の左マージンを指定します。値が設定されていない場合は、margins の値が使用されます。

このプロパティは QtQuick.Layouts 1.2 で導入されました。

marginsも参照してください 。

アイテムの外側のマージンをすべて同じ値に設定します。アイテム自体はそれ自身のマージンを評価しません。マージンを評価するかどうかは親の責任です。

具体的には、余白が評価されるのはColumnLayout 、RowLayout 、GridLayout 、およびSplitView のようなレイアウトに似たコンテナのみで、余白が大きくなるとアイテムの有効セルサイズが大きくなります。

したがって、余白を持つ項目が他のItem の子である場合、その位置、サイズ、暗黙のサイズは変更されません。

余白と整列を組み合わせると、その余白を含めてアイテムが整列されます。た と えば、 縦中央に配置 さ れた ア イ テ ムで、 上余白が1 で、 下余白が9 の場合、 セル内のア イ テ ムは中央か ら 4 ピ ク セル上に配置 さ れます。

デフォルト値は0 です。

このプロパティは QtQuick.Layouts 1.2 で導入されました。

leftMargin,topMargin,rightMargin,bottomMarginも参照してください 。

デフォルト値は、アイテムの暗黙の最大高さです。

アイテムがレイアウトの場合、暗黙の最大高さは、そのレイアウトのアイテムがその最大高さを超えない最大高さになります。その他のアイテムの暗黙の最大高さはNumber.POSITIVE_INFINITY です。

この値を-1 に設定すると、高さは暗黙の最大高さにリセットされます。

minimumHeight およびpreferredHeightも参照してください 。

このプロパティは、レイアウト内のアイテムの最大幅を保持する。デフォルト値はアイテムの暗黙の最大幅である。

アイテムがレイアウトの場合、暗黙の最大幅は、そのアイテムのどれもが最大幅を超えて大きくなることなく、レイアウトが持つことができる最大幅になります。その他のアイテムの暗黙の最大幅はNumber.POSITIVE_INFINITY です。

この値を-1 に設定すると、幅は暗黙の最大幅にリセットされます。

minimumWidth およびpreferredWidthも参照してください 。

このプロパティは、レイアウト内のアイテムの最小高さを保持する。デフォルト値はアイテムの暗黙の最小高さである。

アイテムがレイアウトの場合、暗黙の最小高さは、そのレイアウトのアイテムのいずれかがその最小高さより小さくなることなく持つことができる最小の高さになります。その他のアイテムの暗黙の最小高さは0 です。

こ の値を -1 に設定す る と 、 高 さ は暗黙の最小高 さ に リ セ ッ ト さ れます。

preferredHeight およびmaximumHeightも参照してください 。

このプロパティは、レイアウト内のアイテムの最小幅を保持する。デフォルト値はアイテムの暗黙の最小幅である。

アイテムがレイアウトである場合、暗黙の最小幅は、そのアイテムのいずれかがその最小幅より小さくなることなく、レイアウトが持つことができる最小幅になります。その他のアイテムの暗黙の最小幅は0 です。

この値を -1 に設定すると、幅は暗黙の最小幅にリセットされます。

preferredWidth およびmaximumWidthも参照してください 。

このプロパティは、レイアウト内のアイテムの優先高さを保持します。好ましい高さが-1 の場合、それは無視され、レイアウトはimplicitHeight を代わりに使用します。デフォルトは-1 です。

minimumHeight およびmaximumHeightも参照してください 。

このプロパティは、レイアウト内のアイテムの優先幅を保持します。優先幅が-1 の場合、それは無視され、レイアウトはimplicitWidth を代わりに使用します。デフォルトは-1 です。

minimumWidth およびmaximumWidthも参照してください 。

項目の外側の右余白を指定 し ます。値が設定されていない場合は、margins の値が使用されます。

このプロパティは QtQuick.Layouts 1.2 で導入されました。

marginsも参照してください 。

このプロパティを使用すると、GridLayout におけるアイテムの行位置を指定できます。

column とこのプロパティの両方が設定されていない場合、項目にセルを割り当てるかどうかはレイアウト次第です。

デフォルト値は0 です。

column およびrowSpanも参照してください 。

このプロパティでは、GridLayout の項目の行スパンを指定できます。

デフ ォル ト 値は1 です。

columnSpan およびrowも参照して ください。

項目の外側の上マージンを指定します。値が設定されていない場合は、margins の値が使用されます。

このプロパティは QtQuick.Layouts 1.2 で導入されました。

marginsも参照してください 。

このプロパティを使用すると、ユーザーはコンポーネント・レベルでレイアウト・サイズ・ポリシーを設定できます。

デフォルト値は、アプリケーション属性Qt::AA_QtQuickUseDefaultSizePolicy をクエリすることで継承されます。このプロパティを使用すると、その値をオーバーライドできます。

このプロパティは Qt 6.8 で導入されました。

このプロパティでは、垂直方向のストレッチ係数を指定することができます。デフォルトでは、線形レイアウトに配置された 2 つの同じアイテムは同じサイズになりますが、最初のアイテムのストレッチファクターが 1 で、2 番目のアイテムのストレッチファクターが 2 の場合、最初のアイテムは利用可能なスペースの 1/3 を、2 番目のアイテムは利用可能なスペースの 2/3 を確保することを目指します。ただし、1/3と2/3のスペースが正確に確保されるかどうかは、ヒントのサイズに依存する。これは、例えば縦長のレイアウトが最小の高さで表示された場合、すべての子アイテムも結果として最小の高さになるからです。

同様に、垂直レイアウトが優先高さを持つ場合、すべての子アイテムは優先高さを持ち、垂直レイアウトが最大高さを持つ場合、すべての子アイテムは最大高さを持ちます。この戦略は、個々のストレッチ・ファクターが何であるかに関係なく適用されます。この結果、ストレッチ・ファクターは、preferredHeight からmaximumHeight の範囲の子アイテムの成長率のみを決定します。

デフォルト値は-1 で、ストレッチファクターは適用されません。

このプロパティは Qt 6.5 で導入されました。

horizontalStretchFactorも参照してください 。