Layout QML Type

GridLayout,RowLayout またはColumnLayout にプッシュされたアイテムの添付プロパティを提供します。

• 継承メンバを含む全メンバ一覧

添付プロパティ

• alignment : Qt.Alignment
• bottomMargin : real (since QtQuick.Layouts 1.2)
• column : int
• columnSpan : int
• fillHeight : bool
• fillWidth : bool
• horizontalStretchFactor : int (since Qt 6.5)
• leftMargin : real (since QtQuick.Layouts 1.2)
• margins : real (since QtQuick.Layouts 1.2)
• maximumHeight : real
• maximumWidth : real
• minimumHeight : real
• minimumWidth : real
• preferredHeight : real
• preferredWidth : real
• rightMargin : real (since QtQuick.Layouts 1.2)
• row : int
• rowSpan : int
• topMargin : real (since QtQuick.Layouts 1.2)
• useDefaultSizePolicy : enumeration (since 6.8)
• verticalStretchFactor : int (since Qt 6.5)

詳細説明

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 概要も参照してください。

GridLayout 、RowLayout 、ColumnLayoutも参照のこと 。

付属プロパティのドキュメント

Layout.alignment : Qt.Alignment

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

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

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

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

Layout.bottomMargin : real [since QtQuick.Layouts 1.2]

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

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

marginsも参照してください 。

Layout.column : int

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

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

デフォルト値は0 です。

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

Layout.columnSpan : int

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

デフォルト値は1 です。

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

Layout.fillHeight : bool

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

fillWidthも参照してください 。

Layout.fillWidth : bool

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

fillHeightも参照してください 。

Layout.horizontalStretchFactor : int [since Qt 6.5]

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

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

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

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

verticalStretchFactorも参照してください 。

Layout.leftMargin : real [since QtQuick.Layouts 1.2]

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

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

marginsも参照してください 。

Layout.margins : real [since QtQuick.Layouts 1.2]

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

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

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

マージンとアライメントを組み合わせると、マージンも含めてアイテムの位置が揃う。た と えば、 縦中央に配置 さ れた ア イ テ ムで、 上余白が1 で、 下余白が9 の場合、 セル内のア イ テ ムは中央か ら 4 ピ ク セル上に配置 さ れます。

デフォルト値は0 です。

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

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

Layout.maximumHeight : real

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

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

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

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

Layout.maximumWidth : real

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

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

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

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

Layout.minimumHeight : real

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

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

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

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

Layout.minimumWidth : real

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

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

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

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

Layout.preferredHeight : real

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

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

Layout.preferredWidth : real

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

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

Layout.rightMargin : real [since QtQuick.Layouts 1.2]

アイテムの外側の右マージンを指定します。値が設定されていない場合は、margins の値が使用されます。

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

marginsも参照してください 。

Layout.row : int

このプロパティにより、GridLayout における項目の行位置を指定することができる。

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

デフォルト値は0 です。

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

Layout.rowSpan : int

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

デフォルト値は1 です。

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

Layout.topMargin : real [since QtQuick.Layouts 1.2]

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

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

marginsも参照してください 。

Layout.useDefaultSizePolicy : enumeration [since 6.8]

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

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

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

Layout.verticalStretchFactor : int [since Qt 6.5]

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

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

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

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

horizontalStretchFactorも参照してください 。