弹出 QML 类型

此属性表示弹出窗口是否有活动焦点。

也见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）中引入的。

另请参阅：弹出窗口定位、锚点 以及 在属性声明中使用 Qt Quick Controls 类型。

此属性包含在弹出窗口的 contentItem 的高度，减去弹出窗口的高度属性 height 中的垂直填充。

另请参阅：填充、上填充 以及 下填充。

此属性包含在弹出窗口的 contentItem 的宽度，减去弹出窗口的宽度属性 width 中的水平填充。

另请参阅：填充、左填充 以及 右填充。

此属性包含背景项。

另请参阅：自定义弹出窗口。

此属性包含背景的下嵌边。

这个属性是在 QtQuick.Controls 2.5（Qt 5.12）中引入的。

另请参阅：弹出窗口布局 以及 上嵌边。

此属性包含弹出窗口下边缘与其窗口下边缘之间的距离。

具有负下边距的弹出窗口将不会推入封装窗口的底部边缘。默认值是 -1。

另请参阅：边距、上边距 以及 弹出窗口布局。

此属性包含下填充。除非明确设置，否则其值等于 verticalPadding。

填充属性用于控制 content item 的几何形状。

弹窗使用与控件相同的填充方式。有关填充系统的视觉描述，请参阅文档中的控件布局部分。

另请参阅 padding、topPadding、verticalPadding和availableHeight。

此属性表示是否启用裁剪。默认值为false。

此属性决定弹出窗口关闭的情况。可以组合标志以允许弹出窗口的多种关闭方式。

可用的值包括

CloseOnPress*和CloseOnRelease*策略仅适用于弹出窗口外部的活动。也就是说，如果有两个弹出窗口同时打开，第一个窗口设置有Popup.CloseOnPressOutside作为其策略，点击第二个窗口不会导致第一个窗口关闭。

默认值为Popup.CloseOnEscape | Popup.CloseOnPressOutside。

此属性包含内容子项列表。

列表包含在QML中声明为弹出窗口子项的所有项。

另请参阅 Item::children和contentData。

此属性包含内容数据列表。

列表包含在QML中声明为弹出窗口子项的所有对象。

另请参阅 Item::data和contentChildren。

此属性表示内容高度。它用于计算弹出窗口的总隐式高度。

有关更多信息，请参阅弹出窗口大小调整。

另请参阅 contentWidth。

此属性表示弹出窗口的内容项。

内容项是弹出窗口的视觉实现。当弹出窗口Visible时，内容项会自动重新父到覆盖项。

另请参阅：自定义弹出窗口。

此属性包含内容宽度。它用于计算弹出窗口的总隐式宽度。

有关更多信息，请参阅弹出窗口大小调整。

另请参阅：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 的几何形状。

弹窗使用与控件相同的填充方式。有关填充系统的视觉描述，请参阅文档中的控件布局部分。

这个属性是在 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）中引入的。

另请参阅 弹出窗口布局 和 rightInset。

该属性保存弹出窗口左侧边缘与窗口左侧边缘之间的距离。

具有负左侧边距的弹出窗口不会推入封闭窗口的左侧边缘。默认值为 -1。

另请参阅 margins、rightMargin 和 弹出窗口布局。

该属性保存左侧填充。除非明确设置，否则值等于 horizontalPadding。

填充属性用于控制 content item 的几何形状。

弹窗使用与控件相同的填充方式。有关填充系统的视觉描述，请参阅文档中的控件布局部分。

另请参阅 padding、rightPadding、horizontalPadding 和 availableWidth。

该属性保存弹出窗口的地区。

另请参阅 mirrored 和 布局镜像。

此属性存储弹出窗口边缘与其窗口边缘之间的距离。

带有负边距的弹出窗口不会被推动到包围窗口的边界内。默认值是 -1。

另请参阅topMargin、leftMargin、rightMargin、bottomMargin 以及 Popup 布局。

此属性存储弹出窗口是否为镜像。

该属性为方便使用而提供。弹出窗口被认为是镜像的，当其可视化布局方向从右到左；即，当使用从右到左的区域设置时。

此属性自 QtQuick.Controls 2.3 (Qt 5.10) 起被引入。

另请参阅locale 和 从右到左的用户界面。

此属性存储弹出窗口是否为模态。

模态弹出窗口通常在 Overlay.modal 中定义了一个独特的背景变暗效果，并且不允许按下或释放事件传递到它们下面的项目。例如，如果用户不小心点击弹出窗口之外的地方，该位置的点击不会通过该弹出窗口传递到下面的任何项目。

在桌面平台上，模态弹出窗口通常仅在按下Esc键时关闭。为了实现此行为，将 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 的几何形状。

弹窗使用与控件相同的填充方式。有关填充系统的视觉描述，请参阅文档中的控件布局部分。

另请参阅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")
        }
    }
}

此属性自 QtQuick.Controls 2.3 (Qt 5.10) 起被引入。

另请参阅Item::palette、Window::palette、ColorGroup 和 Palette。

此属性保存父项。

此属性保存背景的右侧内边距。

这个属性是在 QtQuick.Controls 2.5（Qt 5.12）中引入的。

另请参阅弹出布局和leftInset。

此属性保存弹出窗口的右边框与窗口右边框之间的距离。

带有负右侧边距的弹出窗口不会推入封装窗口的右边框内。默认值为-1。

另请参阅margins、leftMargin和弹出布局。

此属性保存右侧填充。除非显式设置，否则该值等于horizontalPadding。

填充属性用于控制 content item 的几何形状。

弹窗使用与控件相同的填充方式。有关填充系统的视觉描述，请参阅文档中的控件布局部分。

另请参阅padding、leftPadding、horizontalPadding和availableWidth。

此属性保存弹出窗口的缩放因子。默认值为1.0。

小于1.0的缩放将使弹出窗口以更小的尺寸渲染，而大于1.0的缩放将使弹出窗口以更大的尺寸渲染。不支持负缩放。

此属性保存间隙距离。

间隙对于具有多个或重复构建块的弹出窗口很有用。例如，某些样式使用间隙来确定对话框的标题、内容和页脚之间的距离。Popup不会强制实施间隙，因此每种样式可能有不同的解释，有些可能完全忽略。

此属性自 QtQuick.Controls 2.1 (Qt 5.8) 引入。

此属性保存背景的顶部内边距。

这个属性是在 QtQuick.Controls 2.5（Qt 5.12）中引入的。

另请参阅弹出布局和bottomInset。

此属性保存弹出窗口的顶部边框与窗口顶部边框之间的距离。

带有负顶部边距的弹出窗口不会推入封装窗口的顶部边框内。默认值为-1。

另请参阅margins、bottomMargin和弹出布局。

此属性保存顶部填充。除非显式设置，否则值等于verticalPadding。

填充属性用于控制 content item 的几何形状。

弹窗使用与控件相同的填充方式。有关填充系统的视觉描述，请参阅文档中的控件布局部分。

另请参阅padding、bottomPadding、verticalPadding和availableHeight。

该属性包含进入和退出过渡中的变换原点。

以下是九种变换原点，如图片所示。默认变换原点是 Popup.Center。

另请参阅 enter、exit 和 Item::transformOrigin。

该属性包含垂直填充。除非显式设置，否则值等于 padding。

填充属性用于控制 content item 的几何形状。

弹窗使用与控件相同的填充方式。有关填充系统的视觉描述，请参阅文档中的控件布局部分。

这个属性是在 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 值是 0。

另请参阅 x 和 y。

当弹出窗口即将隐藏时，发出此信号。

另请参阅 closed。

当弹出窗口即将显示时，发出此信号。

另请参阅 opened。

当弹出窗口关闭时，发出此信号。

另请参阅 aboutToHide。

当弹出窗口打开时，发出此信号。

另请参阅 aboutToShow。

关闭弹出窗口。

另请参阅visible。

强制将活动焦点设置给具有给定的弹出窗口。

此方法将焦点设置到弹出窗口，并确保对象层级图中所有祖先级FocusScope对象也获得。

另请参阅activeFocus和Qt::FocusReason。

打开弹出窗口。

另请参阅visible。