Qt Quick Controls QML Types

Qt Quick Controls 는 사용자 인터페이스 생성을 위한 QML 유형을 제공합니다. 이러한 QML 유형은 다음과 함께 작동합니다. Qt Quick 및 Qt Quick 레이아웃과 함께 작동합니다.

Qt Quick Controls QML 유형은 .qml 파일에서 다음 import 문을 사용하여 애플리케이션으로 가져올 수 있습니다:

import QtQuick.Controls

QML 유형

속성 선언에서 Qt Quick Controls 유형 사용

에서 언급했듯이 Qt Quick Templates 2 QML Types에서 언급했듯이 Qt Quick Controls 의 각 유형은 C++ "템플릿" 유형으로 뒷받침됩니다. 이러한 유형은 컨트롤의 로직과 동작을 시각적으로 구현한 것입니다.

예를 들어 Menu 유형의 API 및 동작은 Qt Quick 템플릿의 C++ 유형에 의해 정의됩니다. 메뉴를 제공하려는 각 스타일은 Menu.qml을 사용할 수 있어야 하며 해당 파일의 루트 항목은 Qt Quick 템플릿의 메뉴여야 합니다. QtQuick .Controls를 가져와서 QML로 메뉴를 만들면 실제로 얻는 유형은 스타일의 Menu.qml에 정의된 QML 메뉴입니다.

속성 선언에서 컨트롤을 유형으로 사용하려면 Qt Quick 템플릿에서 해당 유형을 사용해야 합니다. 예를 들어 팝업을 여는 버튼인 PopupOpener 컴포넌트가 있다고 가정해 보겠습니다:

// PopupButton.qml
import QtQuick.Controls

Button {
    required property Popup popup

    onClicked: popup.open()
}

// main.qml
PopupButton {
    popup: saveChangesDialog
}

Dialog {
    id: saveChangesDialog

    // ...
}

이 코드를 실행하면 오류가 발생합니다:

Unable to assign Dialog_QMLTYPE to Popup_QMLTYPE

이는 상속 계층 구조 때문입니다:

Popup (C++ type in QtQuick.Templates)
│   └── Popup (QML type in QtQuick.Controls)
└── Dialog (C++ type in QtQuick.Templates)
    └── Dialog (QML type in QtQuick.Controls)

QtQuick.Controls 의 대화 상자는 QtQuick.Controls 의 팝업에서 파생되지 않고 QtQuick.Templates 에서 파생됩니다.

대신 Qt Quick 템플릿의 팝업을 속성 유형으로 사용하세요:

// PopupButton.qml
import QtQuick.Controls
import QtQuick.Templates as T

Button {
    required property T.Popup popup

    onClicked: popup.open()
}

Qt Quick Controls 모듈에 대한 자세한 내용은 Qt Quick Controls 모듈 문서를 참조하세요.

관련 정보

• Qt Quick Controls 가이드라인