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 的几何形状。

Popup 采用的填充方法与Control 相同。有关 padding 系统的可视化说明，请参阅文档的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 相同的填充方法。有关 padding 系统的可视化解释，请参阅文档的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 。

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

弹出窗口使用与Control 相同的填充方法。有关 padding 系统的可视化说明，请参阅文档的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 。

该属性保存默认 padding。

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

Popup 采用的填充方法与Control 相同。有关 padding 系统的可视化说明，请参阅文档的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 通常只支持桌面平台。此外，如果弹出窗口是Menu 内的native menubar ，菜单也将是本地的。如果菜单是另一个菜单中的子菜单，则由父（或根）菜单决定类型。

默认值通常是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 的几何形状。

Popup 采用的填充方法与Control 相同。有关 padding 系统的可视化说明，请参阅文档的Control Layout 部分。

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

该属性用于保存弹出窗口的缩放系数。默认值为1.0 。

缩放比例小于1.0 时，弹出窗口的尺寸会变小；缩放比例大于1.0 时，弹出窗口的尺寸会变大。不支持负缩放比例。

该属性保留间距。

间距对于具有多个或重复构件的弹出窗口非常有用。例如，一些样式使用间距来确定Dialog 的页眉、内容和页脚之间的距离。 Popup 并不强制执行间距，因此每种样式可能会有不同的解释，有些样式可能会完全忽略间距。

该属性在 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 的几何形状。

Popup 采用的填充方法与Control 相同。有关 padding 系统的可视化说明，请参阅文档的Control Layout 部分。

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

该属性为进入和退出转换中的转换原点。

如下图所示，共有九个变换原点。默认的变换原点是Popup.Center 。

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

该属性用于保存垂直填充。除非明确设置，否则该值等于padding 。

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

Popup 采用的填充方法与Control 相同。有关 padding 系统的可视化解释，请参阅文档的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 。