GraphsItem3D QML Type

3D 그래프의 기본 유형. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록
• GraphsItem3D는 3D용 QML 유형인 ‘Qt Graphs ’의 일부입니다.

속성

• ambientLightStrength : real
• aspectRatio : real
• cameraPreset : Graphs3D.CameraPreset
• cameraTargetPosition : vector3d
• cameraXRotation : real
• cameraYRotation : real
• cameraZoomLevel : real
• currentFps : int
• customItemList : list<Custom3DItem>
• cutoffMargin : real (since 6.11)
• dragMode : Graphs3D.DragMode (since 6.12)
• gridLineType : Graphs3D.GridLineType
• horizontalAspectRatio : real
• labelMargin : real
• lightColor : color
• lightStrength : real
• locale : locale
• margin : real
• maxCameraXRotation : real (since 6.9)
• maxCameraYRotation : real (since 6.9)
• maxCameraZoomLevel : real
• measureFps : bool
• minCameraXRotation : real (since 6.9)
• minCameraYRotation : real (since 6.9)
• minCameraZoomLevel : real
• msaaSamples : int
• optimizationHint : Graphs3D.OptimizationHint
• orthoProjection : bool
• panEnabled : bool (since 6.12)
• polar : bool
• queriedGraphPosition : vector3d
• radialLabelOffset : real
• renderingMode : Graphs3D.RenderingMode
• rootNode : Node (since 6.9)
• rotationEnabled : bool
• scene : Scene3D
• selectedElement : Graphs3D.ElementType
• selectionEnabled : bool
• selectionMode : Graphs3D.SelectionMode
• shadowQuality : Graphs3D.ShadowQuality
• shadowStrength : real
• theme : GraphsTheme
• transparencyTechnique : Graphs3D.TransparencyTechnique (since 6.9)
• wrapCameraXRotation : bool
• wrapCameraYRotation : bool
• zoomAtTargetEnabled : bool
• zoomEnabled : bool

신호

• doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)
• dragged(QVector2D delta)
• longPressed()
• mouseMove(QPoint mousePos)
• pinch(qreal delta)
• tapped(QEventPoint eventPoint, Qt::MouseButton button)
• wheel(QQuickWheelEvent *event)

방법

• qsizetype addCustomItem(Custom3DItem item)
• void clearSelection()
• void doPicking(QPoint point)
• void doRayPicking(QVector3D origin, QVector3D direction)
• bool hasSeries(Abstract3DSeries series)
• void releaseCustomItem(Custom3DItem item)
• void removeCustomItem(Custom3DItem item)
• void removeCustomItemAt(vector3d position)
• void removeCustomItems()
• Abstract3DAxis selectedAxis()
• Custom3DItem selectedCustomItem()
• qsizetype selectedCustomItemIndex()
• int selectedLabelIndex()
• void setDefaultInputHandler()
• void setDragButton(Qt::MouseButtons button)
• void setPanButton(Qt::MouseButtons button) (since 6.12)
• void unsetDefaultDragHandler()
• void unsetDefaultInputHandler()
• void unsetDefaultPinchHandler()
• void unsetDefaultTapHandler()
• void unsetDefaultWheelHandler()

상세 설명

QtGraphs 의 모든 3D 그래프에 대한 생성 불가능한 기본 유형입니다.

Bars3D, Scatter3D, Surface3D 및 Qt Graphs 의 3D용 C++ 클래스도 참조하십시오 .

속성 설명서

ambientLightStrength : real

그래프 전체에 적용되는 주변광 강도입니다. 이 값은 빛의 위치와 관계없이 그래프 전체에 걸쳐 색상이 얼마나 균일하고 밝게 표시되는지를 결정합니다. 이 값은 0.0 과 1.0 사이의 범위여야 합니다.

aspectRatio : real

수평면상의 가장 긴 축과 y축 사이의 그래프 배율 비율입니다. 기본값은 2.0 입니다.

horizontalAspectRatio도 참조하십시오 .

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 ’입니다.

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`입니다.

Abstract3DSeries::mesh 및 Graphs3D.OptimizationHint도 참조하십시오 .

orthoProjection : bool

true 인 경우, 그래프 표시 시 직교 투영법이 사용됩니다. 기본값은 false 입니다.

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 좌표는 하나만 존재하는 것이 아니므로, 일관성을 유지하기 위해 쿼리는 항상 그래프를 둘러싼 보이지 않는 상자의 안쪽 면을 기준으로 수행됩니다.

Scene3D::graphPositionQuery도 참조하십시오 .

radialLabelOffset : real

이 속성은 방사형 극좌표축의 축 레이블에 대한 정규화된 수평 오프셋을 지정합니다. 값 0.0 은 레이블이 0각도의 각도 축 격자선 옆에 그려져야 함을 나타냅니다. 값 1.0 은 레이블이 그래프 배경의 가장자리에 있는 일반적인 위치에 그려져야 함을 나타냅니다. 이 속성은 polar 속성의 값이 false 인 경우 무시됩니다. 기본값은 1.0 입니다.

polar도 참조하십시오 .

renderingMode : Graphs3D.RenderingMode

그래프가 어떻게 렌더링될지 지정합니다. 기본값은 ‘ Indirect ’입니다.

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도 참조하십시오 .

selectionEnabled : bool

이 입력 핸들러가 그래프에서 항목을 선택할 수 있도록 허용하는지 여부.

기본값은 ` true`입니다.

selectionMode : Graphs3D.SelectionMode

그래프의 활성 선택 모드입니다. ` Graphs3D.SelectionFlag ` 열거형 값 중 하나입니다.

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 `을 사용해야 합니다.

이 속성은 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 문서

doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)

이 신호는 그래프 항목을 짧은 시간 내에 두 번 탭했을 때 발생합니다. ‘ eventPoint ’ 신호 매개변수에는 릴리스 이벤트에서 탭된 지점에 대한 정보가 포함되어 있으며, ‘ button ’는 클릭된 ‘ mouse button ’이거나 터치스크린의 경우 ‘ NoButton ’입니다.

또한 QEventPoint, Qt::MouseButtons 및 TapHandler::doubleTapped 을참조하십시오 .

dragged(QVector2D delta)

이 신호는 핀치 제스처를 수행하는 도중 그래프상의 점 집합의 평행 이동이 변경될 때 발생합니다. delta 벡터는 평행 이동의 변화를 나타냅니다.

PinchHandler::translationChanged도 참조하십시오 .

longPressed()

이 신호는 ‘ parent ’ 항목을 ‘ TapHandler::longPressThreshold ’보다 긴 시간 동안 길게 누르면 발생합니다.

TapHandler::longPressed도 참조하십시오 .

mouseMove(QPoint mousePos)

이 신호는 그래프가 mouseMove 이벤트를 수신할 때 발생합니다. ` mousePos ` 값은 마우스가 이동 중일 때의 위치를 나타냅니다.

QQuickItem::mouseMoveEvent도 참조하십시오 .

pinch(qreal delta)

이 신호는 핀치 제스처를 수행하는 도중 그래프의 배율 계수가 변경될 때 발생합니다. ` delta ` 값은 배율의 곱셈적 변화량을 나타냅니다.

PinchHandler::scaleChanged도 참조하십시오 .

tapped(QEventPoint eventPoint, Qt::MouseButton button)

이 신호는 그래프 항목을 한 번 탭했을 때 발생합니다. ‘ eventPoint ’ 신호 매개변수에는 릴리스 이벤트에서 탭된 지점에 대한 정보가 포함되어 있으며, ‘ button ’은 클릭된 ‘ mouse button ’이거나 터치스크린의 경우 ‘ NoButton ’입니다.

또한 QEventPoint, Qt::MouseButtons 및 TapHandler::singleTapped 을참조하십시오 .

wheel(QQuickWheelEvent *event)

이 신호는 그래프가 QWheelEvent 타입의 event 를 수신할 때마다, 즉 휠이 움직이거나 스크롤 제스처가 업데이트될 때마다 발생합니다.

WheelEvent 및 WheelHandler::wheel도 참조하십시오 .

메서드 설명

qsizetype addCustomItem(Custom3DItem item)

그래프에 ` Custom3DItem ` item 를 추가합니다. 그래프는 추가된 항목에 대한 소유권을 갖습니다.

추가에 성공한 경우 추가된 항목의 인덱스를 반환하고, null 항목을 추가하려고 시도한 경우 -1을, 이미 추가된 항목을 다시 추가하려고 시도한 경우 해당 항목의 인덱스를 반환합니다.

removeCustomItems(), removeCustomItem(), removeCustomItemAt()도 참조하십시오 .

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()

모든 사용자 정의 항목을 제거합니다. 해당 항목에 할당된 리소스를 삭제합니다.

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()도 참조하십시오 .