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
信号
方法
詳細説明
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 例 - ポジショナーも参照のこと 。
effectiveLayoutDirection : enumeration |
このプロパティは、行の有効なレイアウト方向を保持する。
付属のプロパティ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 例 - ポジショナーも参照のこと 。
populate : Transition |
このプロパティは、作成時にこのポジショナーの一部であるアイテムに対して実行されるトランジションを保持します。このトランジションは、ポジショナーが最初に作成されたときに実行されます。
トランジションは、ViewTransition プロパティを使用して、追加されるアイテムの詳細にアクセスできます。これらのトランジションの詳細と使用例については、ViewTransition ドキュメントを参照してください。
add 、ViewTransition 、Qt Quick Examples - Positionersも参照してください 。
spacing : real |
スペーシングは、隣接するアイテムの間を空けるピクセル数です。デフォルトの間隔は0です。
Grid::spacingも参照して ください。
シグナル ドキュメント
positioningComplete() |
このシグナルは、位置決めが完了したときに発行されます。
注意： 対応するハンドラはonPositioningComplete です。
メソッド ドキュメント
forceLayout() |
Rowは通常、1フレームに1回子要素を配置します。つまり、スクリプトブロックの内部では、子プロセスが変更されたにもかかわらず、それに応じて行がまだ更新されていない可能性があります。
このメソッドを使用すると、行は子プロセスの未処理の変更に即座に対応するようになります。
注意: 一般的に、メソッドは Component が完了した後にのみ呼び出す必要があります。
© 2025 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.
