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

Scatter3D QML Type

3D散布図。詳細...

Import Statement: import QtGraphs
Inherits:

GraphsItem3D

プロパティ

信号

方法

詳細な説明

このタイプを使用すると、開発者はQt Quick を使用して3Dの散布図を描画できます。

このタイプを使用するには、Qt Graphs モジュールをインポートする必要があります:

import QtGraphs

その後、qmlファイル内でScatter3Dを使用できるようになります：

import QtQuick
import QtGraphs

Item {
    width: 640
    height: 480

    Scatter3D {
        width: parent.width
        height: parent.height
        Scatter3DSeries {
            ItemModelScatterDataProxy {
                itemModel: dataModel
                // Mapping model roles to scatter series item coordinates.
                xPosRole: "xPos"
                yPosRole: "yPos"
                zPosRole: "zPos"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ xPos: "2.754"; yPos: "1.455"; zPos: "3.362"; }
        ListElement{ xPos: "3.164"; yPos: "2.022"; zPos: "4.348"; }
        ListElement{ xPos: "4.564"; yPos: "1.865"; zPos: "1.346"; }
        ListElement{ xPos: "1.068"; yPos: "1.224"; zPos: "2.983"; }
        ListElement{ xPos: "2.323"; yPos: "2.502"; zPos: "3.133"; }
    }
}

より詳細な使用例については、「Simple Scatter Graph」を参照してください。

Scatter3DSeries 、Spline3DSeries 、ScatterDataProxy 、Bars3D 、Surface3D 、およびQt Graphs といった 3D 用の C++ クラスも参照してください 。

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

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

カメラのターゲットをvector3dとして指定します。デフォルトは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 で導入されました。

dragMode : Graphs3D.DragMode [since 6.12]

グラフ上のドラッグイベントの解釈方法を指定します。Graphs3D.DragMode 列挙型の値のいずれかです。

デフォルトはGraphs3D.DragMode.Rotate です。

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

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

gridLineType : Graphs3D.GridLineType

グリッド線の種類を「Graphs3D.GridLineType.Shader 」にするか「Graphs3D.GridLineType.Geometry 」にするかを指定します。

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

「Graphs3D.GridLineType」も参照してください 。

horizontalAspectRatio : real

x軸とz軸のグラフのスケーリング比率です。0.0 を指定すると、軸の範囲に応じて自動的にスケーリングされます。デフォルトは0.0 です。

注： Bars3D には影響しません 。 は、barThickness およびbarSpacing プロパティを介して水平方向のスケーリングを処理します。また、極座標グラフではこのプロパティは無視されます。

関連項目： 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

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

マージン値が負の場合、マージンは自動的に決定され、系列内の項目のサイズやグラフの種類に応じて変動する可能性があります。グラフのアスペクト比がデフォルト値から変更されていない場合、この値は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 に設定すると、影の表示 は無効になります。

panEnabled : bool [since 6.12]

この入力ハンドラがグラフのパン操作を許可するかどうか。

デフォルト値はtrue です。

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

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 」信号が発信されるまで有効です。

このシグナルは、たとえば「Axis Handling」の例で示されているように、カスタマイズされた入力処理を実装するために使用できます。

selectedLabelIndex()、selectedAxis()、selectedCustomItemIndex()、selectedCustomItem()、Bars3D::selectedSeries 、Scatter3D::selectedSeries 、Scene3D::selectionQueryPosition 、およびGraphs3D.ElementTypeも参照してください 。

selectedSeries : Scatter3DSeries [read-only]

選択されたシリーズ、またはNULL。

selectionEnabled : bool

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

デフォルトはtrue です。

selectionMode : Graphs3D.SelectionMode

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

seriesList : list<Scatter3DSeries> [default]

このプロパティには、グラフのシリーズが格納されます。デフォルトでは、このプロパティには空のリストが含まれています。シリーズを設定するには、addSeries() メソッドを使用するか、グラフの子要素として定義してください。

shadowQuality : Graphs3D.ShadowQuality

影の品質。Graphs3D.ShadowQuality 列挙型の値の一つです。

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` です。

Signal ドキュメント

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」も参照してください 。

longPressed()

この信号は、「parent 」アイテムが、TapHandler::longPressThreshold より長い時間押し続けられたときに発せられます。

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

「TapHandler::longPressed」も参照してください 。

mouseMove(QPoint mousePos)

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

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

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

pinch(qreal delta)

このシグナルは、ピンチジェスチャーが実行されている最中にグラフのスケール係数が変更された際に発火します。delta の値は、スケールの乗法的な変化量を表します。

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

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

selectedSeriesChanged(Scatter3DSeries series)

このシグナルは、selectedSeries がseries に変更されたときに発生します。

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

tapped(QEventPoint eventPoint, Qt::MouseButton button)

このシグナルは、グラフアイテムが1回タップされたときに発火します。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 をグラフに追加します。追加された項目の所有権はグラフが引き継ぎます。

追加に成功した場合は追加された項目のインデックスを返し、nullの項目を追加しようとした場合は-1を返し、すでに追加済みの項目を追加しようとした場合はその項目のインデックスを返します。

removeCustomItems()、removeCustomItem()、およびremoveCustomItemAt()も参照してください 。

void addSeries(Scatter3DSeries series)

series をグラフに追加します。グラフには複数の系列を含めることができますが、軸は1組のみです。新しく追加された系列に選択項目が指定されている場合、その項目が強調表示され、既存の選択は解除されます。アクティブな選択状態にある系列は、追加された系列のうち1つだけとなります。

「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(Scatter3DSeries series)

グラフからseries を取り除きます。

「GraphsItem3D::hasSeries()」も参照してください 。

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` です。

[since 6.12] void setPanButton(Qt::MouseButtons button)

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

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

void unsetDefaultDragHandler()

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

関連項目: unsetDefaultInputHandler().

void unsetDefaultInputHandler()

* * @brief デフォルトの入力処理メカニズムを無効にします。 * * このメソッドは、あらかじめ定義されているすべてのデフォルトの入力ハンドラを無効にします。 * デフォルトの動作を上書きしたい場合は、このメソッドを呼び出してください。 *

関連項目： unsetDefaultTapHandler()、unsetDefaultDragHandler()、unsetDefaultWheelHandler()、およびunsetDefaultPinchHandler()。

void unsetDefaultPinchHandler()

* * @brief デフォルトのピンチジェスチャーハンドラを無効にします。 * * これにより、ピンチジェスチャーに対する組み込みの反応が明示的に解除されます。 * カスタムピンチジェスチャーハンドラを実装する際にこれを使用してください。 *

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

void unsetDefaultTapHandler()

* * @brief デフォルトのタップイベントハンドラを無効にします。 * * これは、タップやクリックイベントに対する組み込みの応答を明示的に解除し、 * カスタムタップ処理ロジックを実装できるようにします。 *

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

void unsetDefaultWheelHandler()

* * @brief デフォルトのマウスホイールイベントハンドラを無効にします。 * * これは、マウスホイールによるスクロールに対する組み込みの反応を特に解除するものです。 * カスタムホイール動作を実装する際にこれを使用してください。 *

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.