Popup QML Type

이 속성은 팝업에 활성 포커스가 있는지 여부를 보유합니다.

focus 및 Qt Quick 의 키보드 포커스도참조하세요 .

앵커는 다른 항목과의 관계를 지정하여 항목의 위치를 지정하는 방법을 제공합니다.

일반적인 사용 사례는 부모 항목 내에서 팝업을 가운데에 배치하는 것입니다. 이를 위한 한 가지 방법은 x 및 y 속성을 사용하는 것입니다. 앵커는 보다 편리한 접근 방식을 제공합니다:

Pane {
    // ...

    Popup {
        anchors.centerIn: parent
    }
}

Overlay 을 사용하여 창에서 팝업을 가운데에 배치할 수도 있습니다:

ApplicationWindow {
    id: window
    // ...

    Pane {
        // ...

        Popup {
            anchors.centerIn: Overlay.overlay
        }
    }
}

이렇게 하면 모든 컴포넌트에서 창 중앙에 팝업을 쉽게 배치할 수 있습니다.

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

Popup Positioning, anchors, 및 Using Qt Quick Controls types in property declarations.

이 속성은 팝업의 height 에서 수직 패딩을 뺀 후 contentItem 에 사용할 수 있는 높이를 유지합니다.

padding, topPadding, 및 bottomPadding 를참조하십시오 .

이 속성은 팝업의 width 에서 가로 패딩을 뺀 후 contentItem 에 사용할 수 있는 너비를 보유합니다.

padding, leftPadding, 및 rightPadding 를참조하세요 .

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

팝업 사용자 지정하기를참조하세요 .

이 속성은 배경의 하단 인셋을 유지합니다.

이 프로퍼티는 QtQuick.Controls 2.5 (Qt 5.12)에서 도입되었습니다.

Popup Layout 및 topInset 을참조하십시오 .

이 속성은 팝업의 하단 가장자리와 해당 창의 하단 가장자리 사이의 거리를 유지합니다.

아래쪽 여백이 음수인 팝업은 둘러싸는 창의 아래쪽 가장자리 안으로 밀리지 않습니다. 기본값은 -1 입니다.

margins, topMargin, Popup Layout 를참조하세요 .

이 속성은 하단 패딩을 유지합니다. 명시적으로 설정하지 않는 한 값은 verticalPadding 입니다.

패딩 속성은 content item 의 지오메트리를 제어하는 데 사용됩니다.

팝업은 Control 과 동일한 패딩 방식을 사용합니다. 패딩 시스템에 대한 시각적 설명은 문서의 Control Layout 섹션을 참조하세요.

padding, topPadding, verticalPadding, availableHeight도 참조하세요 .

이 속성은 클리핑 활성화 여부를 보유합니다. 기본값은 false 입니다. 클리핑은 팝업이 자체 창에 있지 않을 때만 작동합니다.

이 속성은 팝업이 닫히는 상황을 결정합니다. 플래그를 조합하여 여러 가지 방법으로 팝업을 닫을 수 있습니다.

사용 가능한 값은 다음과 같습니다:

CloseOnPress* 및 CloseOnRelease* 정책은 팝업 외부의 이벤트에만 적용됩니다. 즉, 두 개의 팝업이 열려 있고 첫 번째 팝업의 정책이 Popup.CloseOnPressOutside 인 경우 두 번째 팝업을 클릭하면 첫 번째 팝업이 닫히지 않습니다.

기본값은 Popup.CloseOnEscape | Popup.CloseOnPressOutside 입니다.

이 속성은 콘텐츠 하위 목록을 보유합니다.

이 목록에는 QML에서 팝업의 하위 항목으로 선언된 모든 항목이 포함됩니다.

Item::children 및 contentData 을참조하세요 .

이 속성은 콘텐츠 데이터의 목록을 보유합니다.

이 목록에는 QML에서 팝업의 자식으로 선언된 모든 객체가 포함됩니다.

Item::data 및 contentChildren 을참조하세요 .

이 속성은 콘텐츠 높이를 보유합니다. 팝업의 총 암시적 높이를 계산하는 데 사용됩니다.

자세한 내용은 Popup Sizing 을 참조하세요.

contentWidth도 참조하십시오 .

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

콘텐츠 항목은 팝업의 시각적 구현입니다. 팝업이 표시되면 콘텐츠 항목은 자동으로 overlay item 로 부모가 변경됩니다.

팝업 사용자 지정하기를참조하세요 .

이 속성은 콘텐츠 너비를 보유합니다. 팝업의 총 암시적 너비를 계산하는 데 사용됩니다.

자세한 내용은 Popup Sizing 을 참조하세요.

contentHeight 를참조하세요 .

이 속성은 팝업의 배경을 어둡게 할지 여부를 보유합니다.

명시적으로 설정하지 않는 한 이 속성은 modal 의 값을 따릅니다. 기본값으로 돌아가려면 이 속성을 undefined 으로 설정합니다.

modal 및 Overlay.modeless 을참조하세요 .

이 속성은 팝업 활성화 여부를 보유합니다. 기본값은 true 입니다.

이 프로퍼티는 QtQuick.Controls 2.3 (Qt 5.10)에 도입되었습니다.

visible 와 Item::enabled 를참조하십시오 .

이 속성은 팝업이 열리고 화면에 진입할 때 팝업 항목에 적용되는 전환을 유지합니다.

다음 예제는 팝업이 화면에 들어올 때 팝업의 불투명도를 애니메이션으로 처리합니다:

Popup {
    enter: Transition {
        NumberAnimation { property: "opacity"; from: 0.0; to: 1.0 }
    }
}

exit 를참조하세요 .

이 속성은 팝업이 닫히고 화면에서 나갈 때 팝업 항목에 적용되는 전환을 유지합니다.

다음 예제는 화면에서 나갈 때 팝업의 불투명도를 애니메이션으로 처리합니다:

Popup {
    exit: Transition {
        NumberAnimation { property: "opacity"; from: 1.0; to: 0.0 }
    }
}

enter 를참조하세요 .

이 속성은 팝업이 포커스를 원하는지 여부를 보유합니다.

팝업이 실제로 포커스를 받으면 activeFocus 은 true 이 됩니다. 자세한 내용은 Qt Quick 에서 키보드 포커스를 참조하세요.

기본값은 false 입니다.

activeFocus 를참조하세요 .

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

팝업은 명시적 글꼴 속성을 자식에게 전파합니다. 팝업의 글꼴에서 특정 속성을 변경하면 해당 속성이 팝업의 모든 하위 항목으로 전파되어 해당 속성에 대한 시스템 기본값을 재정의합니다.

Popup {
    font.family: "Courier"

    Column {
        Label {
            text: qsTr("This will use Courier...")
        }

        Switch {
            text: qsTr("... and so will this")
        }
    }
}

Control::font 및 ApplicationWindow::font 을참조하세요 .

이 속성은 팝업의 높이를 보유합니다.

이 속성은 가로 패딩을 보유합니다. 명시적으로 설정하지 않는 한 값은 padding 입니다.

패딩 속성은 content item 의 지오메트리를 제어하는 데 사용됩니다.

팝업은 Control 과 동일한 패딩 방식을 사용합니다. 패딩 시스템에 대한 시각적 설명은 설명서의 Control Layout 섹션을 참조하십시오.

이 프로퍼티는 QtQuick.Controls 2.5(Qt 5.12)에 도입되었습니다.

padding, leftPadding, rightPadding, verticalPadding 를참조하십시오 .

이 속성은 암시적 배경 높이를 보유합니다.

값은 background ? background.implicitHeight : 0 입니다.

이 프로퍼티는 QtQuick.Controls 2.5 (Qt 5.12)에 도입되었습니다.

implicitBackgroundWidth 와 implicitContentHeight 를참조하십시오 .

이 속성은 암시적 배경 너비를 보유합니다.

값은 background ? background.implicitWidth : 0 입니다.

이 프로퍼티는 QtQuick.Controls 2.5 (Qt 5.12)에 도입되었습니다.

implicitBackgroundHeight 와 implicitContentWidth 를참조하십시오 .

이 속성은 암시적 콘텐츠 높이를 보유합니다.

이 값은 콘텐츠 자식에 따라 계산됩니다.

이 프로퍼티는 QtQuick.Controls 2.5 (Qt 5.12)에 도입되었습니다.

implicitContentWidth 및 implicitBackgroundHeight 을참조하십시오 .

이 속성은 암시적 콘텐츠 너비를 보유합니다.

이 값은 컨텐츠 자식에 따라 계산됩니다.

이 프로퍼티는 QtQuick.Controls 2.5 (Qt 5.12)에 도입되었습니다.

implicitContentHeight 및 implicitBackgroundWidth 을참조하십시오 .

이 속성은 팝업의 암시적 높이를 보유합니다.

이 속성은 팝업의 암시적 너비를 보유합니다.

이 속성은 배경의 왼쪽 인셋을 보유합니다.

이 프로퍼티는 QtQuick.Controls 2.5(Qt 5.12)에 도입되었습니다.

Popup Layout 및 rightInset 을참조하십시오 .

이 속성은 팝업의 왼쪽 가장자리와 창의 왼쪽 가장자리 사이의 거리를 유지합니다.

왼쪽 여백이 음수인 팝업은 둘러싸는 창의 왼쪽 가장자리 안으로 밀리지 않습니다. 기본값은 -1 입니다.

margins, rightMargin, Popup Layout 를참조하세요 .

이 속성은 왼쪽 패딩을 보유합니다. 명시적으로 설정하지 않는 한 값은 horizontalPadding 입니다.

패딩 프로퍼티는 content item 의 지오메트리를 제어하는 데 사용됩니다.

팝업은 Control 과 동일한 패딩 방식을 사용합니다. 패딩 시스템에 대한 시각적 설명은 문서의 Control Layout 섹션을 참조하세요.

padding, rightPadding, horizontalPadding, availableWidth도 참조하세요 .

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

mirrored 및 LayoutMirroring도 참조 하세요.

이 속성은 팝업의 가장자리와 창 가장자리 사이의 거리를 보유합니다.

여백이 음수인 팝업은 둘러싸는 창의 범위 내로 밀리지 않습니다. 기본값은 -1 입니다.

topMargin, leftMargin, rightMargin, bottomMargin, Popup Layout 를참조하세요 .

이 속성은 팝업이 미러링되는지 여부를 보유합니다.

이 속성은 편의를 위해 제공됩니다. 팝업의 시각적 레이아웃 방향이 오른쪽에서 왼쪽, 즉 오른쪽에서 왼쪽 로캘을 사용하는 경우 팝업이 미러링된 것으로 간주됩니다.

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

locale 및 오른쪽에서 왼쪽으로 사용자 인터페이스도참조하십시오 .

이 속성은 팝업이 모달인지 여부를 보유합니다.

모달 팝업은 종종 Overlay.modal 에 정의된 독특한 배경 흐리기 효과를 가지며, 그 아래 항목에 대한 누르기 또는 놓기 이벤트를 허용하지 않습니다. 예를 들어 사용자가 실수로 팝업 외부를 클릭하면 클릭한 위치의 해당 팝업 아래에 있는 항목은 이벤트를 수신하지 않습니다.

데스크톱 플랫폼에서는 모달 팝업이 이스케이프 키를 누를 때만 닫히는 것이 일반적입니다. 이 동작을 구현하려면 closePolicy 을 Popup.CloseOnEscape 으로 설정합니다. 기본적으로 closePolicy 은 Popup.CloseOnEscape | Popup.CloseOnPressOutside 으로 설정되어 있으므로 모달 팝업 외부를 클릭하면 해당 팝업이 닫힙니다.

기본값은 false 입니다.

dim 를참조하세요 .

이 속성은 팝업의 불투명도를 유지합니다. 불투명도는 0.0 (완전 투명)에서 1.0 (완전 불투명) 사이의 숫자로 지정됩니다. 기본값은 1.0 입니다.

visible 를참조하세요 .

이 속성은 팝업이 완전히 열려 있는지 여부를 보유합니다. 팝업이 표시되고 enter 또는 exit 전환이 실행되고 있지 않으면 팝업이 열린 것으로 간주됩니다.

이 프로퍼티는 QtQuick.Controls 2.3(Qt 5.10)에서 도입되었습니다.

open(), close() 및 visible 를참조하십시오 .

이 속성은 기본 패딩을 보유합니다.

패딩 프로퍼티는 content item 의 지오메트리를 제어하는 데 사용됩니다.

팝업은 Control 과 동일한 패딩 방식을 사용합니다. 패딩 시스템에 대한 시각적 설명은 문서의 Control Layout 섹션을 참조하세요.

availableWidth, availableHeight, topPadding, leftPadding, rightPadding, bottomPadding도 참조하세요 .

이 속성은 현재 팝업에 설정된 팔레트를 보유합니다.

팝업은 명시적 팔레트 속성을 자식에게 전파합니다. 팝업의 팔레트에서 특정 속성을 변경하면 해당 속성이 팝업의 모든 하위 항목에 전파되어 해당 속성에 대한 시스템 기본값을 재정의합니다.

Popup {
    palette.text: "red"

    Column {
        Label {
            text: qsTr("This will use red color...")
        }

        Switch {
            text: qsTr("... and so will this")
        }
    }
}

또한 참조하세요: Item::palette, Window::palette, ColorGroup 을 참조하십시오, Palette

이 프로퍼티는 QtQuick.Controls 2.3(Qt 5.10)에 도입되었습니다.

이 속성은 부모 항목을 보유합니다.

이 속성은 기본 설정되는 팝업 유형을 결정합니다.

사용 가능한 옵션은 다음과 같습니다:

팝업이 선호하는 유형을 사용할 수 있는지 여부는 플랫폼에 따라 다릅니다. Popup.Item 는 모든 플랫폼에서 지원되지만 Popup.Window 및 Popup.Native 는 일반적으로 데스크톱 플랫폼에서만 지원됩니다. 또한 팝업이 native menubar 안에 있는 Menu 인 경우 메뉴도 기본 메뉴가 됩니다. 메뉴가 다른 메뉴 내부의 하위 메뉴인 경우 상위(또는 루트) 메뉴에 따라 유형이 결정됩니다.

기본값은 위에서 언급한 몇 가지 예외를 제외하고 일반적으로 Popup.Item 입니다. 다른 팝업 유형을 사용하는 것이 유리한 특정 스타일과 플랫폼의 경우 향후 Qt 버전에서 변경될 수 있습니다. 예를 들어 macOS의 모든 스타일에 항상 기본 메뉴를 사용하려는 경우 그렇게 할 수 있습니다:

Menu {
    popupType: Qt.platform.os === "osx" ? Popup.Native : Popup.Window
}

또한 팝업을 사용자 지정하려는 경우(예: 델리게이트 변경 등) 팝업 유형을 Popup.Window 로 설정하는 것도 고려해야 합니다. 이렇게 하면 모든 플랫폼과 모든 스타일에서 변경 사항이 표시되도록 할 수 있습니다. 그렇지 않으면 네이티브 메뉴를 사용할 때 델리게이트가 렌더링에 사용되지 않습니다.

이 프로퍼티는 Qt 6.8에 도입되었습니다.

Popup type 를참조하십시오 .

이 속성은 배경에 대한 올바른 인셋을 유지합니다.

이 프로퍼티는 QtQuick.Controls 2.5(Qt 5.12)에 도입되었습니다.

Popup Layout 와 leftInset 를참조하십시오 .

이 속성은 팝업의 오른쪽 가장자리와 창의 오른쪽 가장자리 사이의 거리를 유지합니다.

오른쪽 여백이 음수인 팝업은 둘러싸는 창의 오른쪽 가장자리 안으로 밀리지 않습니다. 기본값은 -1 입니다.

margins, leftMargin, Popup Layout 를참조하세요 .

이 속성은 오른쪽 여백을 유지합니다. 명시적으로 설정하지 않는 한 값은 horizontalPadding 입니다.

패딩 속성은 content item 의 지오메트리를 제어하는 데 사용됩니다.

팝업은 Control 과 동일한 패딩 방식을 사용합니다. 패딩 시스템에 대한 시각적 설명은 문서의 Control Layout 섹션을 참조하세요.

padding, leftPadding, horizontalPadding, availableWidth도 참조하세요 .

이 속성은 팝업의 배율을 보유합니다. 기본값은 1.0 입니다.

배율이 1.0 보다 작으면 팝업이 더 작은 크기로 렌더링되고, 1.0 보다 크면 팝업이 더 큰 크기로 렌더링됩니다. 음수 배율은 지원되지 않습니다.

이 속성은 간격을 유지합니다.

간격은 여러 개 또는 반복적인 빌딩 블록이 있는 팝업에 유용합니다. 예를 들어 일부 스타일은 간격을 사용하여 Dialog 의 머리글, 콘텐츠 및 바닥글 사이의 거리를 결정합니다. 간격은 팝업에서 강제 적용되지 않으므로 스타일마다 다르게 해석할 수 있으며 일부는 완전히 무시할 수도 있습니다.

이 프로퍼티는 QtQuick.Controls 2.1(Qt 5.8)에 도입되었습니다.

이 속성은 배경의 상단 인셋을 유지합니다.

이 프로퍼티는 QtQuick.Controls 2.5 (Qt 5.12)에 도입되었습니다.

Popup Layout 와 bottomInset 를참조하십시오 .

이 속성은 팝업의 상단 가장자리와 해당 창의 상단 가장자리 사이의 거리를 유지합니다.

상단 여백이 음수인 팝업은 둘러싸는 창의 상단 가장자리 안으로 밀리지 않습니다. 기본값은 -1 입니다.

margins, bottomMargin, Popup Layout 를참조하세요 .

이 속성은 상단 패딩을 유지합니다. 명시적으로 설정하지 않는 한 값은 verticalPadding 입니다.

패딩 속성은 content item 의 지오메트리를 제어하는 데 사용됩니다.

팝업은 Control 과 동일한 패딩 방식을 사용합니다. 패딩 시스템에 대한 시각적 설명은 문서의 Control Layout 섹션을 참조하세요.

padding, bottomPadding, verticalPadding, availableHeight도 참조하세요 .

이 속성은 진입 및 종료 전환에서 변환의 원점을 보유합니다.

아래 이미지에 표시된 것처럼 9개의 변환 원점을 사용할 수 있습니다. 기본 트랜스폼 원점은 Popup.Center 입니다.

enter, exit, Item::transformOrigin 를참조하세요 .

이 속성은 수직 패딩을 보유합니다. 명시적으로 설정하지 않는 한 값은 padding 입니다.

패딩 속성은 content item 의 지오메트리를 제어하는 데 사용됩니다.

팝업은 Control 과 동일한 패딩 방식을 사용합니다. 패딩 시스템에 대한 시각적 설명은 설명서의 Control Layout 섹션을 참조하십시오.

이 프로퍼티는 QtQuick.Controls 2.5(Qt 5.12)에 도입되었습니다.

padding, topPadding, bottomPadding, horizontalPadding 를참조하십시오 .

이 속성은 팝업이 표시되는지 여부를 보유합니다. 기본값은 false 입니다.

open(), close() 및 opened 를참조하십시오 .

이 속성은 팝업의 너비를 보유합니다.

이 속성은 팝업의 x 좌표를 보유합니다.

y 및 z 을참조하세요 .

이 속성은 팝업의 y 좌표를 보유합니다.

x 및 z 을참조하세요 .

이 속성은 팝업의 z값을 보유합니다. Z 값은 팝업의 스택 순서를 결정합니다.

표시된 두 팝업의 z값이 같으면 마지막으로 열린 팝업이 맨 위에 표시됩니다.

팝업이 열렸을 때 명시적으로 설정된 z-값이 없고 이미 열려 있는 팝업의 자식인 경우 부모 팝업 위에 쌓입니다. 이렇게 하면 자식이 부모 아래에 숨겨지지 않습니다.

팝업에 자체 창이 있는 경우 z-값이 창 스택 순서를 대신 결정합니다.

기본 z 값은 0 입니다.

x 및 y 을참조하세요 .

이 신호는 팝업이 숨겨지려고 할 때 발생합니다.

closed()도 참조하세요 .

팝업이 표시되려고 할 때 이 신호가 전송됩니다.

opened()도 참조하세요 .

팝업이 닫힐 때 이 신호가 전송됩니다.

aboutToHide()도 참조하세요 .

이 신호는 팝업이 열릴 때 발생합니다.

aboutToShow()도 참조하세요 .

팝업을 닫습니다.

visible도 참조하세요 .

지정된 reason 으로 팝업에 활성 포커스를 강제 설정합니다.

이 메서드는 팝업에 포커스를 설정하고 객체 계층 구조의 모든 상위 FocusScope 객체에도 focus 이 지정되도록 합니다.

activeFocus 및 Qt::FocusReason 을참조하십시오 .

팝업을 엽니다.

visible도 참조하십시오 .