このページでは

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

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

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

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

count : int [read-only]

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

currentIndex」も参照してください

currentIndex : int

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

currentItem」も参照してください

currentItem : Item [read-only]

このプロパティには、現在表示されている項目が格納されます。

currentIndex」も参照してください

interactive : bool

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

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

orientation : Qt::Orientation

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

メソッドのドキュメント

void decrementCurrentIndex()

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

currentIndexincrementCurrentIndex 、およびsetCurrentIndexも参照してください

void incrementCurrentIndex()

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

関連項目 currentIndexdecrementCurrentIndex 、およびsetCurrentIndexも参照してください

void setCurrentIndex(int index)

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

currentIndexdecrementCurrentIndex 、およびincrementCurrentIndexも参照してください

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