Flickable QML Type

これらのプロパティは、現在Flickableの左上隅にあるサーフェス座標を保持します。例えば、イメージを100ピクセル上にフリックすると、contentY は100増加します。

Examples of contentX and contentY 、originX 、originYも参照して ください。

x軸とy軸に沿った瞬時の移動速度で、単位はピクセル/秒。

報告された速度は、不規則な出力を避けるために平滑化されます。

コンテンツサイズが大きい（ビューサイズの10倍以上）ビューでは、複数の素早い連続フリックの場合、フリックの速度がタッチの速度を上回る場合があることに注意してください。これにより、ユーザは大きなコンテンツをより速くフリックできるようになります。

これらのプロパティは、フリック可能なビューがそれぞれ先頭または末尾に配置されている場合に真になります。

コンテンツ（Flickableによって制御されるサーフェス）の寸法。これは通常、Flickableに配置されたアイテムの合計サイズに設定する必要があります。

次のスニペットは、これらのプロパティを使用して、Flickableアイテム自体よりも大きな画像を表示する方法を示しています：

import QtQuick

Flickable {
    width: 200; height: 200
    contentWidth: image.width; contentHeight: image.height

    Image { id: image; source: "bigImage.png" }
}

場合によっては、contentItem のchildrenRect.width プロパティとchildrenRect.height プロパティに基づいて、コンテンツの寸法を自動的に設定することができます。例えば、前のスニペットは次のように書き換えることができます：

contentWidth: contentItem.childrenRect.width; contentHeight: contentItem.childrenRect.height

これは、childrenRectの原点が0,0であると仮定していますが。

これらのプロパティは、コンテンツの周りの余白を保持します。このスペースは、contentWidth とcontentHeight に加えて確保されています。

これらのプロパティは、コンテンツの原点を保持します。この値は、レイアウト方向に関係なく、常にコンテンツの左上位置を指す。

これは通常(0,0)ですが、ListView とGridView は、デリゲートサイズのばらつきや、可視領域外でのアイテムの挿入/削除により、任意の原点を持つ場合があります。

contentX とcontentYも参照して ください。

これらのプロパティは、ユーザーがビューをフリックすることによって、ビューが現在水平、垂直、またはいずれかの方向に移動しているかどうかを記述します。

これらのプロパティは、ユーザーがビューをドラッグすることによって、ビューが現在水平、垂直、またはいずれかの方向に移動しているかどうかを記述します。

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

このプロパティは、サーフェスがFlickableの境界を超えてドラッグされるか、またはフリックされたときにFlickableの境界をオーバーシュートするかどうかを保持します。

boundsMovement がFlickable.FollowBoundsBehavior の場合、Flickable.StopAtBounds 以外の値を指定すると、ビューのエッジがハードな物理的境界ではなく、ソフトな印象を与えます。

boundsBehavior ：

• Flickable.StopAtBounds - コンテンツはflickableの境界を越えてドラッグできず、フリックはオーバーシュートしません。
• Flickable.DragOverBounds - コンテンツは Flickable の境界を超えてドラッグできますが、フリックはオーバーシュートしません。
• Flickable.OvershootBounds - フリック時にコンテンツが境界をオーバーシュートできますが、コンテンツはフリッカブルの境界を超えてドラッグできません。(QtQuick 2.5 以降 )
• Flickable.DragAndOvershootBounds (default) - Flickableの境界を越えてコンテンツをドラッグすることができ、フリックしたときに境界をオーバーシュートすることができます。

horizontalOvershoot 、verticalOvershoot 、およびboundsMovementも参照してください 。

このプロパティは、Flickableが、物理的なハード境界ではなく、ビューのエッジがソフトであるかのような感覚を与えるかどうかを保持します。

boundsMovement ：

• Flickable.StopAtBounds - これは、コンテンツがflickableの境界を超えてドラッグまたはフリックしても追従しないカスタムエッジエフェクトを実装することができます。horizontalOvershoot とverticalOvershoot の値を使用して、カスタム エッジ エフェクトを実装できます。
• Flickable.FollowBoundsBehavior (デフォルト) - コンテンツがフリッカブルの境界を越えてドラッグまたはフリックに従うかどうかは、boundsBehavior によって決定されます。

次の例では、コンテンツは境界内に保持され、代わりに水平方向の境界を越えてフリックされたときにフリップ エフェクトが適用されます：

Flickable {
    id: flickable
    boundsMovement: Flickable.StopAtBounds
    boundsBehavior: Flickable.DragAndOvershootBounds
    transform: Rotation {
        axis { x: 0; y: 1; z: 0 }
        origin.x: flickable.width / 2
        origin.y: flickable.height / 2
        angle: Math.min(30, Math.max(-30, flickable.horizontalOvershoot))
    }
}

次の例では、コンテンツはバウンズ内に保持され、代わりに垂直バウンズ上でドラッグされたときに不透明エフェクトが適用されます：

Flickable {
    boundsMovement: Flickable.StopAtBounds
    boundsBehavior: Flickable.DragOverBounds
    opacity: Math.max(0.5, 1.0 - Math.abs(verticalOvershoot) / height)
}

boundsBehavior 、verticalOvershoot 、horizontalOvershootも参照してください 。

Flickable 内で移動する Items を含む内部アイテム。

Flickable の子として宣言されたアイテムは、自動的に Flickable の contentItem の親になります。

動的に作成されたアイテムは、明示的にcontentItem の親になる必要があります：

Flickable {
    id: myFlickable
    function addItem(file) {
        var component = Qt.createComponent(file)
        component.createObject(myFlickable.contentItem);
    }
}

このプロパティは、フリックが減速する速度を保持します。数値が大きいほど、ユーザがタッチでフリックするのを止めたときに減速します。例えば、0.0001はほぼ「摩擦なし」で、10000はかなり「粘着性」を感じます。

デフォルト値はプラットフォームに依存します。0以下の値は使用できません。

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

• Flickable.AutoFlickDirection（デフォルト） -contentHeightがFlickableの高さと等しくない場合、垂直方向のフリックを許可します。contentWidthが Flickable のwidthと等しくない場合、水平方向のフリックを許可します。
• Flickable.AutoFlickIfNeeded -contentHeightが Flickable のheightより大きい場合、垂直方向のフリックを許可します。contentWidthが Flickable の幅より大きい場合、水平方向のフリックを許可します。(QtQuick 2.7 以降 )
• Flickable.HorizontalFlick - 水平方向のフリックを許可します。
• Flickable.VerticalFlick - 垂直方向のフリックを許可します。
• Flickable.HorizontalAndVerticalFlick - 両方向のフリックを許可します。

このプロパティは、水平方向のオーバーシュート、つまり、コンテンツがフリッカブルの境界を越えてドラッグまたはフリックされた水平方向の距離を保持します。この値は、コンテンツが始点を超えてドラッグまたはフリックされた場合は負に、終点を超えた場合は正になります。それ以外の場合は、0.0 。

ドラッグまたはフリックしたときに値が報告されるかどうかは、boundsBehavior によって決定されます。オーバーシュート距離は、boundsMovement がFlickable.StopAtBounds の場合でも報告される。

verticalOvershoot,boundsBehavior,boundsMovementも参照 。

このプロパティは、ユーザーが Flickable と対話できるかどうかを記述します。インタラクティブでない Flickable をユーザーがドラッグまたはフリックすることはできません。

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

このプロパティは、フリックを一時的に無効にするのに便利です。例えば、Flickable の子であるポップアップ・ダイアログをスクロールしている間、Flickable マップをフリーズさせたい場合などです。

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

デフォルト値はプラットフォーム依存です。

このプロパティは、contentX とcontentY のアライメントをピクセル (true) またはサブピクセル (false) に設定します。

pixelAligned を有効にすると、静止コンテンツや、1 ピクセル幅の線、テキスト、ベクターグラフィックスなど、エッジのコントラストが高い動画コンテンツに最適化されます。アニメーションの品質に最適化する場合は pixelAligned を無効にします。

デフォルトはfalse です。

このプロパティは、Flickableの子プロパティに押下を配信する遅延時間（ms）を保持します。これは、フリック操作の前に押されたことに反応すると望ましくない影響がある場合に便利です。

遅延時間がタイムアウトする前にflickableがドラッグ/フリックされた場合、pressイベントは配信されません。タイムアウト内にボタンが離された場合、押下と離下の両方が配信されます。

ネストされたFlickableでpressDelayが設定されている場合、外側のFlickableのpressDelayは内側のFlickableによってオーバーライドされることに注意してください。ドラッグがプラットフォームのドラッグしきい値を超えた場合、このプロパティに関係なくプレスイベントが配信されます。

QStyleHintsも参照してください 。

これは、コンテンツビューがFlickableの境界にスナップバックしたときに適用される遷移を保持します。トランジションは、ビューがコンテンツ領域の端を越えてフリックまたはドラッグされたとき、またはreturnToBounds （）が呼び出されたときにトリガされます。

import QtQuick 2.0

Flickable {
    width: 150; height: 150
    contentWidth: 300; contentHeight: 300

    rebound: Transition {
        NumberAnimation {
            properties: "x,y"
            duration: 1000
            easing.type: Easing.OutBounce
        }
    }

    Rectangle {
        width: 300; height: 300
        gradient: Gradient {
            GradientStop { position: 0.0; color: "lightsteelblue" }
            GradientStop { position: 1.0; color: "blue" }
        }
    }
}

上記のビューがその境界を超えてフリックされると、指定されたトランジションを使用してその境界に戻ります：

このプロパティが設定されていない場合、デフォルトのアニメーションが適用されます。

このプロパティがtrueに設定されている場合、マウスまたはタッチポイントがコンテンツのドラッグを開始するのに十分な距離に移動すると、コンテンツは、押されたときにカーソルまたはタッチポイントの下にあったコンテンツピクセルがそのポイントの下に残るように、ジャンプします。

デフォルトは、false で、ドラッグの開始時に距離が「失われる」代わりに、よりスムーズなエクスペリエンス（ジャンプなし）を提供します。

このプロパティは、垂直方向のオーバーシュート、つまり、コンテンツがフリッカブルの境界を越えてドラッグまたはフリックされた垂直方向の距離を保持します。この値は、コンテンツが始点を超えてドラッグまたはフリックされた場合は負に、終点を超えた場合は正になります。それ以外の場合は、0.0 。

ドラッグまたはフリックしたときに値が報告されるかどうかは、boundsBehavior によって決定されます。オーバーシュート距離は、boundsMovement がFlickable.StopAtBounds の場合でも報告される。

horizontalOvershoot,boundsBehavior,boundsMovementも参照 。

これらのプロパティは、現在表示されている領域の位置とサイズを記述します。サイズは、現在表示されている全景に対するパーセンテージとして定義され、0.0～1.0にスケーリングされます。ページ位置は通常、0.0（始点）から1.0マイナスサイズ比（終点）の範囲にあり、すなわちyPosition は 0.0 から 1.0-heightRatio の範囲にあります。 しかし、コンテンツが通常の範囲外にドラッグされる可能性があり、その結果ページ位置も通常の範囲外になります。

これらのプロパティは、通常、スクロールバーを描画するために使用されます。例えば

Rectangle {
    width: 200; height: 200

    Flickable {
        id: flickable
        ...
    }

    Rectangle {
        id: scrollbar
        anchors.right: flickable.right
        y: flickable.visibleArea.yPosition * flickable.height
        width: 10
        height: flickable.visibleArea.heightRatio * flickable.height
        color: "black"
    }
}

このシグナルは、ユーザがビューのドラッグを止めたときに発せられる。

タッチ/マウスボタンが離された時点でドラッグの速度が十分であれば、フリックが開始されます。

このシグナルは、ユーザーインタラクションによってビューがドラッグされ始めたときに発行されます。

このシグナルは、フリックまたは一連のフリックの後、ビューの移動が停止したときに発行されます。

このシグナルは、ビューがフリックされた時に発行されます。フリックはマウスまたはタッチが離された時点から開始されます。

このシグナルは、ユーザーインタラクションまたは生成されたflick()によってビューの移動が停止したときに発行されます。フリックがアクティブだった場合、フリックが停止するとこのシグナルが発行されます。フリックがアクティブでなかった場合、このシグナルはユーザーがドラッグを止めたとき、つまりマウスやタッチを離したときに発行されます。

このシグナルは、ユーザーインタラクションまたは生成されたflick()によってビューが動き始めたときに発行されます。

現在のフリックアニメーションをキャンセルします。

xVelocity 、水平方向およびyVelocity 垂直方向にピクセル/秒でコンテンツをフリックします。

このメソッドを呼び出すと、実際のタッチスクリーンのフリックのように、対応する移動とフリックのプロパティとシグナルが更新されます。

コンテンツをwidth xheight 約center にリサイズします。

これは、Flickableのコンテンツを拡大縮小するのではなく、contentWidth とcontentHeight のサイズを変更するだけです。

コンテンツのサイズを変更すると、コンテンツが Flickable の境界外に配置される場合があります。returnToBounds() を呼び出すと、コンテンツは法的な範囲内に戻ります。

コンテンツが合法的な範囲内にあることを確認します。

これは、コンテンツを手動で配置した後に、コンテンツが法的な範囲内にあることを確認するために呼び出されます。