C

Flickable QML Type

「フリック」操作が可能な画面を提供します。詳細...

Import Statement:	`import QtQuick`
Since:	Qt Quick Ultralite 1.0
Inherits:	Item
Inherited By:	ListView

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

列挙型

BoundsBehavior
FlickableDirection

プロパティ

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`	以下の条件に応じて、垂直方向または水平方向のフリックを許可します。 `contenteHeight` がFlickableの高さと等しくない場合、垂直フリックを許可します。 `contentWidth` がFlickableの幅と等しくない場合、水平フリックを許可します。
`Flickable.AutoFlickIfNeeded`	`AutoFlickDirection` と同様に、`AutoFlickIfNeeded` も`contentHeight` および`contentWidth` に応じて、垂直方向または水平方向のフリックを許可します。
`Flickable.HorizontalFlick`	水平方向のフリックを許可します。
`Flickable.VerticalFlick`	垂直方向のフリックを許可します。
`Flickable.HorizontalAndVerticalFlick`	両方向へのフリックが可能です。

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

boundsBehavior : BoundsBehavior `[default]`

このプロパティは、サーフェスが Flickable の境界の外までドラッグできるか、またはフリック操作時に Flickable の境界を越えてしまうかどうかを指定します。

contentHeight : int

コンテンツの高さ（Flickableによって制御される領域）。

contentItem : Item*

Flickable内で移動対象となるアイテムを含む内部アイテム。

contentWidth : int

コンテンツの幅（Flickableによって制御される領域）。

contentX : int

このプロパティには、現在「Flickable」の左端にあるサーフェスのX座標が格納されます。

contentY : int

このプロパティには、Flickableの最上部に現在表示されているサーフェスのY座標が格納されます。

flickableDirection : FlickableDirection `[default]`

このプロパティは、ビューをどの方向にフリックできるかを決定します。

interactive : bool

このプロパティは、ユーザーが Flickable と操作できるかどうかを指定します。インタラクティブでない Flickable では、ユーザーはドラッグやフリックを行うことができません。

デフォルトでは、このプロパティは true です。

このプロパティは、フリック操作を一時的に無効にする場合に役立ちます。これにより、Flickableの子要素との特別な操作が可能になります。例えば、Flickableの子要素であるポップアップダイアログをスクロールしている間、Flickableのマップを固定したい場合などが挙げられます。

maximumFlickVelocity : Item*

このプロパティは、ユーザーがビューをフリックできる最大速度（ピクセル/秒）を保持します。

デフォルト値はプラットフォームによって異なります。

movingHorizontally : bool

このプロパティは、ユーザーがビューをドラッグまたはフリックしたことにより、ビューが現在水平方向に移動しているかどうかを表します。

movingVertically : bool

このプロパティは、ユーザーがビューをドラッグまたはフリックしたことにより、ビューが現在垂直方向に移動しているかどうかを表します。

visibleArea group

visibleArea.heightRatio : real

visibleArea.widthRatio : real

visibleArea.xPosition : real

visibleArea.yPosition : real

これらのプロパティは、現在表示されている領域の位置とサイズを表します。サイズは、現在表示されている全画面に対する割合として定義され、0.0 ～ 1.0 の範囲にスケーリングされます。ページの位置は通常、0.0（開始位置）から 1.0 からサイズ比率を引いた値（終了位置）の範囲にあります。つまり、yPosition は 0.0 から 1.0 -heightRatio の範囲にあります。ただし、コンテンツが通常の範囲外にドラッグされる可能性があり、その結果、ページ位置も通常の範囲外になることがあります。

このグループのすべての値は読み取り専用です。変更を行うには、contentX 、contentY 、contentWidth 、およびcontentHeight を使用してください。

特定の Qt ライセンスの下で利用可能です。
詳細はこちらをご覧ください。

C