C
Flickable QML Type
フリック」できる表面を提供します。もっと詳しく...
| Import Statement: | import QtQuick |
| Since: | Qt Quick Ultralite 1.0 |
| Inherits: | |
| Inherited By: |
列挙
プロパティ
- boundsBehavior : BoundsBehavior
- contentHeight : int
- contentItem : Item*
- contentWidth : int
- contentX : int
- contentY : int
- flickableDirection : FlickableDirection
- interactive : bool
- maximumFlickVelocity : Item*
- movingHorizontally : bool
- movingVertically : bool
- visibleArea
- visibleArea.heightRatio : real
- visibleArea.widthRatio : real
- visibleArea.xPosition : real
- visibleArea.yPosition : real
詳細説明
Flickableアイテムは、子アイテムをドラッグしてフリックできるサーフェス上に配置し、子アイテム上のビューをスクロールさせます。この動作は、ListView や GridView など、多数の子アイテムを表示するように設計されたアイテムの基礎を形成します。
従来のユーザーインターフェースでは、スクロールバーや矢印ボタンなどの標準的なコントロールを使用してビューをスクロールすることができます。状況によっては、マウスボタンを押しながらカーソルを移動することで、ビューを直接ドラッグすることも可能です。タッチ・ベースのユーザー・インターフェースでは、このドラッグ操作は、ユーザーがビューに触れるのを止めた後もスクロールを続けるフリック操作で補完されることがよくあります。
Flickableは、そのコンテンツを自動的にクリップしません。フルスクリーンアイテムとして使用しない場合は、clipプロパティをtrueに設定することを検討する必要があります。
使用例
次の例では、大きな画像に小さなビューを表示し、ユーザがドラッグまたはフリックして画像のさまざまな部分を表示できるようにしています。
Flickable { width: 150; height: 100 contentWidth: image.width; contentHeight: image.height Image { id: image; source: "qrc:/images/qtlogo.png" } }
列挙ドキュメント
BoundsBehavior |
選択可能な動作のリストを提供します。
| 定数 | 説明 |
|---|---|
Flickable.StopAtBounds | コンテンツはFlickableの境界を越えてドラッグできず、フリックはオーバーシュートしない。 |
Flickable.DragOverBounds | コンテンツは Flickable の境界を越えてドラッグできるが、フリックはオーバーシュートしない。 |
Flickable.OvershootBounds | フリックしたときにコンテンツが境界をオーバーシュートできるが、コンテンツは Flickable の境界を越えてドラッグできない。 |
Flickable.DragAndOvershootBounds | コンテンツは Flickable の境界を越えてドラッグすることができ、フリックしても境界をオーバーシュートすることができます。 |
FlickableDirection |
選択可能なフリック方向のリストを提供します。
| 定数 | 説明 |
|---|---|
Flickable.AutoFlickDirection | 以下の条件に応じて、垂直または水平方向にフリックできるようにします：
|
Flickable.AutoFlickIfNeeded | AutoFlickDirection と同様に、AutoFlickIfNeeded も、contentHeight とcontentWidth に応じて、垂直または水平方向のフリックを許可します。 |
Flickable.HorizontalFlick | 水平方向のフリックを許可します。 |
Flickable.VerticalFlick | 縦方向へのフリックが可能。 |
Flickable.HorizontalAndVerticalFlick | 両方向のフリックを許可する。 |
プロパティ Documentation
boundsBehavior : BoundsBehavior |
このプロパティは、サーフェスがFlickableの境界を越えてドラッグされるかどうか、またはフリックされたときにFlickableの境界をオーバーシュートするかどうかを保持します。
contentHeight : int |
コンテンツ（Flickableによって制御されるサーフェス）の高さ。
contentItem : Item* |
Flickable内で移動させるItemを含む内部アイテム。
contentWidth : int |
コンテンツ（Flickableが制御するサーフェス）の幅。
contentX : int |
このプロパティは、現在Flickableの左側にあるサーフェスのX座標を保持します。
contentY : int |
このプロパティは、現在Flickableの上部にあるサーフェスのY座標を保持します。
flickableDirection : FlickableDirection |
このプロパティは、ビューをどの方向にフリックできるかを決定します。
interactive : bool |
このプロパティは、ユーザが Flickable を操作できるかどうかを示します。インタラクティブでない Flickable をユーザーがドラッグまたはフリックすることはできません。
デフォルトでは、このプロパティは true です。
このプロパティは、フリックを一時的に無効にするのに便利です。例えば、Flickable の子であるポップアップ・ダイアログをスクロールしている間、Flickable マップをフリーズさせたい場合などです。
maximumFlickVelocity : Item* |
このプロパティは、ユーザがビューをフリックできる最大速度をピクセル/秒で保持します。
デフォルト値はプラットフォーム依存です。
movingHorizontally : bool |
このプロパティは、ユーザがビューをドラッグまたはフリックすることによって、ビューが現在水平方向に移動しているかどうかを示します。
movingVertically : bool |
このプロパティは、ユーザがビューをドラッグまたはフリックすることによって、ビューが現在垂直方向に移動しているかどうかを記述します。
これらのプロパティは、現在表示されている領域の位置とサイズを記述します。サイズは、現在表示されているビュー全体のパーセンテージとして定義され、0.0～1.0にスケーリングされます。ページ位置は通常、0.0（始点）から1.0マイナスサイズ比（終点）の範囲です。すなわち、yPosition は、0.0から1.0-heightRatio の範囲です。ただし、コンテンツが通常の範囲外にドラッグされる可能性があり、その結果、ページ位置も通常の範囲外になります。
このグループの値はすべて読み取り専用です。変更にはcontentX 、contentY 、contentWidth 、contentHeight を使用してください。
特定の Qt ライセンスの下で利用可能です。
詳細はこちら。
