ApplicationWindow QML Type

머리글 및 바닥글을 지원하는 스타일이 지정된 최상위 창입니다. 더 보기...

Import Statement: import QtQuick.Controls
Inherits:

Window

속성

첨부 속성

상세 설명

ApplicationWindow는 menu bar, headerfooter 항목을 창에 추가하는 데 편리하게 사용할 수 있는 Window 입니다.

ApplicationWindow를 애플리케이션의 루트 항목으로 선언하고 QQmlApplicationEngine 을 사용하여 실행할 수 있습니다. 이렇게 하면 QML에서 창의 속성, 모양 및 레이아웃을 제어할 수 있습니다.

import QtQuick.Controls 2.12

ApplicationWindow {
    visible: true

    menuBar: MenuBar {
        // ...
    }

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

참고: 기본적으로 ApplicationWindow는 표시되지 않습니다.

첨부된 ApplicationWindow 속성

QML에서 범위 및 명명 해상도가 작동하는 방식 때문에 애플리케이션 루트 요소의 id 을 하위 QML 객체의 어느 곳에서나 참조할 수 있습니다. 이 접근 방식은 많은 애플리케이션과 사용 사례에 적합하지만, 일반적인 QML 컴포넌트의 경우 주변 환경에 대한 종속성을 생성하므로 허용되지 않을 수 있습니다.

ApplicationWindow는 특정 창에 대한 종속성을 생성하지 않고 창에 직접 액세스할 수 없는 위치에서 창 및 해당 빌딩 블록에 액세스하는 데 사용할 수 있는 일련의 첨부 프로퍼티를 제공합니다 id. ApplicationWindow 첨부 프로퍼티를 사용하는 QML 컴포넌트는 id 에 관계없이 모든 창에서 작동합니다.

ApplicationWindow 사용자 지정, Overlay, Page, 컨테이너 컨트롤 Qt Quick Controls 의 포커스 관리도참조하십시오 .

속성 문서

activeFocusControl : Control [read-only]

이 속성은 현재 활성 포커스가 있는 컨트롤을 보유하거나 활성 포커스가 있는 컨트롤이 없는 경우 null 을 보유합니다.

Window::activeFocusItemApplicationWindow::activeFocusControl 의 차이점은 전자는 컨트롤의 빌딩 블록을 가리킬 수 있지만 후자는 둘러싸고 있는 컨트롤을 가리킬 수 있다는 것입니다. 예를 들어 SpinBox 에 포커스가 있는 경우 activeFocusItem은 편집기를 가리키고 activeFocusControl은 SpinBox 자체를 가리킵니다.

Window::activeFocusItem참조하세요 .


background : Item

이 속성은 배경 항목을 보유합니다.

배경 항목은 content item 아래, 창의 background color 위에 쌓입니다.

예를 들어 배경 항목은 이미지 및 그라데이션에 유용하지만 단색에는 항목을 만들 필요가 없으므로 color 속성을 사용하는 것이 좋습니다.

참고: 배경 항목에 명시적인 크기가 지정되지 않은 경우 자동으로 컨트롤의 크기를 따릅니다. 대부분의 경우 배경 항목의 너비나 높이를 지정할 필요가 없습니다.

ApplicationWindow 사용자 지정하기, contentItem, header, 및 footer참조하세요 .


contentData : list<QtObject> [default]

이 기본 속성에는 창의 자식으로 선언된 모든 객체의 목록이 저장됩니다.

데이터 속성을 사용하면 시각적 자식, 리소스 및 기타 창을 ApplicationWindow 에서 자유롭게 혼합할 수 있습니다.

contentData 목록에 항목을 할당하면 해당 항목은 창의 contentItem 의 자식이 되어 창 안에 표시됩니다. 항목의 부모는 창의 contentItem 이 됩니다.

ApplicationWindow 의 기본 속성이므로 모든 자식 항목이 이 속성에 자동으로 할당되므로 일반적으로는 contentData 속성을 참조할 필요가 없습니다.

contentItem참조하세요 .


contentItem : Item [read-only]

이 속성은 창 콘텐츠 항목을 보유합니다.

콘텐츠 항목은 background 항목 위와 menuBar, header, footer 항목 아래에 쌓입니다.

background, menuBar, header, footer도 참조 하세요.


font : font

이 속성은 현재 창에 설정된 글꼴을 보유합니다.

기본 글꼴은 시스템 환경에 따라 달라집니다. QGuiApplication 은 모든 애플리케이션 창의 기본 글꼴로 사용되는 시스템/테마 글꼴을 유지합니다. QML을 로드하기 전에 QGuiApplication::setFont()에 사용자 정의 글꼴을 전달하여 창의 기본 글꼴을 설정할 수도 있습니다. 마지막으로, 글꼴을 Qt의 글꼴 데이터베이스와 대조하여 가장 잘 일치하는 글꼴을 찾습니다.

ApplicationWindow 명시적 글꼴 프로퍼티를 자식 컨트롤에 전파합니다. 창의 글꼴에서 특정 속성을 변경하면 해당 속성이 창의 모든 자식 컨트롤로 전파되어 해당 속성에 대한 시스템 기본값을 재정의합니다.

Control::font참조하세요 .


이 속성은 창 바닥글 항목을 보유합니다. 바닥글 항목은 하단에 위치하며 창 너비에 맞게 크기가 조정됩니다. 기본값은 null 입니다.

ApplicationWindow {
    footer: ToolBar {
        // ...
    }
}

참고: ToolBar, TabBar 또는 DialogButtonBox 를 창 바닥글로 지정하면 해당 ToolBar::position, TabBar::position 또는 DialogButtonBox::position 속성이 자동으로 Footer 로 설정됩니다.

menuBar, header, Page::footer참조하세요 .


header : Item

이 속성은 창 헤더 항목을 보유합니다. 헤더 항목은 창 상단의 메뉴 모음 아래에 위치하며 창 너비에 맞게 크기가 조정됩니다. 기본값은 null 입니다.

ApplicationWindow {
    header: TabBar {
        // ...
    }
}

참고: ToolBar, TabBar 또는 DialogButtonBox 를 창 헤더로 지정하면 해당 ToolBar::position, TabBar::position 또는 DialogButtonBox::position 속성이 자동으로 Header 로 설정됩니다.

menuBar, footer, Page::header도 참조하세요 .


locale : Locale

이 속성은 창의 로캘을 보유합니다.

기본 로캘은 시스템 환경에 따라 다릅니다. QML을 로드하기 전에 QLocale::setDefault()를 호출하여 기본 로캘을 설정할 수 있습니다.

ApplicationWindow 로캘을 자식 컨트롤에 전파합니다. 창의 로캘을 변경하면 해당 로캘이 창의 모든 자식 컨트롤에 전파되어 시스템 기본 로캘을 재정의합니다.

Control::locale참조하십시오 .


이 속성은 창 메뉴 표시줄을 보유합니다. 메뉴 모음은 창 상단의 헤더 위에 위치하며 창 너비에 맞게 크기가 조정됩니다. 기본값은 null 입니다.

ApplicationWindow {
    menuBar: MenuBar {
        // ...
    }
}

이 속성은 QtQuick.Controls 2.3(Qt 5.10)에 도입되었습니다.

header, footer, MenuBar참조하십시오 .


첨부된 속성 문서

ApplicationWindow.activeFocusControl : Control [read-only]

이 첨부 프로퍼티는 현재 활성 포커스가 있는 컨트롤을 보유하거나 활성 포커스가 있는 컨트롤이 없는 경우 null 을 보유합니다. 이 속성은 모든 항목에 첨부할 수 있습니다. 항목이 창에 없거나 창에 활성 포커스가 없는 경우 값은 null 입니다.

Window::activeFocusItemAttached ApplicationWindow Properties참조하세요 .


ApplicationWindow.contentItem : Item [read-only]

이 첨부된 속성은 창 콘텐츠 항목을 보유합니다. 이 속성은 모든 항목에 첨부할 수 있습니다. 항목이 ApplicationWindow 에 없는 경우 값은 null 입니다.

Attached ApplicationWindow Properties도 참조하세요 .


이 첨부 속성은 창 바닥글 항목을 보유합니다. 이 속성은 모든 항목에 첨부할 수 있습니다. 항목이 ApplicationWindow 에 없거나 창에 바닥글 항목이 없는 경우 값은 null 입니다.

Attached ApplicationWindow Properties참조하세요 .


ApplicationWindow.header : Item [read-only]

이 첨부 속성은 창 머리글 항목을 보유합니다. 이 속성은 모든 항목에 첨부할 수 있습니다. 항목이 ApplicationWindow 에 있지 않거나 창에 머리글 항목이 없는 경우 값은 null 입니다.

Attached ApplicationWindow Properties참조하세요 .


이 첨부 속성은 창 메뉴 표시줄을 보유합니다. 이 속성은 모든 항목에 첨부할 수 있습니다. 항목이 ApplicationWindow 에 없거나 창에 메뉴 표시줄이 없는 경우 값은 null 입니다.

이 속성은 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

Attached ApplicationWindow Properties참조하십시오 .


ApplicationWindow.window : ApplicationWindow [read-only]

이 첨부 속성은 응용 프로그램 창을 보유합니다. 이 속성은 모든 항목에 첨부할 수 있습니다. 항목이 ApplicationWindow 에 없는 경우 값은 null 입니다.

Attached ApplicationWindow Properties도 참조하십시오 .


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