Row QML Type
子プロセスを一列に並べる。詳細...
| Import Statement: | import QtQuick |
| Inherits: |
プロパティ
- add : Transition
- bottomPadding : real
- effectiveLayoutDirection : enumeration
- layoutDirection : enumeration
- leftPadding : real
- move : Transition
- padding : real
- populate : Transition
- rightPadding : real
- spacing : real
- topPadding : real
信号
方法
- void forceLayout()
詳細説明
Rowは、1つの行に沿って子アイテムを配置する型である。アンカーを使用せずに一連のアイテムを水平に配置する便利な方法として使用できます。
下の図は、さまざまなサイズの 3 つの長方形を含む行です:
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 } }
行は、このように自動的にこれらのアイテムを水平に配置します:

行内のアイテムがvisible でない場合、または幅や高さが 0 の場合、そのアイテムはレイアウトされず、行内に表示されません。また、行は自動的に子項目を水平に配置するため、行内の子項目は、x の位置を設定したり、left 、right 、anchors.horizontalCenter 、fill 、centerIn のアンカーを使用して自身を水平に固定したりしないでください。これらのアクションを実行する必要がある場合は、行を使用せずにアイテムを配置することを検討してください。
行内のアイテムは、Positioner 添付プロパティを使用して、行内の位置に関する詳細情報にアクセスできます。
Rowおよび関連する他のポジショナタイプの詳細については、「アイテム ポジショナ」を参照してください。
Column 、Grid 、Flow 、Positioner 、RowLayout 、Qt Quick 例 - ポジショナも参照してください 。
プロパティのドキュメント
add : Transition
このプロパティは、このポジショナに追加されるアイテムのために実行されるトランジションを保持する。ポジショナーでは、次の場合に適用されます:
- ポジショナーが作成された後に、ポジショナーの子として作成されたアイテム、または再ペアレントされたアイテム。
- Item::visible プロパティが false から true に変更され、表示されるようになった子アイテム。
トランジションは、ViewTransition プロパティを使用して、追加されるアイテムの詳細にアクセスできます。トランジションの詳細と使用例については、ViewTransition のドキュメントを参照してください。
注意: このトランジションは、ポジショナー作成時にすでにポジショナーの一部となっているアイテムには適用されません。この場合、代わりにpopulate トランジションが適用される。
populate 、ViewTransition 、Qt Quick Examples - Positionersも参照してください 。
これらのプロパティは、コンテンツの周りのパディングを保持します。
effectiveLayoutDirection : enumeration [read-only]
このプロパティは、行の有効なレイアウト方向を保持する。
付属のプロパティLayoutMirroring::enabled をロケールレイアウトに使用する場合、行ポジショナの視覚的なレイアウト方向はミラーされます。しかし、layoutDirection プロパティは変更されません。
Row::layoutDirection およびLayoutMirroringも参照してください 。
layoutDirection : enumeration
このプロパティは、行の layoutDirection を保持する。
取り得る値:
| 定数 | 説明 |
|---|---|
Qt.LeftToRight | (デフォルト) アイテムは左から右にレイアウトされる。行の幅が明示的に設定されている場合、左アンカーは行の左側に残ります。 |
Qt.RightToLeft | 項目は右か ら 左へ並べ ら れます。行の幅が明示的に設定 さ れている と きは、 右ア ン カは行の右のま まにな り ます。 |
Grid::layoutDirection およびFlow::layoutDirectionも参照のこと 。
move : Transition
このプロパティは、ポジショナ内で移動したアイテムに対して実行するトランジションを保持する。ポジショナーでは、次のような場合に適用されます:
- ポジショナー内の他のアイテムの追加、削除、または並べ替えによって移動する子アイテム。
- ポジショナー内の他のアイテムのサイズ変更によって再配置される子アイテム。
トランジションは、ViewTransition プロパティを使用して、移動されるアイテムの詳細にアクセスすることができます。ただし、この移動トランジションでは、ViewTransition.targetIndexes リストとViewTransition.targetItems リストは、ポジショナー内の他のアイテムの追加によってこのトランジションがトリガーされた場合にのみ設定されることに注意してください。これらのトランジションの詳細と使用例については、ViewTransition ドキュメントを参照してください。
add,populate,ViewTransition,Qt Quick Examples - Positionersも参照してください 。
populate : Transition
このプロパティは、作成時にこのポジショナーの一部であるアイテムに対して実行されるトランジションを保持する。このトランジションは、ポジショナーが最初に作成されたときに実行されます。
このトランジションは、ViewTransition プロパティを使用して、追加されるアイテムの詳細にアクセスできます。これらのトランジションの詳細と使用例については、ViewTransition ドキュメントを参照してください。
add 、ViewTransition 、Qt Quick Examples - Positionersも参照してください 。
spacing : real
スペーシングは、隣接するアイテムの間を空けるピクセル数です。デフォルトの間隔は0です。
Grid::spacingも参照のこと 。
シグナル・ドキュメント
positioningComplete()
このシグナルは位置決めが完了したときに発せられる。
注意: 対応するハンドラはonPositioningComplete です。
メソッドのドキュメント
void forceLayout()
Rowは通常、1フレームに1回、子プロセスを配置します。つまり、スクリプトブロックの内部では、子プロセスが変更されても、行がまだそれに応じて更新されていない可能性があります。
このメソッドを使用すると、行は子プロセスの未処理の変更に即座に対応するようになります。
注意: 一般的に、メソッドは Component が完了した後にのみ呼び出す必要があります。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.