Row QML Type

子要素を一列に配置します。詳細...

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

プロパティ

• add : Transition
• bottomPadding : real
• effectiveLayoutDirection : enumeration
• layoutDirection : enumeration
• leftPadding : real
• move : Transition
• padding : real
• populate : Transition
• rightPadding : real
• spacing : real
• topPadding : real

信号

• positioningComplete()

方法

• void forceLayout()

詳細な説明

Rowは、子要素を1つの行に沿って配置するタイプです。アンカーを使用せずに一連の要素を水平方向に配置するための便利な方法として利用できます。

以下は、さまざまなサイズの3つの矩形を含むRowの例です：

import QtQuick

Row {
    spacing: 2
    Rectangle { color: "red"; width: 50; height: 50 }
    Rectangle { color: "green"; width: 20; height: 50 }
    Rectangle { color: "blue"; width: 50; height: 20 }
}

Rowは、これらのアイテムを自動的に次のように水平に配置します：

Row内のアイテムがvisible でない場合、または幅や高さが0の場合は、そのアイテムはレイアウトされず、Row内には表示されません。また、Rowは子要素を自動的に水平方向に配置するため、Row内の子要素はx 位置を設定したり、left 、right 、anchors.horizontalCenter 、fill 、centerIn といったアンカーを使用して水平方向に固定したりすべきではありません。 これらの操作を行う必要がある場合は、Rowを使用せずにアイテムを配置することを検討してください。

なお、Row 内のアイテムでは、Positioner というアタッチドプロパティを使用して、Row 内でのその位置に関する詳細情報にアクセスできます。

Row およびその他の関連するポジショナータイプの使用に関する詳細については、「アイテムポジショナー」を参照してください。

関連項目: Column 、Grid 、Flow 、Positioner 、RowLayout 、およびQt Quick 例 - ポジショナー。

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

add : Transition

このプロパティは、このポジショナーに追加されるアイテムに対して実行されるトランジションを保持します。ポジショナーの場合、これは以下の項目に適用されます：

• ポジショナーが作成された後、その子として新規に作成された、または親が変更されたアイテム
• Item::visible プロパティがfalseからtrueに変更され、表示可能となった子アイテム

トランジションでは、ViewTransition プロパティを使用して、追加されるアイテムに関する詳細情報にアクセスできます。これらのトランジションの使用方法に関する詳細や例については、『ViewTransition 』のドキュメントを参照してください。

関連項目： populate 、ViewTransition 、およびQt Quick Examples - Positioners。

これらのプロパティは、コンテンツ周囲のパディングを指定します。

effectiveLayoutDirection : enumeration [read-only]

このプロパティは、行の有効なレイアウト方向を保持します。

ロケールレイアウト用に添付プロパティ `LayoutMirroring::enabled ` を使用する場合、行ポジショナーの視覚的なレイアウト方向は反転します。ただし、プロパティ `layoutDirection ` は変更されません。

「 Row::layoutDirection 」および「LayoutMirroring 」も参照してください 。

layoutDirection : enumeration

このプロパティは、行の layoutDirection を保持します。

取り得る値：

関連項目: Grid::layoutDirection およびFlow::layoutDirection 。

move : Transition

このプロパティは、ポジショナー内で移動したアイテムに対して遷移を実行するように指定します。ポジショナーの場合、これは以下のアイテムに適用されます：

• ポジショナー内の他のアイテムの追加、削除、または再配置によって位置がずれた際に移動する子アイテム
• ポジショナー内の他のアイテムのサイズ変更によって再配置される子アイテム

トランジションでは、ViewTransition プロパティを使用して、移動中のアイテムに関する詳細情報にアクセスできます。ただし、この移動トランジションの場合、ViewTransition の.targetIndexesおよびViewTransition の.targetItemsリストは、ポジショナー内の他のアイテムの追加によってこのトランジションがトリガーされた場合にのみ設定されます。それ以外の場合は、これらのリストは空になります。 これらの遷移の使用に関する詳細や例については、『ViewTransition 』のドキュメントを参照してください。

また、 add 、populate 、ViewTransition 、およびQt Quick の「例 - ポジショナー」も参照してください 。

populate : Transition

このプロパティには、このポジショナーが作成された時点でその構成要素となっているアイテムに対して実行される遷移が格納されます。この遷移は、ポジショナーが最初に作成された際に実行されます。

トランジションでは、ViewTransition プロパティを使用して、追加されるアイテムに関する詳細情報にアクセスできます。これらのトランジションの使用方法に関する詳細や例については、『ViewTransition 』のドキュメントを参照してください。

「 add 」、「ViewTransition 」、および「Qt Quick Examples - Positioners」も参照してください 。

spacing : real

間隔とは、隣接する項目間の空白の幅（ピクセル単位）のことです。デフォルトの間隔は 0 です。

「Grid::spacing」も参照してください 。

Signal ドキュメント

positioningComplete()

このシグナルは、位置決めが完了したときに発信されます。

メソッドのドキュメント

void forceLayout()

Row は通常、1 フレームごとに子要素の位置を決定します。つまり、スクリプトブロック内では、その下にある子要素が変更されているにもかかわらず、Row がまだそれに応じて更新されていない可能性があります。

このメソッドは、Rowに対し、子要素の未反映の変更に直ちに対応するよう強制します。

注：一般的に、メソッドはコンポーネントの処理が完了してから呼び出すべきです。