このページでは

C

SwipeView QML Type

ユーザーが横方向にスワイプしてページを移動できるようにします。詳細...

Import Statement: import QtQuick.Controls
Since: Qt Quick Ultralite 1.0
Inherits:

Control

プロパティ

方法

詳細説明

SwipeViewは、スワイプ操作に基づくナビゲーションモデルを提供します。

SwipeViewには一連のページが設定されます。一度に表示されるのは1ページのみです。ユーザーは横方向にスワイプすることで、ページ間を移動できます。なお、SwipeView自体は完全に非視覚的なものであることに注意してください。

SwipeView{
    id: theSwipe
    width: 150; height: 150
    clip: true
    Rectangle
    {
        color: "red"
    }
    Rectangle
    {
        color: "yellow"
    }
    Rectangle
    {
        color: "lightGreen"
    }
}

上記に示すように、SwipeViewには、ビューの子要素としてインラインで定義された静的なページセットが格納されます。

一般的に、SwipeViewに過度な数のページを追加することは推奨されません。ただし、ページ数が増加した場合や、個々のページが比較的複雑な場合は、ユーザーが直ちにアクセスできないページをアンロードすることでリソースを解放することが望ましい場合があります。『Qt Quick Ultralite パフォーマンスガイド』の「コンポーネントの動的読み込み」のセクションも参照してください。

注:SwipeViewは 、ビューに追加されたアイテムのジオメトリ管理を引き継ぎます。アイテムへのアンカーの使用はサポートされておらず、width やheight の割り当てはすべてビューによって上書きされます。これはアイテムのルートにのみ適用される点に注意してください。子要素に対して幅や高さを指定したり、アンカーを使用したりする場合は、期待どおりに動作します。

注:SwipeViewは QtQuick.Templates::SwipeViewに基づいており、contentItem がFlickable である必要があります。他のcontentItemを使用することはサポートされていません。

「コントロールのスタイル設定」も参照してください 。

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

count : int [read-only]

このプロパティは、SwipeView 内のページ数を保持します。

「currentIndex」も参照してください 。

currentIndex : int

このプロパティは、現在表示されている項目のインデックスを保持します。これを使用すると、特定のページに自動的にスクロールさせることができます。

「currentItem」も参照してください 。

currentItem : Item [read-only]

このプロパティは、現在表示されている項目を保持します。

「currentIndex」も参照してください 。

interactive : bool

このプロパティは、ユーザーがSwipeView と対話できるかどうかを指定します。対話できないビューでは、ユーザーはスワイプ操作を行うことができません。

デフォルト値は `true` です。

orientation : Qt::Orientation

このプロパティは向きを保持します。

メソッドのドキュメント

void decrementCurrentIndex()

これにより、現在のページがインデックスの小さいページに切り替わります。

関連項目: currentIndex 、incrementCurrentIndex 、およびsetCurrentIndex 。

void incrementCurrentIndex()

これにより、現在のページが、インデックスの大きいページに切り替わります。

関連項目 :currentIndex 、decrementCurrentIndex 、およびsetCurrentIndexも参照してください 。

void setCurrentIndex(int index)

これにより、現在のページが指定されたindex のページに変更されます。

currentIndex 、decrementCurrentIndex 、およびincrementCurrentIndexも参照してください 。

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