ApplicationWindow QML Type

헤더와 푸터를 지원하는 스타일링된 최상위 창. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• activeFocusControl : Control
• background : Item
• bottomPadding : real (since 6.9)
• contentData : list<QtObject>
• contentItem : Item
• font : font
• footer : Item
• header : Item
• leftPadding : real (since 6.9)
• locale : Locale
• menuBar : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• rightPadding : real (since 6.9)
• topPadding : real (since 6.9)

연관 속성

• activeFocusControl : Control
• contentItem : Item
• footer : Item
• header : Item
• menuBar : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• window : ApplicationWindow

상세 설명

ApplicationWindow는 Window 의 파생 클래스로, 창에 menu bar, header 및 footer 항목을 편리하게 추가할 수 있게 해줍니다.

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

import QtQuick.Controls

ApplicationWindow {
    visible: true

    menuBar: MenuBar {
        // ...
    }

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

연결된 ApplicationWindow 속성

QML에서 Scope 및 이름 해상도가 작동하는 방식 덕분에, 애플리케이션 루트 요소의 id 를 그 자식 QML 객체 내 어디에서나 참조할 수 있습니다. 이 접근 방식은 많은 애플리케이션과 사용 사례에 적합하지만, 일반적인 QML 컴포넌트의 경우 주변 환경에 대한 의존성을 생성하므로 허용되지 않을 수 있습니다.

ApplicationWindow는 특정 창 인스턴스( id)에 대한 의존성을 생성하지 않으면서도, 창에 직접 접근할 수 없는 위치에서 창 및 그 구성 요소에 접근하는 데 사용할 수 있는 일련의 첨부 속성을 제공합니다. ApplicationWindow의 첨부 속성을 사용하는 QML 컴포넌트는 해당 컴포넌트의 인스턴스( id)와 관계없이 어떤 창에서든 작동합니다.

안전 영역

Qt 6.9부터 ApplicationWindow는 창에서 보고된 모든 safe area margins 에 대해 contentItem 에 패딩을 자동으로 추가합니다. 이를 통해 contentItem 가 창의 안전 영역 내에 머무르도록 보장하는 동시에, 배경 항목이 창 전체를 덮도록 합니다.

창의 ` contentItem `에서 안전 영역 여백을 수동으로 처리하는 경우, ` topPadding`, ` leftPadding`, ` rightPadding ` 및 ` bottomPadding ` 속성을 통해 기본값을 재정의할 수 있습니다:

ApplicationWindow {
    // Remove automatic safe area padding
    topPadding: 0

    Flickable {
        // Inset content by safe area margin
        topMargin: SafeArea.margins.top
    }
}

header, footer 및 menuBar 속성에는 안전 영역 여백에 대한 자동 패딩이 적용되지 않습니다. 그러나 사용 중인 스타일에 따라, 해당 스타일은 ToolBar, TabBar 및 MenuBar 을 구현할 때 안전 영역을 고려할 수 있습니다.

또한 ‘ApplicationWindow 사용자 지정’( Overlay), ‘ Page ’, ‘컨테이너 컨트롤’ 및 ‘ Qt Quick Controls ’의 ‘포커스 관리’항목도 참조하십시오 .

속성 설명서

activeFocusControl : Control [read-only]

이 속성은 현재 활성 포커스를 가지고 있는 컨트롤을 반환하며, 활성 포커스를 가진 컨트롤이 없는 경우에는 ` null `을 반환합니다.

Window::activeFocusItem 와 ApplicationWindow::activeFocusControl의 차이점은, 전자는 컨트롤의 구성 요소를 가리킬 수 있는 반면, 후자는 이를 감싸고 있는 상위 컨트롤을 가리킨다는 점입니다. 예를 들어, SpinBox 에 포커스가 있을 때, activeFocusItem은 편집기를 가리키고 activeFocusControl은 SpinBox 자체를 가리킵니다.

Window::activeFocusItem도 참조하십시오 .

background : Item

이 속성은 배경 항목을 포함합니다.

배경 항목은 ` content item` 아래에, 하지만 창의 ` background color ` 위쪽에 배치됩니다.

배경 항목은 예를 들어 이미지나 그라데이션에 유용하지만, 단색의 경우 항목을 생성할 필요가 없는 ' color ' 속성을 사용하는 것이 더 좋습니다.

참조: ApplicationWindow 사용자 지정, contentItem, header 및 footer.

bottomPadding : real [since 6.9]

이 속성은 창의 콘텐츠 항목의 하단 패딩을 지정합니다. 명시적으로 설정하지 않는 한, 이 값은 창의 ‘ safe area margins ’ 속성을 반영합니다.

이 속성은 Qt 6.9에서 도입되었습니다.

topPadding, leftPadding 및 rightPadding도 참조하십시오 .

contentData : list<QtObject> [default]

이 기본 속성은 해당 창의 자식으로 선언된 모든 객체의 목록을 포함합니다.

data 속성을 사용하면 콘텐츠 데이터( ApplicationWindow) 내에서 시각적 자식 요소, 리소스 및 다른 창을 자유롭게 혼합할 수 있습니다.

contentData 목록에 항목을 할당하면, 해당 항목은 창의 콘텐츠 영역( contentItem)의 자식이 되어 창 내부에 표시됩니다. 이 항목의 부모는 창의 콘텐츠 데이터( contentItem)가 됩니다.

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

contentItem도 참조하십시오 .

contentItem : Item [read-only]

이 속성은 창 콘텐츠 항목을 포함합니다.

콘텐츠 항목은 ' background ' 항목 위, ' menuBar', ' header' 및 ' footer ' 항목 아래에 배치됩니다.

Qt 6.9부터 ApplicationWindow 는 창에서 보고된 모든 safe area margins 에 대해 contentItem에 패딩을 자동으로 추가합니다. 패딩을 재정의하려면 개별 패딩 속성을 사용하십시오.

또한 background, menuBar, header, footer, topPadding, bottomPadding, leftPadding 및 rightPadding 을참조하십시오 .

font : font

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

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

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

Control::font도 참조하십시오 .

footer : Item

이 속성은 창 하단부 항목을 포함합니다. 하단부 항목은 창 하단에 배치되며, 창 너비에 맞게 크기가 조정됩니다. 기본값은 null 입니다.

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

menuBar, header 및 Page::footer도 참조하십시오 .

header : Item

이 속성은 창 헤더 항목을 포함합니다. 헤더 항목은 창 상단, 메뉴 막대 바로 아래에 위치하며, 창 너비에 맞춰 크기가 조정됩니다. 기본값은 null 입니다.

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

menuBar, footer 및 Page::header도 참조하십시오 .

leftPadding : real [since 6.9]

이 속성은 창의 콘텐츠 항목의 왼쪽 패딩을 지정합니다. 명시적으로 설정하지 않는 한, 이 값은 창의 왼쪽 여백( safe area margins)을 반영합니다.

이 속성은 Qt 6.9에서 도입되었습니다.

bottomPadding, topPadding 및 rightPadding도 참조하십시오 .

locale : Locale

이 속성은 창의 로케일을 저장합니다.

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

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

Control::locale도 참조하십시오 .

menuBar : Item [since QtQuick.Controls 2.3 (Qt 5.10)]

이 속성은 창 메뉴 막대를 포함합니다. 메뉴 막대는 창 상단, 헤더 바로 위에 위치하며, 창 너비에 맞춰 크기가 조정됩니다. 기본값은 ` null`입니다.

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

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

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

rightPadding : real [since 6.9]

이 속성은 창의 콘텐츠 항목에 대한 올바른 패딩을 유지합니다. 명시적으로 설정하지 않는 한, 이 값은 창의 ‘ safe area margins ’ 값을 반영합니다.

이 속성은 Qt 6.9에서 도입되었습니다.

bottomPadding, leftPadding 및 topPadding도 참조하십시오 .

topPadding : real [since 6.9]

이 속성은 창의 콘텐츠 항목 상단 패딩을 지정합니다. 명시적으로 설정하지 않는 한, 이 값은 창의 ‘ safe area margins ’ 값을 반영합니다.

이 속성은 Qt 6.9에서 도입되었습니다.

bottomPadding, leftPadding 및 rightPadding도 참조하십시오 .

부속 속성 문서

ApplicationWindow.activeFocusControl : Control [read-only attached]

이 첨부 속성은 현재 활성 포커스를 가진 컨트롤을 반환하며, 활성 포커스를 가진 컨트롤이 없는 경우에는 ` null `을 반환합니다. 이 속성은 모든 항목에 첨부할 수 있습니다. 항목이 창에 속해 있지 않거나 창에 활성 포커스가 없는 경우, 값은 ` null `입니다.

Window::activeFocusItem 및 Attached ApplicationWindow Properties항목도 참조하십시오 .

ApplicationWindow.contentItem : Item [read-only attached]

이 첨부 속성은 창 콘텐츠 항목을 포함합니다. 이 속성은 어떤 항목에나 첨부할 수 있습니다. 해당 항목이 ‘ ApplicationWindow ’에 속하지 않는 경우, 값은 ‘ null ’입니다.

Attached ApplicationWindow Properties도 참조하십시오 .

ApplicationWindow.footer : Item [read-only attached]

이 첨부 속성은 창 하단 항목을 포함합니다. 이 속성은 어떤 항목에나 첨부할 수 있습니다. 해당 항목이 ‘ ApplicationWindow ’에 속하지 않거나 창에 하단 항목이 없는 경우, 이 속성의 값은 ` null `입니다.

Attached ApplicationWindow Properties도 참조하십시오 .

ApplicationWindow.header : Item [read-only attached]

이 첨부 속성은 창 헤더 항목을 포함합니다. 이 속성은 어떤 항목이든 첨부할 수 있습니다. 해당 항목이 ‘ ApplicationWindow ’에 속하지 않거나 창에 헤더 항목이 없는 경우, 이 속성의 값은 ‘ null ’입니다.

Attached ApplicationWindow Properties도 참조하십시오 .

ApplicationWindow.menuBar : Item [read-only attached, since QtQuick.Controls 2.3 (Qt 5.10)]

이 첨부 속성은 창 메뉴 막대를 포함합니다. 이 속성은 어떤 항목이든 첨부할 수 있습니다. 항목이 ‘ ApplicationWindow ’에 속하지 않거나 창에 메뉴 막대가 없는 경우, 이 속성의 값은 ‘ null ’입니다.

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

Attached ApplicationWindow Properties도 참조하십시오 .

ApplicationWindow.window : ApplicationWindow [read-only attached]

이 첨부 속성은 애플리케이션 창을 포함합니다. 이 속성은 어떤 항목에나 첨부할 수 있습니다. 항목이 ‘ ApplicationWindow ’에 속하지 않을 경우, 이 속성의 값은 ‘ null ’입니다.

Attached ApplicationWindow Properties도 참조하십시오 .