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 マップをフリーズしたい場合などです。

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