QMLのコントロール - GridとGridLayoutのソースを表示

== 概要 ==
GridLayoutは、見やすいレイアウトを表示するために用意されている。<br>
<br><br>

== 専用プロパティ ==
* layoutDirection
*: 値 : enumeration (既定値 : <code>Qt.LeftToRight</code>)
*: このプロパティは、アイテムを左から右にレイアウト、または、右から左にレイアウトするかどうかを制御する。(<u>QtQuick.Layouts 1.1</u>で導入された)
*: <br>
*: 既定値のQt.LeftToRightは、アイテムを左から右に配置する。
*: 値にQt.RightToLeftを指定する場合、アイテムを右から左に向かって配置する。
*: また、<code>Qt.RightToLeft</code>が指定されている場合、左揃えのアイテムは右揃えになり、右揃えのアイテムは左揃えになる。<br>
*: <br>
*: <code>RowLayout</code>、<code>ColumnLayout</code>、<code>GridLayout</code>には、<code>layoutDirection</code>プロパティが存在する。<br>
*: <br>
* rowSpacing
*: 値 : real型 (既定値 : 5)
*: 各行の間隔を設定する。
*: <br>
* columnSpacing
*: 値 : real型 (既定値 : 5)
*: 各カラムの間隔を設定する。
*: <br>
* rows
*: 値 : int型 (既定値 : 制限なし)
*: <code>Layout.flow</code>プロパティが<code>GridLayout.TopToBottom</code>の場合、配置されるアイテムの行数制限を設定する。
*: <br>
* columns
*: 値 : int型 (既定値 : 制限なし)
*: <code>Layout.flow</code>プロパティが<code>GridLayout.LeftToRight</code>の場合、配置されるアイテムの列数制限を設定する。
*: <br>
* flow
*: 値 : enumeration型 (既定値 : <code>GridLayout.LeftToRight</code>)
*: セルの位置が明示的に設定されていないアイテムのフロー方向を設定する。
*: このプロパティは、<code>rows</code>プロパティや<code>columns</code>と一緒に使用され、それぞれ、次の行または列にフローがリセットされるタイミングを指定する。
*: <br>
*: 設定可能な値は、以下の通りである。
*:* <code>GridLayout.LeftToRight</code> （既定値）
*:*: アイテムが隣り合って配置されて、次の行に折り返される。
*:* <code>GridLayout.TopToBottom</code>
*:*: アイテムは上から下に向かって隣り合って配置されて、次の列に折り返される。
*: <br>
*: <code>rows</code>プロパティと<code>columns</code>プロパティも参照すること。
*: <br>
* Layout.row
*: 値 : int型 (既定値 : 0)
*: <code>GridLayout</code>内のアイテムの行の位置を設定する。
*: <code>Layout.row</code>プロパティおよび<code>Layout.column</code>プロパティの両方が設定されていない場合、アイテムにセルを割り当てるかどうかは、レイアウトに委ねられる。
*: <code>Layout.column</code>および<code>Layout.rowSpan</code>も参照すること。
*: <br>
* Layout.rowSpan
*: 値 : int型 (既定値 : 1)
*: <code>GridLayout</code>内のアイテムの行のスパンを設定する。
*: <code>Layout.row</code>および<code>Layout.columnSpan</code>も参照すること。
*: <br>
* Layout.column
*: 値 : int型 (既定値 : 0)
*: <code>GridLayout</code>内のアイテムのカラムの位置を設定する。
*: <code>Layout.column</code>プロパティおよび<code>Layout.row</code>プロパティの両方が設定されていない場合、アイテムにセルを割り当てるかどうかは、レイアウトに委ねられる。
*: <code>Layout.row</code>および<code>Layout.columnSpan</code>も参照すること。
*: <br>
* Layout.columnSpan
*: 値 : int型 (既定値 : 1)
*: <code>GridLayout</code>内のアイテムのカラムのスパンを設定する。
*: <code>Layout.column</code>および<code>Layout.rowSpan</code>も参照すること。
<br><br>

== プロパティ ==
<code>GridLayout</code>は、以下のプロパティもサポートしている。<br>
* Layout.minimumWidth
*: 値 : real型 (既定値 : アイテムの暗黙の最小幅)
*: レイアウト内のアイテムの最小幅を設定する。
*: アイテムがレイアウトである場合、暗黙の最小幅は、どの項目もその最小幅よりも縮小することなくレイアウトが持つことができる最小幅になる。
*: (その他のアイテムにおける暗黙の最小幅は0である)
*: この値を<code>-1</code>に設定する場合、暗黙的な最小幅にリセットされる。
*: <code>preferredWidth</code>プロパティおよび<code>maximumWidth</code>プロパティも参照すること。
*: <br>
* Layout.minimumHeight
*: 値 : real型 (既定値 : アイテムの暗黙の最小の高さ)
*: レイアウト内のアイテムの最小の高さを設定する。
*: アイテムがレイアウトである場合、暗黙の最小の高さは、どのアイテムもその最小高さよりも縮小することなく、レイアウトが持つことのできる最小の高さになる。
*: (その他のアイテムの暗黙の最小の高さは0である)
*: この値を<code>-1</code>に設定する場合、高さが暗黙の最小値にリセットされる。
*: <code>preferredHeight</code>プロパティと<code>maximumHeight</code>プロパティも参照すること。
*: <br>
* Layout.preferredWidth
*: 値 : real型 (既定値 : -1)
*: レイアウト内のアイテムの優先幅を設定する。
*: 値が<code>-1</code>の場合、preferredWidthプロパティは無視されて、implicitWidthプロパティを使用する。
*: <code>minimumWidth</code>プロパティと<code>maximumWidth</code>プロパティも参照すること。
*: <br>
* Layout.preferredHeight
*: 値 : real型 (既定値 : -1)
*: レイアウト内のアイテムの優先する高さを設定する。
*: 値が-1の場合、preferredWidthプロパティは無視されて、implicitHeightプロパティを使用する。
*: <code>minimumHeight</code>プロパティと<code>maximumHeight</code>プロパティも参照すること。
*: <br>
* Layout.maximumWidth
*: 値 : real型 (既定値 : アイテムの暗黙の最大幅)
*: レイアウト内のアイテムの最大幅を設定する。
*: アイテムがレイアウトの場合、暗黙の最大幅は、レイアウトが最大幅を超えることなくレイアウトが持つことができる最大幅になる。
*: この値を<code>-1</code>に設定すると、幅が暗黙の最大幅にリセットされる。
*: <br>
*: レイアウト以外の場合、暗黙の最大幅は、<code>Number.POSITIVE_INFINITY</code>である。
*: <code>minimumWidth</code>プロパティおよび<code>preferredWidth</code>プロパティも参照すること。
*: <br>
* Layout.maximumHeight
*: 値 : real型 (既定値 : アイテムの暗黙の最大の高さ)
*: レイアウト内のアイテムの最大幅を設定する。
*: アイテムがレイアウトの場合、暗黙の最大の高さは、どのアイテムも最大の高さを超えずにレイアウトが持てる最大の高さになる。
*: この値を<code>-1</code>に設定する場合、高さは暗黙の最大の高さにリセットされる。
*: <br>
*: レイアウト以外の場合、暗黙の最大の高さは、<code>Number.POSITIVE_INFINITY</code>である。
*: <code>minimumHeight</code>プロパティと<code>preferredHeight</code>プロパティも参照すること。
*: <br>
* Layout.fillWidth
*: 値 : bool型 (レイアウトの既定値 : true, レイアウト内のアイテムの既定値 : false)
*: このプロパティが<code>true</code>の場合、レイアウト内のアイテムは、与えられた制約を尊重しながら可能な限り広くなる。
*: このプロパティが<code>false</code>の場合、レイアウト内のアイテムは、望ましい幅に設定された固定幅を持つ。
*: <br>
*: レイアウト内のアイテムの既定値は<code>false</code>であるが、レイアウト自体の既定値は<code>true</code>である。
*: <code>fillHeight</code>プロパティも参照すること。
*: <br>
* Layout.fillHeight
*: 値 : bool型 (レイアウトの既定値 : true, レイアウト内のアイテムの既定値 : false)
*: このプロパティが<code>true</code>の場合、レイアウト内のアイテムは、与えられた制約を尊重しながら可能な限り高さが高くなる。
*: このプロパティが<code>false</code>の場合、レイアウト内のアイテムは、望ましい高さに設定された固定の高さを持つ。
*: <br>
*: レイアウト内のアイテムの既定値は<code>false</code>であるが、レイアウト自体の既定値は<code>true</code>である。
*: <code>fillWidth</code>プロパティも参照すること。
*: <br>
* Layout.alignment
*: 値 : Qt.Alignment型 (既定値 : 0 … 0とは、<code>Qt.AlignVCenter | Qt.AlignLeft</code>のこと)
*: アイテムが占めるセル内の配置を指定する。
*: 既定値は、水平フラグまたは垂直フラグのみが指定された場合にも適用される。
*: 水平フラグのみが指定された場合でも、自動的に垂直フラグが<code>Qt.AlignVCenter</code>に設定される。
*: 垂直フラグのみが指定された場合でも、自動的に水平フラグが<code>Qt.AlignLeft</code>に設定される。
*: <br>
*: 以下に、使用できるフラグを示す。
*:* Qt.AlignLeft
*:* Qt.AlignHCenter
*:* Qt.AlignRight
*:* Qt.AlignTop
*:* Qt.AlignVCenter
*:* Qt.AlignBottom
*:* Qt.AlignBaseline
*: <br>
* Layout.margins
*: 値 : real型 (既定値 : 0)
*: アイテムの外側の余白をすべて同じ値に設定する。
*: アイテム自体は自身のマージンを評価しない。マージンを評価するかどうかは、親アイテムが決定する。
*: <br>
*: 具体的には、マージンが評価されるのは、<code>ColumnLayout</code>、<code>RowLayout</code>、<code>GridLayout</code>、<code>SplitView</code>等のレイアウトであり、マージンが大きくなるとアイテムの有効セルサイズが大きくなる。
*: したがって、マージンを持つアイテムが他のアイテムの子である場合、その位置、サイズ、暗黙のサイズは変更されない。
*: <br>
*: <code>margins</code>と<code>alignment</code>を組み合わせる場合、<code>margins</code>プロパティの値を含めてアイテムの位置を合わせる。
*: 例えば、上のマージンが1、下のマージンが9の垂直方向に中央に配置されたアイテムの場合、セル内でのアイテムの配置は、中央から4ピクセル上となる。
*: <br>
*: このプロパティは、QtQuick.Layouts 1.2で導入された。
*: <code>leftMargin</code>プロパティ、<code>topMargin</code>プロパティ、<code>rightMargin</code>プロパティ、<code>bottomMargin</code>プロパティも参照すること。
*: <br>
* Layout.topMargin
*: 値 : real型 (既定値 : <code>Layout.margins</code>の値)
*: アイテムの外側にある上の余白を設定する。
*: 値が設定されていない場合は、<code>Layout.margins</code>の値を使用する。
*: <br>
*: このプロパティは、QtQuick.Layouts 1.2で導入された。
*: <code>margins</code>プロパティも参照すること。
*: <br>
* Layout.bottomMargin
*: 値 : real型 (既定値 : <code>Layout.margins</code>の値)
*: アイテムの外側にある下の余白を設定する。
*: 値が設定されていない場合は、<code>Layout.margins</code>の値を使用する。
*: <br>
*: このプロパティは、QtQuick.Layouts 1.2で導入された。
*: <code>margins</code>プロパティも参照すること。
*: <br>
* Layout.leftMargin
*: 値 : real型 (既定値 : <code>Layout.margins</code>の値)
*: アイテムの外側にある左の余白を設定する。
*: 値が設定されていない場合は、<code>Layout.margins</code>の値を使用する。
*: <br>
*: このプロパティは、QtQuick.Layouts 1.2で導入された。
*: <code>margins</code>プロパティも参照すること。
*: <br>
* Layout.rightMargin
*: 値 : real型 (既定値 : <code>Layout.margins</code>の値)
*: アイテムの外側にある右の余白を設定する。
*: 値が設定されていない場合は、<code>Layout.margins</code>の値を使用する。
*: <br>
*: このプロパティは、QtQuick.Layouts 1.2で導入された。
*: <code>margins</code>プロパティも参照すること。
*: <br>
<br><br>

== サンプルコード ==
<code>GridLayout</code>内の全ての可視アイテムは、レイアウトに属する。<br>
<br>
<code>GridLayout</code>のサイズが変更された場合、レイアウト内の全てのアイテムが再配置される。<br>
これは、ウィジェットベースの<code>QGridLayout</code>に似ている。<br>
<br>
1つの行または1つの列のみを持つレイアウトが必要な場合は、<code>RowLayout</code>または<code>ColumnLayout</code>を使用する。<br>
これらは、より便利なAPIを提供しているため、可読性が向上するからである。<br>
<br>
デフォルトの設定では、アイテムは<code>flow</code>プロパティにしたがって配置される。<br>
(<code>flow</code>プロパティの既定値は、<code>GridLayout.LeftToRight</code>)<br>
<br>
もし、<code>columns</code>プロパティを設定している場合、自動配置が次の行の先頭に折り返される前に、レイアウトが持つことのできる列数の最大値として扱われる。<br>
<code>columns</code>プロパティは、<code>flow</code>プロパティが<code>GridLayout.LeftToRight</code>の場合にのみ使用される。<br>
<br>
以下の例は、GridLayoutのサンプルコードである。<br>
 <syntaxhighlight lang="qml">
 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
    }
 }
 </syntaxhighlight>
<br>
<code>rows</code>プロパティも同様に動作するが、アイテムは垂直方向に自動配置される。<br>
また、<code>rows</code>プロパティは、<code>flow</code>が<code>GridLayout.TopToBottom</code>の場合にのみ使用される。<br>
<br>
<code>Layout.row</code>プロパティと<code>Layout.column</code>プロパティを設定することにより、アイテムが占めるセルを設定できる。<br>
また、<code>Layout.rowSpan</code>または<code>Layout.columnSpan</code>プロパティを設定することにより、行のスパンや列のスパンを設定できる。<br>
<br>
<code>GridLayout</code>内のアイテムは、これらの付属プロパティをサポートしている。<br>
<br><br>

__FORCETOC__
[[カテゴリ:Qt]]