Back to Qt.io
Contact Us Blog Download Qt
このページでは

Surface3D QML Type

3Dサーフェスグラフの使い方を説明します。詳細...

Import Statement: import QtGraphs
Inherits:

GraphsItem3D

プロパティ

信号

方法

詳細説明

この型により、開発者はQt Quick を使ってサーフェスプロットを 3D でレンダリングできるようになる。

この型を使うにはQt Graphs モジュールをインポートする必要がある：

import QtGraphs

その後、qmlファイルでSurface3Dを使用することができます：

import QtQuick
import QtGraphs

Item {
    width: 640
    height: 480

    Surface3D {
        width: parent.width
        height: parent.height
        Surface3DSeries {
            itemLabelFormat: "Pop density at (@xLabel N, @zLabel E): @yLabel"
            ItemModelSurfaceDataProxy {
                itemModel: dataModel
                // Mapping model roles to surface series rows, columns, and values.
                rowRole: "longitude"
                columnRole: "latitude"
                yPosRole: "pop_density"
            }
        }

        onTapped: {
            // Disable the default input handler
            unsetDefaultTapHandler()
            // Implement own custom event handler
            console.log("Custom tap event handler")
        }
    }
    ListModel {
        id: dataModel
        ListElement{ longitude: "20"; latitude: "10"; pop_density: "4.75"; }
        ListElement{ longitude: "21"; latitude: "10"; pop_density: "3.00"; }
        ListElement{ longitude: "22"; latitude: "10"; pop_density: "1.24"; }
        ListElement{ longitude: "23"; latitude: "10"; pop_density: "2.53"; }
        ListElement{ longitude: "20"; latitude: "11"; pop_density: "2.55"; }
        ListElement{ longitude: "21"; latitude: "11"; pop_density: "2.03"; }
        ListElement{ longitude: "22"; latitude: "11"; pop_density: "3.46"; }
        ListElement{ longitude: "23"; latitude: "11"; pop_density: "5.12"; }
        ListElement{ longitude: "20"; latitude: "12"; pop_density: "1.37"; }
        ListElement{ longitude: "21"; latitude: "12"; pop_density: "2.98"; }
        ListElement{ longitude: "22"; latitude: "12"; pop_density: "3.33"; }
        ListElement{ longitude: "23"; latitude: "12"; pop_density: "3.23"; }
        ListElement{ longitude: "20"; latitude: "13"; pop_density: "4.34"; }
        ListElement{ longitude: "21"; latitude: "13"; pop_density: "3.54"; }
        ListElement{ longitude: "22"; latitude: "13"; pop_density: "1.65"; }
        ListElement{ longitude: "23"; latitude: "13"; pop_density: "2.67"; }
    }
}

より詳細な使用例はSurface Graph Galleryを参照してください。

Surface3DSeries,ItemModelSurfaceDataProxy,Bars3D,Scatter3D,Qt Graphs C++ Classes for 3Dも参照してください 。

プロパティ・ドキュメンテーション

ambientLightStrength : real

グラフ全体の環境光の強さ。この値によって、光の位置に関係なく、グラフ全体の色がどれだけ均等に明るく表示されるかが決まります。値は0.0 から1.0 の間でなければなりません。

aspectRatio : real

水平面上の最長軸と y 軸の間のグラフのスケー リ ングの比率。デフォルトは2.0 。

注意: Bars3D には影響しません。

horizontalAspectRatioも参照してください 。

axisX : Value3DAxis

アクティブなX軸。

軸が与えられない場合、ラベルと自動調整範囲を持たない一時的なデフォルト軸が作成される。この一時的な軸は、他の軸が明示的に同じ方向に設定されると破棄される。

axisY : Value3DAxis

アクティブなY軸。

軸が与えられない場合、ラベルと自動調整範囲を持たない一時的なデフォルト軸が作成される。この一時的な軸は、他の軸が明示的に同じ方向に設定されると破棄されます。

axisZ : Value3DAxis

アクティブなZ軸。

軸が与えられない場合、ラベルと自動調整範囲を持たない一時的なデフォルト軸が作成される。この一時的な軸は、他の軸が明示的に同じ方向に設定されると破棄される。

cameraPreset : Graphs3D.CameraPreset

現在アクティブなカメラのプリセットで、Graphs3D.CameraPreset のいずれかです。 プリセットがアクティブでない場合、値はGraphs3D.CameraPreset.NoPreset です。

cameraTargetPosition : vector3d

ベ ク ト ル3d としてのカ メ ラ タ ーゲ ッ ト 。デフ ォル ト はvector3d(0.0, 0.0, 0.0) です。

有効な座標値は-1.0...1.0 の間です。 こ こ で端の値は、 対応する軸範囲の端を示 し ます。こ の範囲外の値は、 その端に ク ラ ンプ さ れます。

cameraXRotation : real

現在の基準位置を起点とした、目標点を中心としたカメラのX回転角度（度単位）。

cameraYRotation : real

現在の基準位置を起点とした、目標点を中心としたカメラのY回転角度（度単位）。

cameraZoomLevel : real

カメラのズーム・レベルをパーセンテージで指定します。デフォルト値の100.0 は、カメラにズームインまたはズームアウトが設定されていないことを意味します。この値はminCameraZoomLevel およびmaxCameraZoomLevel プロパティによって制限されます。

minCameraZoomLevel およびmaxCameraZoomLevelも参照してください 。

currentFps : int

FPS測定が有効な場合、最後の1秒間の測定結果がこの読み取り専用プロパティに格納されます。測定が有効になってからこの値が更新されるまで、少なくとも1秒かかります。

measureFpsも参照してください 。

customItemList : list<Custom3DItem>

グラフに追加されたCustom3DItem アイテムのリスト。グラフは追加された項目の所有権を持つ。

cutoffMargin : real [since 6.11]

軸の限界とグラフ要素がカリングされる位置の差に使用される値。

注： 棒グラフには影響しません。

このプロパティは Qt 6.11 で導入されました。

flipHorizontalGrid : bool

使用例によっては、水平軸グリッドがほとんど表面に覆われているため、水平軸グリッドをグラフの下部ではなく上部に表示した方が便利な場合がある。典型的な使用例としては、トップダウン視点のオルソグラフィック投影を使った2Dスペクトログラムの表示がある。

false の場合、横軸グリッドとラベルはグラフの水平背景に描画される。true の場合、横軸グリッドとラベルは、グラフの水平背景とは反対側に描画される。デフォルトはfalse 。

gridLineType : Graphs3D.GridLineType

グ リ ッ ド 線の タ イ プがGraphs3D.GridLineType.Shader かGraphs3D.GridLineType.Geometry かを定義 し ます。

こ の値はすべてのグ リ ッ ド 線に影響を与え ます。

Graphs3D.GridLineTypeも参照。

horizontalAspectRatio : real

X軸とZ軸の間のグラフのスケーリングの比率。値0.0 は、軸範囲に従った自動スケーリングを示す。デフォルトは0.0 。

注： barThickness およびbarSpacing プロパティによって水平面のスケーリングを扱うBars3D には影響しません。極座標グラフもこのプロパティを無視します。

aspectRatio,polar,Bars3D::barThickness, およびBars3D::barSpacingも参照してください 。

labelMargin : real

このプロパティは、軸ラベルの配置のマージンを指定する。

負の値はラベルをプロット領域内に配置し、正の値はラベルをプロット領域外に配置する。値が負の場合、ラベルの自動回転は無効になる。デフォルトは0.1

QAbstract3DAxis::labelAutoAngleも参照 。

lightColor : color

Scene3D で定義された環境光と鏡面光の色。

lightStrength : real

グラフ全体の鏡面光強度。値は0.0 と10.0 の間でなければなりません。

この値はScene3D で指定した光に影響します。

locale : locale

さまざまな数値ラベルの書式設定に使用するロケールを設定する。デフォルトは"C" ロケールである。

Value3DAxis::labelFormatも参照のこと 。

margin : real

プロット可能なグラフ領域の端とグラフの背景の端の間に残されたスペースに使用される絶対値。

marginの値が負の場合、marginは自動的に決定され、系列のアイテムのサイズやグラフのタイプによって変化する。グラフのアスペクト比がデフォルト値から変更されていない場合、値はY軸範囲の分数として解釈される。デフォルトは-1.0 。

注： 散布図グラフの余白を自動的に決定される余白よりも小さく設定すると、グラフの端の散布図項目がグラフの背景と重なることがあります。

注： 散布図とサーフェスグラフでは、軸ラベルのサイズに比べてマージンが小さい場合、軸のエッジラベルの位置は隣の軸のエッジラベルと重ならないように調整されます。

maxCameraXRotation : real [since 6.9]

ターゲットポイント周りのカメラの最大X回転角度（度）。デフォルト値は180.0

このプロパティは Qt 6.9 で導入されました。

maxCameraYRotation : real [since 6.9]

目標点を中心としたカメラの最大Y回転角度（度）。デフォルト値は90.0

このプロパティは Qt 6.9 で導入されました。

maxCameraZoomLevel : real

カメラのズーム・レベルの最大許容値を設定します。新しい最大レベルが既存の最小レベルより低い場合、最小レベルも新しい最大レベルに調整されます。現在のcameraZoomLevel が新しい範囲外の場合、同様に調整されます。デフォルトは500.0f です。

cameraZoomLevel およびminCameraZoomLevelも参照してください 。

measureFps : bool

true の場合、レンダリングはオンデマンドではなく連続的に行われ、currentFps プロパティの値が更新される。デフォルトはfalse です。

currentFpsも参照してください 。

minCameraXRotation : real [since 6.9]

ターゲットポイント周りのカメラの最小X回転角度（度）。デフォルト値は-180.0

このプロパティは Qt 6.9 で導入されました。

minCameraYRotation : real [since 6.9]

ターゲットポイント周りのカメラの最小Y回転角度（度）。デフォルト値は0.0

このプロパティは Qt 6.9 で導入されました。

minCameraZoomLevel : real

カメラのズーム・レベルの最小許容値を設定します。新しい最小レベルが既存の最大レベルより高い場合、最大レベルも新しい最小レベルに調整されます。現在のcameraZoomLevel が新しい範囲外の場合、同様に調整されます。minCameraZoomLevel を1.0 以下に設定することはできません。デフォルトは10.0 。

cameraZoomLevel およびmaxCameraZoomLevelも参照 。

msaaSamples : int

renderingMode がIndirect のとき、マルチサンプルアンチエイリアシングで使用されるサンプル数。renderingMode がDirectToBackground の場合、 こ のプ ロ パテ ィ 値は読み取 り 専用で、 ウ ィ ン ド ウ 表面形式で指定 さ れたサンプル数を返す。デフォルトは4 です。

renderingModeも参照してください 。

optimizationHint : Graphs3D.OptimizationHint

レンダリングの最適化にデフォルトモードとレガシーモードのどちらを使用するかを指定します。

デフォルト・モードはインスタンス化されたレンダリングを使用し、ほとんどのシステムで最高レベルのパフォーマンスで全機能を提供します。静的モードはグラフ描画を最適化し、変化のない大規模なデータセットに最適です。動的なデータの変化やアイテムの回転があると遅くなります。選択は最適化されないため、大規模なデータセットで静的モードを使用することはお勧めできません。レガシーモードは、インスタンス化せずに、グラフ内のすべての項目を個別にレンダリングします。これは、デフォルト・モードが機能しない場合にのみ使用されるべきで、ターゲット・システムがインスタンス化をサポートしていない場合と同じです。デフォルトはDefault 。

注意： 環境によっては、静的最適化を使用した大きなグラフが描画されないことがあります。これは、すべてのアイテムが1回の描画呼び出しで描画されるためで、グラフィックドライバによって、呼び出しごとにサポートされる最大頂点数が異なるからです。これは主に32ビットおよびOpenGL ES2プラットフォームでの問題です。この問題を回避するには、頂点数の少ないアイテムメッシュを選択するか、ポイントメッシュを使用します。

Abstract3DSeries::mesh およびGraphs3D.OptimizationHintも参照して ください。

orthoProjection : bool

true の場合、グラフの表示に正射投影が使用される。デフォルトはfalse です。

注： true に設定すると、影は無効になります。

polar : bool

true の場合、横軸は極軸に変わる。x軸は角度軸になり、z軸は半径軸になる。棒グラフでは極軸モードは利用できない。

デフォルトはfalse 。

orthoProjection およびradialLabelOffsetも参照 。

queriedGraphPosition : vector3d [read-only]

この読み取り専用プロパティには、Scene3D::graphPositionQuery を使用してクエリされた各軸に沿った最新のグラフ位置値が含まれる。値は[-1, 1] の範囲に正規化される。クエリされた位置がグラフ境界の外側であった場合、値は実際の位置を反映せず、代わりに範囲[-1, 1] の外側の未定義の位置となります。この値は、問い合わせが行われるまで未定義となる。

特定の画面位置に一致する唯一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む不可視のボックスの内側に対して行われます。

注： 棒グラフでは、グラフのフロアレベルでしかグラフの位置を問い合わせることができないため、棒グラフではy値は常に0であり、有効な問い合わせはグラフのフロアを含む画面位置でのみ行うことができます。

Scene3D::graphPositionQueryも参照のこと 。

radialLabelOffset : real

このプロパティは、半径極軸の軸ラベルの正規化された水平オフセットを指定する。値0.0 は、ラベルが0角度の角度軸グリッド線の隣に描画されることを示す。値1.0 は、ラベルがグラフ背景の端の通常の場所に描画されることを示す。このプロパティは、polar プロパティ値がfalse の場合は無視されます。デフォルトは1.0 。

polarも参照してください 。

renderingMode : Graphs3D.RenderingMode

グラフのレンダリング方法。デフォルトはIndirect 。

注: グラフのantialiasing プロパティを設定しても何も起こりません。ただし、現在のレンダリングモードでアンチエイリアスが使用されている場合は、グラフ自体で設定されます。

msaaSamples およびGraphs3D.RenderingModeも参照してください 。

rootNode : Node [read-only, since 6.9]

3D グラフのルート・ノードへのポインタを返す。このプロパティは、importScene を使用して、3D グラフを別のView3D にインジェクトする場合に使用します：

Bars3D {
  id: bars
}
View3D {
  importScene: bars.rootNode
}

このプロパティは Qt 6.9 で導入されました。

View3Dも参照して ください。

rotationEnabled : bool

こ の入力ハン ド ラ がグ ラ フ回転を許すかど う か。

デフォルトはtrue 。

scene : Scene3D [read-only]

シーンの操作やシーンエレメントへのアクセスに使用できるScene3D ポインタ。

このプロパティは読み取り専用です。

selectedElement : Graphs3D.ElementType [read-only]

グラフ内で選択されている要素。

このプロパティを使用して、選択された要素のタイプを問い合わせることができます。このタイプは、グラフ内で新しい選択が行われ、selectedElementChanged シグナルが発信されるまで有効です。

このシグナルは、例えば、カスタマイズされた入力処理を実装するために使用することができます。

selectedLabelIndex(),selectedAxis(),selectedCustomItemIndex(),selectedCustomItem(),Bars3D::selectedSeries,Scatter3D::selectedSeries,Scene3D::selectionQueryPosition,Graphs3D.ElementTypeも参照のこと 。

selectedSeries : Surface3DSeries [read-only]

選択された系列または null。selectionMode にMultiSeries フラグが設定されている場合、このプロパティは選択されたポイントを所有する系列を保持します。

selectionEnabled : bool

この入力ハンドラがグラフからの選択を許可するかどうか。

デフォルトはtrue 。

selectionMode : Graphs3D.SelectionMode

グラフのアクティブな選択モード。Graphs3D.SelectionFlag 列挙値のいずれか。

seriesList : list<Surface3DSeries> [default]

このプロパティはグラフの系列を保持する。デフォルトでは、このプロパティには空のリストが含まれます。系列を設定するには、addSeries() 関数を使用するか、グラフの子として定義します。

shadowQuality : Graphs3D.ShadowQuality

影の質。Graphs3D.ShadowQuality enum 値の1つ。

shadowStrength : real

グラフ全体の影の強さ。数値が大きいほど影が濃くなります。値は0.0 と100.0 の間でなければなりません。

この値はScene3D で指定した光に影響します。

theme : GraphsTheme

グラフのアクティブテーマ。

GraphsThemeも参照のこと 。

transparencyTechnique : Graphs3D.TransparencyTechnique [since 6.9]

どの透過技法を使 う か を指定 し ます。デフ ォル ト 値はDefault です。透明なサーフェスグラフをレンダリングする場合は、Approximate またはAccurate を使用してください。 その他のグラフタイプにはDefault を使用してください。

定数説明
Default順序に依存 し ない透過技法を用いない こ と を示 し ます。最高のパフォーマンスを提供します。グラフに透明度が含まれていないとき、または棒グラフや散布図がインスタンス化も使用しているときに使用します（optimizationHint は {QtGraphs3D::OptimizationHint::Default}）。
Approximateグラフが次数に依存しない透明度の近似を試みることを示す。こ の方式はAccurate よ り も高速で、 古いハー ド ウ ェ ア上でも動作 し ますが、 不正確な結果を も た ら す可能性があ り ます。次数に依存しない透明性が必要だが、正確な次数に依存しない透明性を使用する場合よりも性能コストを低くしなければならない場合に使用する。
Accurate正確な順序に依存しない透明度を使用することを示します。完全な透明度のレンダリングが必要な場合に使用します。

このプロパティは Qt 6.9 で導入されました。

wrapCameraXRotation : bool

Xローテーションにおける最小値と最大値の制限の動作。デフォルトでは、X 回転は最小値から最大値へ、最大値から最小値へと折り返されます。

true に設定すると、カメラの X 回転は最小値から最大値へ、最大値から最小値へと折り返されます。false に設定すると、カメラの X 回転は最小値と最大値で決定されるセクタに制限されます。

wrapCameraYRotation : bool

Y-ローテーションにおける最小値と最大値の制限の動作。デフォルトでは、Y 回転は折り返されることなく最小値と最大値の間で制限されます。

true の場合、カメラの Y 回転は最小値から最大値へ、最大値から最小値へと折り返されます。false の場合、カメラの Y 回転は、最小値と最大値によって決定されるセクタに制限されます。

zoomAtTargetEnabled : bool

グ ラ フ のズーム さ れた位置が、 ズーム後 も同 じ 位置に留ま る よ う に、 ズーム時にカ メ ラ タ ーゲ ッ ト を変更するかど う か。

デフォルトはtrue 。

zoomEnabled : bool

この入力ハンドラがグラフのズームを許すかどうか。

デフォルトはtrue 。

シグナルのドキュメント

axisXChanged(ValueAxis3D axis)

このシグナルは、axisX がaxis に変更されたときに発せられる。

注： 対応するハンドラはonAxisXChanged 。

axisYChanged(ValueAxis3D axis)

このシグナルは、axisY がaxis に変更されたときに発せられる。

注： 対応するハンドラはonAxisYChanged 。

axisZChanged(ValueAxis3D axis)

このシグナルは、axisZ がaxis に変更されたときに発せられる。

注： 対応するハンドラはonAxisZChanged 。

doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)

このシグナルは、グラフ・アイテムが短い時間内に2回タップされたときに発せられる。eventPoint シグナル・パラメータには、タップされたポイントに関するリリース・イベントの情報が含まれ、button はクリックされたmouse button で、タッチスクリーンではNoButton です。

注： 対応するハンドラはonDoubleTapped です。

QEventPoint 、Qt::MouseButtons 、TapHandler::doubleTappedも参照のこと 。

dragged(QVector2D delta)

このシグナルは、ピンチ・ジェスチャーが実行されている間に、グラフ上の点群の並進が変更されたときに発せられます。delta ベクトルは並進の変化を示します。

注： 対応するハンドラはonDragged です。

PinchHandler::translationChangedも参照してください 。

flipHorizontalGridChanged(bool flip)

このシグナルは、flipHorizontalGrid がflip に変更されたときに発せられる。

注： 対応するハンドラはonFlipHorizontalGridChanged 。

longPressed()

このシグナルは、parent アイテムが押され、TapHandler::longPressThreshold を超える時間保持されたときに発せられる。

注： 対応するハンドラはonLongPressed 。

TapHandler::longPressedも参照 。

mouseMove(QPoint mousePos)

このシグナルは、グラフが mouseMove イベントを受信したときに発せられる。mousePos 値は、マウスが移動している間のマウスの位置を示す。

注： 対応するハンドラはonMouseMove です。

QQuickItem::mouseMoveEventも参照してください 。

pinch(qreal delta)

このシグナルは、ピンチ・ジェスチャーの実行中にグラフのスケール・ファクターが変化したときに発せられます。delta の値は、スケールの乗法的な変化を示します。

注: 対応するハンドラはonPinch です。

PinchHandler::scaleChangedも参照してください 。

selectedSeriesChanged(Surface3DSeries series)

このシグナルは、selectedSeries がseries に変更されたときに発せられる。

注： 対応するハンドラはonSelectedSeriesChanged 。

tapped(QEventPoint eventPoint, Qt::MouseButton button)

このシグナルは、グラフ・アイテムが一度タップされたときに発せられる。eventPoint シグナルパラメータには、タップされたポイントに関するリリースイベントの情報が含まれ、button はクリックされたmouse button で、タッチスクリーンの場合はNoButton です。

注： 対応するハンドラはonTapped です。

QEventPoint 、Qt::MouseButtons 、TapHandler::singleTappedも参照のこと 。

wheel(QQuickWheelEvent *event)

このシグナルは、グラフがQWheelEvent 型のevent を受け取るたびに発行されます。つまり、ホイールが動かされたり、スクロールジェスチャが更新されたりするたびに発行されます。

注: 対応するハンドラはonWheel です。

WheelEvent およびWheelHandler::wheelも参照して ください。

メソッド・ドキュメント

qsizetype addCustomItem(Custom3DItem item)

Custom3DItem item をグラフに追加する。グラフは追加されたアイテムの所有権を持つ。

add が成功した場合は追加されたアイテムのインデックスを返し、null アイテムを追加しようとした場合は -1、既に追加されたアイテムを追加しようとした場合はそのアイテムのインデックスを返します。

removeCustomItems()、removeCustomItem()、removeCustomItemAt()も参照のこと 。

void addSeries(Surface3DSeries series)

グラフにseries を追加する。

GraphsItem3D::hasSeries()も参照 。

void clearSelection()

すべての付属シリーズからの選択をクリアする。

void doPicking(QPoint point)

グラフの要素にpoint からビュー座標を使用してピッキングを実行し、最初にヒットしたアイテムを選択します。デフォルトの入力処理は、onTapped イベントを受信したときにこれを実行します。

selectedElementも参照してください 。

void doRayPicking(QVector3D origin, QVector3D direction)

グラフの要素に対して、origin とdirection から始まるピッキングを実行し、最初にヒットした項目を選択する。

selectedElementも参照 。

bool hasSeries(Abstract3DSeries series)

series がすでにグラフに追加されているかどうかを返す。

void releaseCustomItem(Custom3DItem item)

item の所有権を取り戻し、グラフからitem を削除する。

注意： 同じアイテムをグラフに追加する場合は、テクスチャファイルを再設定する必要があります。

Custom3DItem::textureFileも参照してください 。

void removeCustomItem(Custom3DItem item)

カスタムitem を削除します。割り当てられたリソースを削除します。

void removeCustomItemAt(vector3d position)

position にあるすべてのカスタムアイテムを削除する。それらに割り当てられているリソースを削除します。

void removeCustomItems()

すべてのカスタム項目を削除します。それらに割り当てられているリソースを削除します。

void removeSeries(Surface3DSeries series)

グラフからseries を削除する。

GraphsItem3D::hasSeries()も参照 。

void removeSeries(Surface3DSeries series)

グラフからseries を削除する。

GraphsItem3D::hasSeries()も参照 。

[since 6.10] void renderSliceToImage(int index, int requestedIndex, QtGraphs3D::SliceCaptureType sliceType, QUrl filePath)

index にあるシリーズから2次元スライスをエクスポートし、指定したfilePath にある画像に結果を保存する。すべての系列をエクスポートするには、index を -1 に設定する。エクスポートされるスライスには、行または列の行が含まれます。これは、指定されたrequestedIndex のsliceType で定義されます。

このメソッドは Qt 6.10 で導入されました。

Abstract3DAxis selectedAxis()

任意のラベルタイプでselectedElementChanged 信号を受信した後に、選択された軸を取得するために使用できる。選択は、次のselectedElementChanged 信号まで有効である。

選択された軸、 またはNULL を返す。

selectedElementも参照してください 。

Custom3DItem selectedCustomItem()

ElementType.CustomItem タイプでselectedElementChanged シグナルを受信した後、選択されたカスタム項目を取得するために使用できます。アイテムの所有権はグラフに残ります。選択は、次のselectedElementChanged シグナルまで有効です。

選択されたカスタム項目、または null を返します。

selectedElementも参照してください 。

qsizetype selectedCustomItemIndex()

ElementType.CustomItem タイプでselectedElementChanged シグナルを受信した後、選択されたカスタム項目のインデックスを照会するために使用できる。選択は次のselectedElementChanged シグナルまで有効である。

選択されたカスタム項目のインデックス、または -1 を返します。

selectedElementも参照 。

int selectedLabelIndex()

任意のラベルタイプでselectedElementChanged シグナルを受信した後、選択されたラベルのインデックスを問い合わせるために使用できる。選択は次のselectedElementChanged シグナルまで有効である。

選択されたラベルのインデックス、または -1 を返す。

selectedElementも参照 。

void setDefaultInputHandler()

* @brief デフォルトの入力処理メカニズムを復元する。* このメソッドは、あらかじめ定義された内部入力ハンドラを再活性化します。* 以前に *unsetDefaultInputHandler を呼び出した後、デフォルトの動作に戻す場合に使用します。*

unsetDefaultInputHandler()も参照のこと 。

void setDragButton(Qt::MouseButtons button)

* @brief ドラッグイベントのトリガーに使用するマウスボタンを設定する。* このメソッドは、ドラッグ操作を開始するために必要なマウスボタンをbutton に変更することができます。* デフォルトはQt::RightButton 。

void unsetDefaultDragHandler()

* デフォルトのドラッグイベントハンドラを無効にします。* これは特に、ドラッグジェスチャーに対する組み込みのレスポンスを無効にします。* ドラッグ用のカスタムハンドラを実装する必要がある場合は、これを使用してください。*

unsetDefaultInputHandler()も参照してください 。

void unsetDefaultInputHandler()

* @brief デフォルトの入力処理機構を無効にします。* このメソッドは、あらかじめ定義されたすべてのデフォルトの入力ハンドラを無効にします。* デフォルトの動作をオーバーライドする場合は、このメソッドを呼び出します。*

unsetDefaultTapHandler(),unsetDefaultDragHandler(),unsetDefaultWheelHandler(),unsetDefaultPinchHandler()も参照 。

void unsetDefaultPinchHandler()

* @brief デフォルトのピンチ・ジェスチャー・ハンドラを無効にします。* これは特に、ピンチ・ジェスチャーに対する組み込みのレスポンスを無効にします。* カスタムのピンチ・ジェスチャー・ハンドラを実装する場合は、これを使用してください。*

unsetDefaultInputHandler()も参照してください 。

void unsetDefaultTapHandler()

* デフォルトのタップ・イベント・ハンドラを無効にします。* 特に、タップやクリックイベントに対する組み込みのレスポンスを解除し、 * タップ処理ロジックをカスタマイズできるようにします。*

unsetDefaultInputHandler()も参照してください 。

void unsetDefaultWheelHandler()

* デフォルトのマウスホイールイベントハンドラを無効にする。* これは特に、マウスホイールのスクロールに対する組み込みの応答を解除します。* カスタムのホイール動作を実装する場合に使用します。*

unsetDefaultInputHandler()も参照してください 。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.