GridLayout QML Type

グリッド内のアイテムを動的に配置する方法を提供します。詳細...

• 継承したメンバを含む、すべてのメンバの一覧

プロパティ

• columnSpacing : real
• columns : int
• flow : enumeration
• layoutDirection : enumeration (since QtQuick.Layouts 1.1)
• rowSpacing : real
• rows : int
• uniformCellHeights : bool (since QtQuick.Layouts 6.6)
• uniformCellWidths : bool (since QtQuick.Layouts 6.6)

詳細説明

この型をより効率的に使用するためには、Qt Quick Layouts モジュールの一般的なメカニズムを理解しておくことが推奨される。詳しくはQt Quick Layouts Overviewを参照してください。

GridLayoutのサイズが変更されると、レイアウト内のすべてのアイテムが再配置されます。これは、ウィジェットベースのQGridLayout に似ています。GridLayout要素の可視の子要素はすべてレイアウトに属します。1行または1列だけのレイアウトが必要な場合は、RowLayout またはColumnLayout を使用できます。これらはもう少し便利なAPIを提供し、可読性を向上させます。

デフォルトでは、アイテムはflow プロパティに従って配置されます。flow プロパティのデフォルト値はGridLayout.LeftToRight です。

columns プロパティが指定された場合、自動配置が次の行の先頭に折り返される前に、レイアウトが持つことができる列数の上限として扱われます。columns プロパティは、flow がGridLayout.LeftToRight の場合にのみ使用されます。

GridLayout {
    id: grid
    columns: 3

    Text { text: "Three"; font.bold: true; }
    Text { text: "words"; color: "red" }
    Text { text: "in"; font.underline: true }
    Text { text: "a"; font.pixelSize: 20 }
    Text { text: "row"; font.strikeout: true }
}

rows プロパティも同様に機能しますが、項目は縦方向に自動配置されます。rows プロパテ ィ は、flow がGridLayout.TopToBottom の と き にのみ用い ら れます。

Layout.row プロパティとLayout.column プロパティを設定することで、項目をどのセルに配置するかを指定できます。また、Layout.rowSpan プロパティやLayout.columnSpan プロパティを設定することで、行スパンや列スパンを指定することもできます。

GridLayoutのアイテムは、これらの付属プロパティをサポートしています：

• Layout.row
• Layout.column
• Layout.rowSpan
• Layout.columnSpan
• Layout.minimumWidth
• Layout.minimumHeight
• Layout.preferredWidth
• Layout.preferredHeight
• Layout.maximumWidth
• Layout.maximumHeight
• Layout.fillWidth
• Layout.fillHeight
• Layout.alignment
• Layout.margins
• Layout.leftMargin
• Layout.rightMargin
• Layout.topMargin
• Layout.bottomMargin
• Layout.horizontalStretchFactor
• Layout.verticalStretchFactor

attachedプロパティの詳細については、こちらを参照してください。

RowLayout,ColumnLayout,StackLayout,Grid,Qt Quick レイアウトの概要も参照してください 。

プロパティの説明