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

Bars3D QML Type

3D棒グラフ。詳細...

Import Statement: import QtGraphs
Inherits:

GraphsItem3D

プロパティ

信号

方法

詳細な説明

このタイプを使用すると、開発者はQt Quick を使用して3Dの棒グラフを描画できるようになります。

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

import QtGraphs

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

import QtQuick
import QtGraphs

Item {
    width: 640
    height: 480

    Bars3D {
        width: parent.width
        height: parent.height

        Bar3DSeries {
            itemLabelFormat: "@colLabel, @rowLabel: @valueLabel"

            ItemModelBarDataProxy {
                itemModel: dataModel
                // Mapping model roles to bar series rows, columns, and values.
                rowRole: "year"
                columnRole: "city"
                valueRole: "expenses"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ year: "2022"; city: "Oulu";     expenses: "4200"; }
        ListElement{ year: "2022"; city: "Rauma";    expenses: "2100"; }
        ListElement{ year: "2022"; city: "Helsinki"; expenses: "7040"; }
        ListElement{ year: "2022"; city: "Tampere";  expenses: "4330"; }
        ListElement{ year: "2023"; city: "Oulu";     expenses: "3960"; }
        ListElement{ year: "2023"; city: "Rauma";    expenses: "1990"; }
        ListElement{ year: "2023"; city: "Helsinki"; expenses: "7230"; }
        ListElement{ year: "2023"; city: "Tampere";  expenses: "4650"; }
    }
}

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

関連項目として、 Bar3DSeries 、ItemModelBarDataProxy 、Scatter3D 、Surface3D 、およびQt Graphs の3D用C++クラスも参照してください 。

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

ambientLightStrength : real

グラフ全体の周囲の光の強度です。この値によって、光の位置に関係なく、グラフ全体で色がどれほど均一かつ明るく表示されるかが決まります。値は、0.0 から1.0 の範囲で指定する必要があります。

aspectRatio : real

水平面上の最長軸とy軸との間のグラフの拡大縮小比率です。デフォルトは2.0 です。

注： Bars3D には影響しません 。

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

barSeriesMargin : size

X軸およびZ軸方向の系列列間の余白。デフォルトでは(0.0, 0.0) に設定されています。適切な値は[0,1)の範囲内です。

barSpacing : size

X軸およびZ軸方向のバー間隔。

デフォルトでは(1.0, 1.0) にプリセットされています。間隔はbarSpacingRelative プロパティの影響を受けます。

barSpacingRelative : bool

間隔が絶対値か、それともバーの太さに対する相対値か。

true の場合、0.0 の値はバーが隣り合わせに配置されることを意味し、1.0 はバーの間にバー1本分の幅のスペースが空くことを意味します。初期設定はtrue です。

barThickness : real

X方向とZ方向のバーの厚さの比率。値が1.0 の場合、バーの幅と深さが同じであることを意味し、0.5 の場合は、幅の2倍の深さになることを意味します。

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

columnAxis : Category3DAxis

アクティブな列軸。

軸が指定されていない場合、ラベルのない一時的なデフォルトの軸が作成されます。この一時的な軸は、別の軸が明示的に同じ向きに設定されると破棄されます。

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

floorLevel : real

Y軸のデータ座標における棒グラフの床面の高さ。

実際の下限値は、Y軸の最小値および最大値によって制限されます。デフォルトは0です。

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

multiSeriesUniform : bool

複数の系列が表示されている場合でも、単一の系列の棒グラフに設定された比率に基づいて、すべての棒グラフのスケールを調整するかどうかを指定します。true に設定した場合、bar spacing はX軸に対してのみ正しく適用されます。デフォルトではfalse に設定されています。

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

primarySeries : Bar3DSeries

グラフのプライマリ・シリーズです。軸のラベルが明示的に設定されていない場合、行軸および列軸のラベルを決定するために使用されます。

指定された系列がまだグラフに追加されていない場合、これをプライマリ系列として設定すると、暗黙的にグラフに追加されます。

プライマリ・シリーズ自体がグラフから削除された場合、このプロパティはデフォルト値にリセットされます。

シリーズが null の場合、このプロパティはデフォルト値にリセットされます。デフォルトは、最初に追加されたシリーズ、またはグラフにシリーズが追加されていない場合は 0 です。

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

rowAxis : Category3DAxis

アクティブな行軸。

軸が指定されていない場合、ラベルのない一時的なデフォルトの軸が作成されます。この一時的な軸は、別の軸が明示的に同じ向きに設定されると破棄されます。

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 : Bar3DSeries [read-only]

選択されたシリーズ、またはnull 。selectionMode にSelectionMultiSeries フラグが設定されている場合、このプロパティには、選択されたバーを所有するシリーズが格納されます。

selectionEnabled : bool

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

デフォルトはtrue です。

selectionMode : Graphs3D.SelectionMode

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

seriesList : list<Bar3DSeries> [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 で導入されました。

valueAxis : ValueAxis3D

アクティブな値軸。

軸が指定されていない場合、ラベルがなく、範囲が自動的に調整される一時的なデフォルトの軸が作成されます。この一時的な軸は、別の軸が明示的に同じ向きに設定されると破棄されます。

wrapCameraXRotation : bool

X回転における最小値と最大値の挙動。デフォルトでは、X回転は最小値から最大値へ、そして最大値から最小値へとループします。

true に設定すると、カメラのX回転は最小値から最大値へ、そして最大値から最小値へとループします。false に設定すると、カメラのX回転は最小値と最大値によって決定されるセクター内に制限されます。

wrapCameraYRotation : bool

Y回転における最小値と最大値の挙動。デフォルトでは、Y回転は最小値と最大値の範囲内で制限され、ループ（ラップ）は発生しません。

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

zoomAtTargetEnabled : bool

ズーム操作を行った際、グラフのズーム対象点がズーム後も元の位置に留まるように、カメラのターゲットを変更するかどうか。

デフォルトはtrue です。

zoomEnabled : bool

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

デフォルトはtrue です。

Signal ドキュメント

barSeriesMarginChanged(size margin)

このシグナルは、barSeriesMargin がmargin に変更されたときに発せられます。

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

barSpacingChanged(size spacing)

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

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

barSpacingRelativeChanged(bool relative)

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

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

barThicknessChanged(real thicknessRatio)

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

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

columnAxisChanged(Category3DAxis axis)

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

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

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

floorLevelChanged(real level)

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

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

longPressed()

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

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

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

mouseMove(QPoint mousePos)

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

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

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

multiSeriesUniformChanged(bool uniform)

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

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

pinch(qreal delta)

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

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

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

primarySeriesChanged(Bar3DSeries series)

このシグナルは、primarySeries がseries に変化したときに発せられます。

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

rowAxisChanged(Category3DAxis axis)

このシグナルは、rowAxis がaxis に変更されたときに発信されます。

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

selectedSeriesChanged(Bar3DSeries series)

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

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

tapped(QEventPoint eventPoint, Qt::MouseButton button)

このシグナルは、グラフアイテムが1回タップされたときに発火します。eventPoint シグナルパラメータには、タップされたポイントに関するリリースイベントからの情報が含まれており、button はクリックされたmouse button 、またはタッチスクリーン上ではNoButton を指します。

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

関連項目： QEventPoint 、Qt::MouseButtons 、およびTapHandler::singleTapped 。

valueAxisChanged(ValueAxis3D axis)

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

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

wheel(QQuickWheelEvent *event)

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

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

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

メソッドのドキュメント

qsizetype addCustomItem(Custom3DItem item)

Custom3DItem item をグラフに追加します。グラフは追加された項目の所有権を取得します。

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

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

void addSeries(Bar3DSeries 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 insertSeries(int index, Bar3DSeries series)

series を、シリーズ一覧のindex の位置に挿入します。series がすで一覧に追加されている場合は、新しいindex の位置に移動されます。

注： シリーズを、元のインデックスよりも後の新しいindex に移動する場合 、リスト内での新しい位置は、シリーズが依然として元のインデックスにあるかのように計算されるため、最終的なインデックスは実際にはindex から1を引いた値となります。

関連項目： GraphsItem3D::hasSeries()。

void releaseCustomItem(Custom3DItem item)

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

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

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

void removeCustomItem(Custom3DItem item)

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

void removeCustomItemAt(vector3d position)

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

void removeCustomItems()

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

void removeSeries(Bar3DSeries series)

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

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

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

requestedIndex にあるシリーズから 2D スライスをエクスポートし、結果を指定されたfilePath に画像として保存します。エクスポートされたスライスには、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` です。

[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.