Application QML Type (Singleton)

많은 QML 컴포넌트가 공유하는 전역 애플리케이션 상태 속성에 대한 액세스를 제공합니다. 더 보기...

참고: 이 유형은 QML 싱글톤입니다. QML 엔진에는 이 유형의 인스턴스가 단 하나만 존재합니다.

• 상속된 멤버를 포함한 모든 멤버 목록
• 사용 중단된 멤버

속성

• arguments : list<string>
• displayName : string
• domain : string
• font : font
• layoutDirection : enumeration
• name : string
• organization : string
• screens : list<Screen>
• state : enumeration
• styleHints : StyleHints
• supportsMultipleWindows : bool
• version : string

신호

• aboutToQuit()

상세 설명

Application 싱글톤은 QApplication 의 속성 중 일부를 QML 애플리케이션에 노출합니다.

또한 ` aboutToQuit()` 시그널을 제공하며, 이는 ` QCoreApplication::aboutToQuit()`와 동일합니다.

import QtQuick

Window {
    id: root
    visible: true
    width: 800
    height: 680

    title: `${Application.name} (${Application.version})`

    Connections {
        target: Application
        function onAboutToQuit() {
            console.log("Bye!")
        }
    }
}

SystemPalette도 참조하십시오 .

속성 문서

arguments : list<string>

이것은 실행 파일이 호출될 때 전달된 인수의 문자열 목록입니다.

displayName : string

이 속성은 ` QGuiApplication ` 인스턴스에 설정된 애플리케이션 표시 이름을 나타냅니다. 애플리케이션 표시 이름을 설정하려면 이 속성에 값을 기록하면 됩니다.

Binding {
    target: Application
    property: "displayName"
    value: "My Awesome Application"
}

domain : string

이는 QCoreApplication 인스턴스에 설정된 조직 도메인입니다. 이 속성에 값을 기록하여 조직 도메인을 설정할 수 있습니다.

font : font [read-only]

QGuiApplication::font() 함수가 반환하는 기본 애플리케이션 글꼴을 반환합니다.

layoutDirection : enumeration [read-only]

이 읽기 전용 속성은 애플리케이션의 기본 레이아웃 방향을 조회하는 데 사용할 수 있습니다. 시스템 시작 시 기본 레이아웃 방향은 애플리케이션의 언어에 따라 달라집니다. 텍스트와 그래픽 요소가 오른쪽에서 왼쪽으로 읽히는 로케일에서는 이 속성의 값이 ` Qt.RightToLeft `이며, 왼쪽에서 오른쪽으로 읽히는 로케일에서는 ` Qt.LeftToRight `입니다. 이 속성에 바인딩하여 두 가지 레이아웃 방향을 모두 지원하도록 애플리케이션 레이아웃을 사용자 지정할 수 있습니다.

사용 가능한 값에 대해서는 C++의 Qt::LayoutDirection 열거형을 참조하십시오.

RowLayout {
    layoutDirection: Application.layoutDirection
}

name : string

이는 QCoreApplication 인스턴스에 설정된 애플리케이션 이름입니다. 이 속성에 값을 기록하여 애플리케이션 이름을 설정할 수 있습니다.

organization : string

이는 QCoreApplication 인스턴스에 설정된 조직 이름입니다. 이 속성에 값을 기록하여 조직 이름을 설정할 수 있습니다.

screens : list<Screen> [read-only]

연결된 모든 화면의 설명이 포함된 배열입니다. 이 배열의 요소들은 Screen 에 연결된 객체와 동일한 속성을 가진 객체들입니다. 실제로 이 배열은 QGuiApplication::screens() 함수가 반환하는 화면 목록과 일치합니다. 이름, 너비, 높이 등의 속성을 확인하는 것 외에도, 이 배열의 요소들을 Window 항목의 screen 속성에 할당할 수 있으므로, C++ 측의 QWindow::setScreen() 함수를 대체하는 역할을 합니다.

Screen, Window 및 Window.screen도 참조하십시오 .

state : enumeration [read-only]

이 속성은 애플리케이션의 현재 상태를 나타냅니다.

사용 가능한 값에 대해서는 C++의 ` Qt::ApplicationState ` 열거형을 참조하십시오.

Timer {
    interval: 1000; repeat: true
    active: Application.state === Qt.ApplicationActive
    onTriggered: imageFetcher.fetchLatestImages()
}

styleHints : StyleHints [read-only]

styleHints 속성은 플랫폼별 스타일 힌트와 설정을 제공합니다. 자세한 내용은 QStyleHints 문서를 참조하십시오.

다음 예제에서는 ` styleHints `를 사용하여 마우스 클릭 시 또는 터치 해제 시 항목에 포커스가 이동해야 하는지 여부를 결정합니다:

import QtQuick

MouseArea {
    id: button

    onPressed: {
        if (!Application.styleHints.setFocusOnTouchRelease)
            button.forceActiveFocus()
    }
    onReleased: {
        if (Application.styleHints.setFocusOnTouchRelease)
            button.forceActiveFocus()
    }
}

supportsMultipleWindows : bool [read-only]

플랫폼이 다중 창을 지원하는 경우 ` true `를 반환합니다. 예를 들어, 일부 임베디드 플랫폼은 다중 창을 지원하지 않습니다.

version : string

이는 QCoreApplication 인스턴스에 설정된 애플리케이션 버전입니다. 이 속성에 값을 기록하여 애플리케이션 버전을 설정할 수 있습니다.

Signal 문서

aboutToQuit()

이 신호는 애플리케이션이 메인 이벤트 루프를 종료하기 직전에 발생합니다. 이 신호는 애플리케이션에서 마지막 순간에 정리 작업을 수행해야 할 때 특히 유용합니다. 이 상태에서는 사용자 상호작용이 불가능합니다. 자세한 내용은 Window.closing 를 참조하십시오.

QCoreApplication::aboutToQuit도 참조하십시오 .