Flow QML Type

子要素を並べて配置し、必要に応じて改行を行います。詳細...

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

プロパティ

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

信号

• positioningComplete()

方法

• void forceLayout()

詳細な説明

「Flow」アイテムは、子アイテムをページ上の文字のように配置し、改行させて行や列を形成します。

以下は、さまざまなText アイテムを含むFlowの例です：

    Flow {
        anchors.fill: parent
        anchors.margins: 4
        spacing: 10

        Text { text: "Text"; font.pixelSize: 40 }
        Text { text: "items"; font.pixelSize: 40 }
        Text { text: "flowing"; font.pixelSize: 40 }
        Text { text: "inside"; font.pixelSize: 40 }
        Text { text: "a"; font.pixelSize: 40 }
        Text { text: "Flow"; font.pixelSize: 40 }
        Text { text: "item"; font.pixelSize: 40 }
    }

「Flow」アイテムは、子要素である「Text 」アイテムを自動的に並べて配置し、必要に応じて折り返します：

Flow内のアイテムがvisible でない場合、または幅や高さが0の場合、そのアイテムはレイアウトされず、Flow内には表示されません。また、Flowは子アイテムを自動的に配置するため、Flow内の子アイテムはx やy で位置を指定したり、anchor プロパティのいずれかを使用してアンカーを設定したりしてはいけません。

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

「 Column 」、「Row 」、「Grid 」、「Positioner 」、および「Qt Quick Examples - Positioners」も参照してください 。

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

add : Transition

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

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

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

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

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

effectiveLayoutDirection : enumeration [read-only]

このプロパティは、フローの実際のレイアウト方向を保持します。

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

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

flow : enumeration

このプロパティは、レイアウトのフローを保持します。

設定可能な値は以下の通りです：

• Flow.LeftToRight（既定値） - アイテムは、layoutDirection に従って互いに隣接して配置され、Flowの幅を超えると次の行に折り返されます。
• Flow.TopToBottom - アイテムは、フローの高さを超えるまで上から下へと隣り合って配置され、その後、次の列に折り返されます。

layoutDirection : enumeration

このプロパティは、レイアウトの方向を指定します。

取り得る値は以下の通りです。

• Qt.LeftToRight (既定値) - アイテムは上から下へ、そして左から右へと配置されます。フローの方向は、Flow::flow プロパティに依存します。
• Qt.RightToLeft - アイテムは上から下へ、そして右から左へと配置されます。フローの方向は、Flow::flow プロパティに依存します。

「 Grid::layoutDirection 」および「Row::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

spacing は、隣接する各アイテムの間に空けるスペースの量（ピクセル単位）であり、デフォルト値は 0 です。

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

Signal ドキュメント

positioningComplete()

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

メソッドのドキュメント

void forceLayout()

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

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

注：一般的に、メソッドはコンポーネントの実行が完了した後にのみ呼び出すべきです。