Qt Quick QML Types

이 Qt Quick 이 모듈은 그래픽 기본 유형을 제공합니다. 이러한 유형은 해당 문서가 QtQuick 네임스페이스를 임포트한 경우에만 QML 문서에서 사용할 수 있습니다.

이 모듈을 사용하려면 다음 문장을 사용하여 QtQuick 모듈을 임포트하십시오:

import QtQuick

xml-ph-0000@deepl.internal의 핵심 개념에 대한 자세한 내용은 Qt QuickQtQuick 의 핵심 개념에 대한 자세한 내용은 모듈 문서를 참조하십시오.

하위 모듈

Qt Quick 에는 추가적인 타입을 포함하는 여러 하위 모듈이 포함되어 있습니다:

Local Storage - SQLite 데이터베이스용 JavaScript 인터페이스를 포함하는 서브모듈
Particles - QML 애플리케이션을 위한 파티클 시스템을 제공합니다
Controls - 재사용 가능한 UI 컴포넌트 모음을 제공합니다
Layouts - 사용자 인터페이스에서 항목을 배치하는 데 사용되는 타입을 포함합니다
Tests - QML 애플리케이션을 테스트하기 위한 타입들.
Effects - Qt Quick 항목에 하나 이상의 간단한 Graphical Effects를 적용하기 위한 타입을 제공합니다.
Shapes - Qt Quick 장면에서 벡터 도형을 렌더링하기 위한 타입을 제공합니다.
Vector Image - 벡터 이미지 파일을 표시하기 위한 타입을 제공합니다.

값 유형

QML 언어에서는 기본적으로 여러 가지 값 유형이 지원됩니다.

또한, ` QtQuick ` 임포트를 통해 다음과 같은 값 유형을 사용할 수 있습니다:

color	ARGB 색상 값
font	QFont의 속성을 가진 글꼴 값. 글꼴 유형은 QFont의 속성을 가진 글꼴 값을 의미합니다.
matrix4x4	matrix4x4 유형은 4행 4열의 행렬입니다.
quaternion	쿼터니언(quaternion) 유형은 스칼라, x, y, z 속성을 가집니다
vector2d	vector2d 유형은 x 및 y 속성을 가집니다
vector3d	x, y, z 속성을 가진 값
vector4d	vector4d 유형은 x, y, z 및 w 속성을 가집니다

객체 유형

QtQuick 임포트가 제공하는 대부분의 객체 유형은 Item 유형을 기반으로 하며, 이 유형은 QtObject 에서 파생됩니다. Qt Qml 모듈에서 제공하는 QML object types (예: QtObject 및 Component)도 QtQuick 를 임포트할 때 사용할 수 있습니다.

Accessible	QML 항목의 접근성 지원
AnchorAnimation	앵커 값의 변경을 애니메이션으로 표현합니다
AnchorChanges	상태에서 항목의 앵커를 변경하는 방법을 지정합니다
AnimatedImage	일련의 이미지로 저장된 애니메이션을 재생합니다
AnimatedSprite	스프라이트 애니메이션을 그립니다
Animation	모든 QML 애니메이션의 기반이 됩니다
AnimationController	애니메이션을 수동으로 제어할 수 있게 합니다
Animator	모든 QML 애니메이터의 기반이 됩니다
Application	많은 QML 컴포넌트가 공유하는 전역 애플리케이션 상태 속성에 대한 액세스를 제공합니다
Behavior	속성 변경에 대한 기본 애니메이션을 정의합니다
BorderImage	이미지를 기반으로 테두리를 그립니다
BorderImageMesh	BorderImage와 같은 방식으로 정점이 배열된 메쉬를 정의합니다
Canvas	JavaScript를 통해 그리기를 가능하게 하는 2D 캔버스 항목을 제공합니다
CanvasGradient	불투명한 CanvasGradient 인터페이스를 제공합니다
CanvasImageData	RGBA 순서로 이미지 픽셀 데이터를 포함합니다
CanvasPixelArray	이미지 데이터 내 각 픽셀의 구성 요소에 대한 순차적 및 인덱스 기반 액세스를 제공합니다
CloseEvent	창이 곧 닫힐 것임을 알리는 알림
Color	색상 관련 유틸리티 함수를 포함합니다
ColorAnimation	색상 값의 변화를 애니메이션으로 표현합니다
ColorGroup	역할별 색상 세트
Column	자식 요소를 열로 배치합니다
Context2D	Canvas 항목상의 도형에 2D 컨텍스트를 제공합니다
DoubleValidator	정수가 아닌 숫자에 대한 유효성 검사기를 정의합니다
Drag	이동된 항목에 대한 드래그 앤 드롭 이벤트 지정용
DragEvent	드래그 이벤트에 대한 정보를 제공합니다
DragHandler	드래그 처리기
DropArea	특정 영역에서 드래그 앤 드롭 처리를 지정하기 위해
EnterKey	화면 키보드의 Enter 키 모양을 조작할 수 있는 속성을 제공합니다
Flickable	"휙" 하고 스와이프할 수 있는 표면을 제공합니다
Flipable	뒤집을 수 있는 표면을 제공합니다
Flow	자식 요소를 나란히 배치하며, 필요에 따라 줄 바꿈을 수행합니다
FocusScope	포커스 범위를 명시적으로 생성합니다
FontInfo	주어진 글꼴 쿼리가 어떻게 해결되는지에 대한 정보를 제공합니다
FontLoader	URL을 통해 글꼴을 로드할 수 있게 합니다
FontMetrics	주어진 글꼴에 대한 메트릭을 제공합니다
FrameAnimation	애니메이션 프레임 업데이트 시마다 핸들러를 트리거합니다
GestureEvent	gestureStarted 신호와 함께 전달되는 매개변수
Gradient	그라데이션 채우기를 정의합니다
GradientStop	그라디언트 내 특정 위치의 색상을 정의합니다
GraphicsInfo	씬그래프 백엔드 및 다음에서 사용하는 그래픽 API에 대한 정보를 제공합니다 Qt Quick
Grid	자식 요소를 격자 형태로 배치합니다
GridMesh	정점이 그리드 형태로 배열된 메시를 정의합니다
GridView	모델에서 제공하는 항목의 그리드 보기를 지정하기 위해
HoverHandler	마우스 및 태블릿 호버에 대한 핸들러
Image	이미지를 표시합니다
InputMethod	QML 애플리케이션에서 QInputMethod에 대한 액세스를 제공합니다
IntValidator	정수 값에 대한 유효성 검사기를 정의합니다
Item	기본적인 시각적 QML 유형
ItemGrabResult	Item::grabToImage() 호출 결과를 포함합니다
KeyEvent	키 이벤트에 대한 정보를 제공합니다
KeyNavigation	화살표 키를 통한 키 탐색을 지원합니다
Keys	Item에 키 처리 기능을 제공합니다
LayoutMirroring	레이아웃 동작을 반영하는 데 사용되는 속성
ListView	모델에서 제공하는 항목의 목록 보기를 제공합니다
Loader	URL 또는 컴포넌트에서 서브트리를 동적으로 불러올 수 있게 합니다
Matrix4x4	항목에 4x4 변환 행렬을 적용하는 방법을 제공합니다
MouseArea	간단한 마우스 처리를 가능하게 합니다
MouseEvent	마우스 이벤트에 대한 정보를 제공합니다
MultiPointHandler	다중 포인트 포인터 이벤트를 위한 추상 핸들러
MultiPointTouchArea	여러 터치 지점을 처리할 수 있게 합니다
NumberAnimation	qreal형 값의 변화를 애니메이션으로 표현합니다
OpacityAnimator	Type은 Item의 불투명도를 애니메이션 처리합니다
Palette	각 QML 항목 상태에 대한 색상 그룹을 포함합니다
ParallelAnimation	애니메이션을 병렬로 실행할 수 있게 합니다
ParentAnimation	상위 값의 변화를 애니메이션으로 표현합니다
ParentChange	상태 변경 시 아이템의 부모를 재설정하는 방법을 지정합니다
Path	PathView 및 Shape에서 사용할 경로를 정의합니다
PathAngleArc	지정된 반지름과 중심을 가진 호를 정의합니다
PathAnimation	경로를 따라 항목에 애니메이션을 적용합니다
PathArc	지정된 반지름을 가진 호를 정의합니다
PathAttribute	경로 내 지정된 위치에 속성을 설정하는 방법을 지정합니다
PathCubic	두 개의 제어점을 가진 3차 베지어 곡선을 정의합니다
PathCurve	Catmull-Rom 곡선상의 점을 정의합니다
PathElement	기본 경로 유형
PathInterpolator	경로를 따라 수동으로 애니메이션을 적용하는 방법을 지정합니다
PathLine	직선을 정의합니다
PathMove	경로의 위치를 이동합니다
PathMultiline	좌표 목록의 목록을 통해 폴리라인 집합을 정의합니다
PathPercent	경로가 해석되는 방식을 조작합니다
PathPolyline	좌표 목록을 통해 폴리라인을 정의합니다
PathQuad	제어점을 가진 2차 베지어 곡선을 정의합니다
PathRectangle	선택적으로 모서리를 둥글게 한 사각형을 정의합니다
PathSvg	SVG 경로 데이터 문자열을 사용하여 경로를 정의합니다
PathText	지정된 글꼴로 문자열을 정의합니다
PathView	경로 상에 모델에서 제공된 항목을 배치합니다
PauseAnimation	애니메이션 일시 정지 기능을 제공합니다
PinchArea	간단한 핀치 제스처 처리를 지원합니다
PinchEvent	핀치 이벤트에 대한 정보를 지정하기 위해
PinchHandler	핀치 제스처 핸들러
PlanarTransform	2D 변환에 사용될 때 matrix4x4를 위한 유틸리티 함수를 제공합니다
PointHandler	단일 터치 지점에 반응하는 핸들러
PointerDevice	QPointingDevice에 상응하는 QML
PointerDeviceHandler	장치별 제약 조건이 있는 포인터 이벤트용 추상 핸들러
PointerEvent	QPointerEvent에 상응하는 QML
PointerHandler	포인터 이벤트용 추상 핸들러
Positioner	포지셔너 내에서 항목이 위치한 위치에 대한 세부 정보를 포함하는 부착 속성을 제공합니다
PropertyAction	애니메이션 중 즉각적인 속성 변경을 지정합니다
PropertyAnimation	속성 값의 변화를 애니메이션으로 표현합니다
PropertyChanges	상태에 대한 새로운 속성 바인딩 또는 값을 설명합니다
Rectangle	선택적으로 테두리가 있는 채워진 사각형을 그립니다
RegularExpressionValidator	문자열 유효성 검사기를 제공합니다
Repeater	제공된 모델을 사용하여 여러 Item 기반 컴포넌트를 인스턴스화합니다
Rotation	항목을 회전시키는 방법을 제공합니다
RotationAnimation	회전 값의 변화를 애니메이션으로 표현합니다
RotationAnimator	Type은 Item의 회전을 애니메이션 처리합니다
Row	자식 요소를 한 줄로 배치합니다
SafeArea	항목 또는 창의 안전 영역 속성에 대한 액세스를 제공합니다
Scale	항목의 크기를 조정하는 방법을 제공합니다
ScaleAnimator	이 타입은 아이템의 크기 조정 계수를 애니메이션 처리합니다
Screen	'Attached object'는 항목이나 창이 표시되는 화면에 대한 정보를 제공합니다
ScriptAction	애니메이션 실행 중에 실행될 스크립트를 정의합니다
SequentialAnimation	애니메이션을 순차적으로 실행할 수 있게 합니다
ShaderEffect	사각형에 사용자 정의 셰이더를 적용합니다
ShaderEffectSource	Qt Quick 항목을 텍스처로 렌더링하여 표시합니다
Shear	항목을 전단(shear)하는 방법을 제공합니다
Shortcut	키보드 단축키를 제공합니다
SinglePointHandler	단일 지점 포인터 이벤트용 추상 핸들러
SmoothedAnimation	속성이 값을 부드럽게 추적할 수 있도록 합니다
SpringAnimation	속성이 스프링과 같은 움직임으로 값을 추적할 수 있도록 합니다
Sprite	스프라이트 애니메이션을 지정합니다
SpriteSequence	스프라이트 애니메이션을 그립니다
State	객체 및 속성의 구성을 정의합니다
StateChangeScript	상태에서 스크립트를 실행하는 방법을 지정합니다
StateGroup	Item 유형이 아닌 객체에 대한 내장 상태 지원을 제공합니다
SystemPalette	Qt 팔레트에 대한 액세스 기능을 제공합니다
TableView	모델의 데이터를 표시하기 위한 항목 테이블 뷰를 제공합니다
TapHandler	탭 및 클릭에 대한 핸들러
Text	씬에 서식이 지정된 텍스트를 추가하는 방법을 지정합니다
TextDocument	TextEdit의 기반이 되는 QTextDocument를 감싸는 래퍼
TextEdit	편집 가능한 서식 지정된 텍스트를 여러 줄로 표시합니다
TextInput	편집 가능한 한 줄의 텍스트를 표시합니다
TextMetrics	주어진 글꼴 및 텍스트에 대한 메트릭을 제공합니다
TextSelection	연속된 텍스트 선택 영역과 그 속성을 나타냅니다
TouchPoint	MultiPointTouchArea 내의 터치 지점을 기술합니다
Transform	항목에 대한 고급 변환을 지정하기 위해
Transition	상태 변경 시 발생하는 애니메이션 전환을 정의합니다
Translate	항목의 x 또는 y 속성을 변경하지 않고 이동할 수 있는 방법을 제공합니다
TreeView	QAbstractItemModel의 데이터를 표시하기 위한 트리 뷰를 제공합니다
UniformAnimator	ShaderEffect의 유니폼을 애니메이션 처리합니다
Vector3dAnimation	QVector3d 값의 변화를 애니메이션 처리합니다
ViewTransition	뷰에서 전환 중인 항목을 지정합니다
WheelEvent	마우스 휠 이벤트에 대한 정보를 제공합니다
WheelHandler	마우스 휠 핸들러
Window	새로운 최상위 창을 생성합니다
WindowContainer	Qt Quick 씬에 임의의 QWindows를 임베드할 수 있게 합니다
XAnimator	Type은 Item의 x 좌표를 애니메이션 처리합니다
YAnimator	항목의 y 좌표를 애니메이션 처리합니다
color	ARGB 색상 값
eventPoint	QEventPoint에 해당하는 Qml
font	QFont의 속성을 가진 글꼴 값. 글꼴 유형은 QFont의 속성을 가진 글꼴 값을 의미합니다
handlerPoint	이벤트 포인트
matrix4x4	matrix4x4 유형은 4행 4열의 행렬입니다
pointingDeviceUniqueId	QPointingDeviceUniqueId에 해당하는 QML 표현
quaternion	쿼터니언(quaternion) 유형은 스칼라(scalar), x, y, z 속성을 가집니다
vector2d	vector2d 유형은 x 및 y 속성을 가집니다
vector3d	x, y, z 속성을 가진 값
vector4d	vector4d 유형은 x, y, z 및 w 속성을 가집니다

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