Column QML Type
カラム内の子の位置を指定します。詳細...
| Import Statement: | import QtQuick |
| Inherits: |
プロパティ
- add : Transition
- bottomPadding : real
- leftPadding : real
- move : Transition
- padding : real
- populate : Transition
- rightPadding : real
- spacing : real
- topPadding : real
シグナル
メソッド
詳細説明
Columnは、1つの列に沿って子アイテムを配置する型である。アンカーを使わずに一連のアイテムを縦に配置する便利な方法として使用できます。
下の図は、さまざまなサイズの3つの長方形を含むColumnです：
Column { spacing: 2 Rectangle { color: "red"; width: 50; height: 50 } Rectangle { color: "green"; width: 20; height: 50 } Rectangle { color: "blue"; width: 50; height: 20 } }
カラムは自動的にこれらのアイテムをこのように縦に配置します：
Column内のアイテムがvisible 、または幅や高さが0でない場合、そのアイテムはレイアウトされず、Column内に表示されません。また、Columnは自動的に子アイテムを垂直方向に配置するため、Column内の子アイテムはy の位置を設定したり、top 、bottom 、anchors.verticalCenter 、fill 、centerIn のアンカーを使用して垂直方向にアンカーを設定するべきではありません。これらのアクションを実行する必要がある場合は、Columnを使用せずにアイテムを配置することを検討してください。
なお、Column内のアイテムは、Positioner attachedプロパティを使用して、Column内の位置に関する詳細情報にアクセスすることができます。
Columnおよび他の関連するポジショナタイプの使用に関する詳細は、アイテムポジショナを参照してください。
トランジションの使用
Columnは、Columnにアイテムが追加されたり、Column内でアイテムが移動したりすると、特定のトランジションを使用してアイテムをアニメーション化します。
例えば、以下のColumnは、move プロパティを特定のTransition に設定しています：
Column { spacing: 2 Rectangle { color: "red"; width: 50; height: 50 } Rectangle { id: greenRect; color: "green"; width: 20; height: 50 } Rectangle { color: "blue"; width: 50; height: 20 } move: Transition { NumberAnimation { properties: "x,y"; duration: 1000 } } focus: true Keys.onSpacePressed: greenRect.visible = !greenRect.visible }
Spaceキーが押されると、緑色のRectangle のvisible の値が切り替わります。それが現れたり消えたりすると、Column内で青いRectangle が移動し、move の遷移が青いRectangle に自動的に適用されます：
Row,Grid,Flow,Positioner,ColumnLayout, およびQt Quick Examples - Positionersも参照してください 。
プロパティの説明
これらのプロパティは、コンテンツの周りのパディングを保持します。
add : Transition |
このプロパティは、このポジショナーに追加されるアイテムのために実行されるトランジションを保持します。ポジショナーでは、次の場合に適用されます：
- ポジショナーが作成された後に、ポジショナーの子として作成または再保持されるアイテム。
- Item::visible プロパティが false から true に変更され、表示されるようになった子アイテム。
トランジションは、ViewTransition プロパティを使用して、追加されるアイテムの詳細にアクセスできます。トランジションの詳細と使用例については、ViewTransition のドキュメントを参照してください。
注意： このトランジションは、ポジショナー作成時にすでにポジショナーの一部となっているアイテムには適用されません。この場合、代わりにpopulate トランジションが適用される。
populate 、ViewTransition 、およびQt Quick Examples - Positionersも参照してください 。
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 |
spacing は、隣接するアイテムの間を空けるピクセル数です。デフォルトの間隔は 0 です。
Grid::spacingも参照して ください。
シグナル ドキュメント
positioningComplete() |
このシグナルは、位置決めが完了したときに発行されます。
注意： 対応するハンドラはonPositioningComplete です。
メソッドのドキュメント
forceLayout() |
Columnは通常、1フレームに1回子要素を配置します。つまり、スクリプトブロックの内部では、子プロセスが変更されたにもかかわらず、Columnがまだそれに応じて更新されていない可能性があります。
このメソッドにより、Columnは子プロセスの未更新の変更に即座に対応することになります。
注意：一般的にメソッドは、Componentが完了した後にのみ呼び出されるべきです。
©2024 The Qt Company Ltd. 本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 ここで提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
