Qt Quick QML Types

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

이 모듈을 사용하려면 다음 문과 함께 QtQuick 모듈을 임포트하세요:

import QtQuick

모듈의 핵심 개념에 대한 자세한 내용은 Qt Quick 모듈 설명서를 참조하여 QtQuick 의 핵심 개념에 대한 자세한 내용을 확인하세요.

서브모듈

Qt Quick 에는 추가 유형을 포함하는 여러 하위 모듈이 포함되어 있습니다:

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

값 유형

QML 언어에서 기본적으로 지원되는 값 유형은 여러 가지가 있습니다.

또한 QtQuick 가져오기에서는 다음과 같은 값 유형을 제공합니다:

color	ARGB 색상 값
font	QFont 속성을 가진 글꼴 값. 글꼴 유형은 QFont 속성을 가진 글꼴 값을 나타냅니다.
matrix4x4	matrix4x4 유형은 4행, 4열 행렬입니다.
quaternion	쿼터니언 유형에는 스칼라, x, y 및 z 속성이 있습니다.
vector2d	벡터2d 유형에는 x 및 y 속성이 있습니다.
vector3d	x, y, z 속성을 가진 값
vector4d	벡터4d 유형에는 x, y, z 및 w 속성이 있습니다.

오브젝트 유형

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

Accessible	QML 항목의 접근성 활성화
AnchorAnimation	앵커 값의 변경 애니메이션
AnchorChanges	상태의 항목 앵커를 변경하는 방법을 지정합니다.
AnimatedImage	일련의 이미지로 저장된 애니메이션을 재생합니다.
AnimatedSprite	스프라이트 애니메이션을 그립니다.
Animation	모든 QML 애니메이션의 기본이 됩니다.
AnimationController	애니메이션의 수동 제어를 활성화합니다.
Animator	모든 QML 애니메이터의 기본입니다.
Application	많은 QML 컴포넌트에서 공유하는 글로벌 애플리케이션 상태 속성에 대한 액세스를 제공합니다.
Behavior	속성 변경에 대한 기본 애니메이션을 정의합니다.
BorderImage	이미지를 기반으로 테두리 그리기
BorderImageMesh	버텍스가 BorderImage와 같이 배열된 메쉬를 정의합니다.
Canvas	JavaScript를 통해 그림을 그릴 수 있는 2D 캔버스 항목 제공
CanvasGradient	불투명한 캔버스 그라데이션 인터페이스 제공
CanvasImageData	RGBA 순서로 이미지 픽셀 데이터 포함
CanvasPixelArray	이미지 데이터에서 각 픽셀의 구성 요소에 대한 정렬 및 인덱싱된 액세스 제공
CloseEvent	창이 곧 닫힐 것임을 알리는 알림
ColorAnimation	색상 값의 변화 애니메이션
ColorGroup	역할별 색상 세트
Column	열에 자식 위치 지정
Context2D	캔버스 항목의 도형에 대한 2D 컨텍스트 제공
DoubleValidator	정수가 아닌 숫자에 대한 유효성 검사기 정의
Drag	이동된 항목에 대한 드래그 앤 드롭 이벤트 지정용
DragEvent	드래그 이벤트에 대한 정보 제공
DragHandler	드래그 핸들러
DropArea	영역에서 드래그 앤 드롭 처리 지정용
EnterKey	화면 키보드에서 엔터 키의 모양을 조작하는 프로퍼티를 제공합니다.
Flickable	"플릭"할 수 있는 표면을 제공합니다.
Flipable	뒤집을 수 있는 서페이스를 제공합니다.
Flow	자식을 나란히 배치하고 필요에 따라 래핑합니다.
FocusScope	포커스 범위를 명시적으로 생성합니다.
FontInfo	주어진 글꼴 쿼리가 어떻게 해결되는지에 대한 정보를 제공합니다.
FontLoader	URL로 글꼴을 로드할 수 있습니다.
FontMetrics	주어진 글꼴에 대한 메트릭 제공
FrameAnimation	모든 애니메이션 프레임 업데이트 시 핸들러 트리거
GestureEvent	제스처 시작 신호와 함께 제공되는 매개변수
Gradient	그라데이션 채우기 정의
GradientStop	그라데이션의 한 위치에서 색을 정의합니다.
GraphicsInfo	시나리오 그래프 백엔드 및 다음에 사용되는 그래픽 API에 대한 정보를 제공합니다. Qt Quick
Grid	그리드 형성에서 자식을 배치합니다.
GridMesh	정점이 그리드에 배열된 메쉬를 정의합니다.
GridView	모델에서 제공하는 항목의 그리드 보기를 지정합니다.
HoverHandler	마우스 및 태블릿 호버용 핸들러
Image	이미지 표시
InputMethod	QML 애플리케이션을 위한 QInputMethod에 대한 액세스 제공
IntValidator	정수 값에 대한 유효성 검사기 정의
Item	기본 시각적 QML 유형
ItemGrabResult	Item::grabToImage() 호출의 결과를 포함합니다.
KeyEvent	키 이벤트에 대한 정보를 제공합니다.
KeyNavigation	화살표 키로 키 탐색 지원
Keys	아이템에 키 처리를 제공합니다.
LayoutMirroring	레이아웃 동작을 미러링하는 데 사용되는 속성
ListView	모델에서 제공하는 항목의 목록 보기를 제공합니다.
Loader	URL 또는 컴포넌트에서 하위 트리를 동적으로 로드할 수 있습니다.
Matrix4x4	항목에 4x4 변환 매트릭스를 적용하는 방법 제공
MouseArea	간단한 마우스 핸들링 가능
MouseEvent	마우스 이벤트에 대한 정보 제공
MultiPointHandler	멀티 포인트 포인터 이벤트를 위한 추상 핸들러
MultiPointTouchArea	다중 터치 포인트 처리 가능
NumberAnimation	큐리얼 타입 값의 변화 애니메이션
OpacityAnimator	유형은 아이템의 불투명도를 애니메이션화합니다.
Palette	각 QML 아이템 상태에 대한 컬러 그룹을 포함합니다.
ParallelAnimation	애니메이션을 병렬로 실행할 수 있습니다.
ParentAnimation	부모 값의 변화 애니메이션
ParentChange	상태 변경에서 아이템의 부모를 다시 지정하는 방법을 지정합니다.
Path	패스뷰와 도형에서 사용할 경로를 정의합니다.
PathAngleArc	지정된 반지름과 중심을 가진 호를 정의합니다.
PathAnimation	경로를 따라 항목 애니메이션
PathArc	지정된 반지름을 가진 호를 정의합니다.
PathAttribute	경로의 지정된 위치에 속성을 설정하는 방법을 지정합니다.
PathCubic	두 개의 제어점이 있는 큐빅 베지어 커브를 정의합니다.
PathCurve	캣멀-롬 커브의 한 점 정의하기
PathElement	기본 경로 유형
PathInterpolator	경로를 따라 수동으로 애니메이션을 적용하는 방법을 지정합니다.
PathLine	직선을 정의합니다.
PathMove	경로의 위치를 이동합니다
PathMultiline	좌표 목록 목록을 통해 폴리라인 집합을 정의합니다.
PathPercent	경로가 해석되는 방식 조작하기
PathPolyline	좌표 목록을 통해 폴리라인 정의하기
PathQuad	제어점이 있는 이차 베지어 곡선 정의하기
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	제공된 모델을 사용하여 여러 아이템 기반 컴포넌트를 인스턴스화합니다.
Rotation	아이템을 회전하는 방법을 제공합니다.
RotationAnimation	회전 값의 변화를 애니메이션으로 표시합니다.
RotationAnimator	유형은 항목의 회전을 애니메이션합니다.
Row	자식을 일렬로 배치합니다.
SafeArea	항목 또는 창의 안전 영역 속성에 대한 액세스를 제공합니다.
Scale	항목의 크기를 조정하는 방법을 제공합니다.
ScaleAnimator	유형은 항목의 배율을 애니메이션화합니다.
Screen	첨부된 개체는 항목 또는 창이 표시되는 화면에 대한 정보를 제공합니다.
ScriptAction	애니메이션 중에 실행할 스크립트를 정의합니다.
SequentialAnimation	애니메이션을 순차적으로 실행할 수 있습니다.
ShaderEffect	사각형에 사용자 지정 셰이더를 적용합니다.
ShaderEffectSource	Qt Quick 항목을 텍스처로 렌더링하여 표시합니다.
Shear	항목을 시어하는 방법을 제공합니다.
Shortcut	키보드 단축키 제공
SinglePointHandler	단일 포인트 포인터 이벤트를 위한 추상 핸들러
SmoothedAnimation	프로퍼티가 값을 원활하게 추적할 수 있도록 합니다.
SpringAnimation	프로퍼티가 스프링과 같은 동작으로 값을 추적할 수 있도록 합니다.
Sprite	스프라이트 애니메이션 지정
SpriteSequence	스프라이트 애니메이션을 그립니다.
State	객체 및 프로퍼티의 구성을 정의합니다.
StateChangeScript	상태에서 스크립트를 실행하는 방법을 지정합니다.
StateGroup	항목이 아닌 유형에 대한 내장 상태 지원 제공
SystemPalette	Qt 팔레트에 대한 액세스 제공
TableView	모델의 데이터를 표시하기 위한 항목의 테이블 보기 제공
TapHandler	탭 및 클릭 핸들러
Text	장면에 포맷된 텍스트를 추가하는 방법을 지정합니다.
TextDocument	TextEdit의 지원 QTextDocument를 감싸는 래퍼
TextEdit	편집 가능한 서식 있는 텍스트의 여러 줄을 표시합니다.
TextInput	편집 가능한 텍스트 한 줄을 표시합니다.
TextMetrics	주어진 글꼴과 텍스트에 대한 메트릭을 제공합니다.
TextSelection	연속된 텍스트 선택과 그 속성을 표시합니다.
TouchPoint	멀티포인트 터치 영역에서 터치 포인트를 설명합니다.
Transform	항목에 고급 변환을 지정합니다.
Transition	상태 변경 시 발생하는 애니메이션 전환을 정의합니다.
Translate	아이템의 x 또는 y 속성을 변경하지 않고 이동하는 방법을 제공합니다.
TreeView	QAbstractItemModel 의 데이터를 표시하는 트리 뷰를 제공합니다.
UniformAnimator	유형은 셰이더 이펙트의 유니폼을 애니메이션합니다.
Vector3dAnimation	QVector3d 값의 변화를 애니메이션화합니다.
ViewTransition	뷰에서 전환 중인 항목을 지정합니다.
WheelEvent	마우스 휠 이벤트에 대한 정보를 제공합니다.
WheelHandler	마우스 휠 핸들러
Window	새 최상위 창을 만듭니다.
WindowContainer	임의의 QWindows를 Qt Quick 장면에 임베드할 수 있습니다.
XAnimator	유형은 항목의 x 위치를 애니메이션화합니다.
YAnimator	유형은 항목의 y 위치를 애니메이션화합니다.
eventPoint	QEventPoint에 해당하는 Qml
handlerPoint	이벤트 포인트
pointingDeviceUniqueId	QPointingDeviceUniqueId에 대한 QML 등가물

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