Тип QML Popup

Базовый тип элементов пользовательского интерфейса, похожих на всплывающие окна. Подробнее...

Оператор импорта:	import QtQuick.Controls 2.1
С тех пор:	Qt 5.7
Наследует:	QtObject
Наследуется от:	Dialog, Drawer, Menu и ToolTip

Список всех членов, включая наследуемые

Свойства

activeFocus : bool
anchors.centerIn : Object
availableHeight : real
availableWidth : real
background : Item
bottomInset : real
bottomMargin : real
bottomPadding : real
clip : bool
closePolicy : перечисление
contentChildren : список<Item>
contentData : список<Object>
contentHeight : real
contentItem : Item
contentWidth : real
dim : bool
enabled : bool
enter : Transition
exit : Transition
focus : bool
font : шрифт
height : real
horizontalPadding : real
implicitBackgroundHeight : real
implicitBackgroundWidth : real
implicitContentHeight : real
implicitContentWidth : real
implicitHeight : real
implicitWidth : real
leftInset : real
leftMargin : real
leftPadding : real
locale : Локаль
margins : real
mirrored : bool
modal : bool
opacity : real
opened : bool
padding : real
palette : палитра
parent : Item
rightInset : real
rightMargin : real
rightPadding : real
scale : real
spacing : real
topInset : real
topMargin : real
topPadding : real
transformOrigin : перечисление
verticalPadding : real
visible : bool
width : real
x : real
y : real
z : real

Сигналы

void aboutToHide()
void aboutToShow()
void closed()
void opened()

Методы

void close()
forceActiveFocus(перечисление reason)
void open()

Подробное описание

Popup — это базовый тип элементов пользовательского интерфейса, похожих на всплывающие окна. Он может использоваться с Window или ApplicationWindow.

import QtQuick.Window 2.2
import QtQuick.Controls 2.12

ApplicationWindow {
    id: window
    width: 400
    height: 400
    visible: true

    Button {
        text: "Open"
        onClicked: popup.open()
    }

    Popup {
        id: popup
        x: 100
        y: 100
        width: 200
        height: 300
        modal: true
        focus: true
        closePolicy: Popup.CloseOnEscape | Popup.CloseOnPressOutsideParent
    }
}

Для того, чтобы всплывающее окно отображалось поверх других элементов сцены, рекомендуется использовать ApplicationWindow. ApplicationWindow также обеспечивает эффекты затемнения фона.

Popup не предоставляет собственной компоновки, но требует от вас размещения содержимого, например, создав RowLayout или ColumnLayout.

Элементы, объявленные как дочерние элементы Popup, автоматически становятся дочерними элементами contentItem Popup. Динамически созданные элементы необходимо явно присоединять к contentItem.

На следующей диаграмме показана компоновка всплывающего окна внутри окна:

Значения implicitWidth и implicitHeight всплывающего окна обычно основаны на неявных размерах элемента фона и элемента содержимого плюс любые отступы и отступы. Эти свойства определяют, насколько большим будет всплывающее окно, если не задан явный width или height.

Геометрия contentItem определяется отступами. В следующем примере отводится 10 пикселей отступа между границами всплывающего окна и его содержимым:

Popup {
    padding: 10

    contentItem: Text {
        text: "Content"
    }
}

Элемент background заполняет всю ширину и высоту всплывающего окна, если не заданы отступы или явный размер.

Отрицательные отступы могут использоваться для того, чтобы сделать фон больше, чем само всплывающее окно. В следующем примере используются отрицательные отступы для размещения тени за пределами границ всплывающего окна:

Popup {
    topInset: -2
    leftInset: -2
    rightInset: -6
    bottomInset: -6

    background: BorderImage {
        source: ":/images/shadowed-background.png"
    }
}

Если используется только один элемент внутри Popup, он будет изменён, чтобы соответствовать неявным размерам содержащего элемента. Это делает его особенно подходящим для использования вместе с компоновщиками.

Popup {
    ColumnLayout {
        anchors.fill: parent
        CheckBox { text: qsTr("E-mail") }
        CheckBox { text: qsTr("Calendar") }
        CheckBox { text: qsTr("Contacts") }
    }
}

Иногда может быть два элемента внутри всплывающего окна:

Popup {
    SwipeView {
        // ...
    }
    PageIndicator {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.bottom: parent.bottom
    }
}

В этом случае Popup не может рассчитать разумный неявный размер. Поскольку мы привязываем PageIndicator к SwipeView, мы можем просто установить размер содержимого на неявный размер представления:

Popup {
    contentWidth: view.implicitWidth
    contentHeight: view.implicitHeight

    SwipeView {
        id: view
        // ...
    }
    PageIndicator {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.bottom: parent.bottom
    }
 }

Подобно элементам в Qt Quick, координаты x и y всплывающего окна относительны к его родителю. Это означает, что открытие всплывающего окна, которое является дочерним элементом Button, например, приведет к размещению всплывающего окна относительно кнопки.

В следующем примере используется присоединённое свойство Overlay.overlay для размещения всплывающего окна в центре окна, несмотря на положение кнопки, открывающей всплывающее окно:

Button {
    onClicked: popup.open()

    Popup {
        id: popup

        parent: Overlay.overlay

        x: Math.round((parent.width - width) / 2)
        y: Math.round((parent.height - height) / 2)
        width: 100
        height: 100
    }
}

Другой способ центрировать всплывающее окно в окне независимо от его родительского элемента — использовать anchors.centerIn:

ApplicationWindow {
    id: window
    // ...

    Pane {
        // ...

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

Чтобы убедиться, что всплывающее окно расположено в пределах границ содержащего его окна, свойство margins можно задать ненулевым положительным значением.

Начиная с Qt 5.15.3, следующие свойства восстанавливаются до своих первоначальных значений до начала перехода enter после завершения перехода exit.

Это позволяет встроенным стилям анимировать эти свойства, не теряя при этом явно заданных значений.

См. также Всплывающие элементы управления, Настройка всплывающего окна и Окно приложения.

Документация свойств

[только для чтения] activeFocus : bool

Это свойство указывает, имеет ли всплывающее окно активный фокус.

См. также focus и Фокус клавиатуры в Qt Quick.

[с QtQuick.Controls 2.5 (Qt 5.12)] anchors.centerIn : Object

Якоря предоставляют способ позиционирования элемента, определяя его отношение к другим элементам.

Типичный пример — центрирование всплывающего окна внутри его родительского элемента. Один из способов сделать это — использовать свойства x и y. Якоря предлагают более удобный подход:

Pane {
    // ...

    Popup {
        anchors.centerIn: parent
    }
}

Также можно центрировать всплывающее окно в окне, используя Overlay:

ApplicationWindow {
    id: window
    // ...

    Pane {
        // ...

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

Это упрощает центрирование всплывающего окна в окне из любого компонента.

Примечание: Всплывающие окна могут быть центрированы только внутри их непосредственного родителя или перекрытия окна; попытка центрирования в других элементах вызовет предупреждение.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также Позиционирование всплывающего окна, anchors и Использование типов Qt Quick Controls в объявлениях свойств.

[только для чтения] availableHeight : real

Это свойство содержит высоту, доступную для contentItem после вычитания вертикального отступа из height всплывающего окна.

См. также padding, topPadding и bottomPadding.

[только для чтения] availableWidth : real

Это свойство содержит ширину, доступную для contentItem после вычитания горизонтального отступа из width всплывающего окна.

См. также padding, leftPadding и rightPadding.

background : Item

Это свойство содержит элемент фона.

Примечание: Если у элемента фона нет явно заданного размера, он автоматически соответствует размеру всплывающего окна. В большинстве случаев нет необходимости указывать ширину или высоту для элемента фона.

Примечание: Большинство всплывающих окон используют неявный размер элемента фона для расчета собственного неявного размера. Если вы замените элемент фона пользовательским, вы также должны обеспечить разумный неявный размер для него (если это не элемент, как Image, у которого есть собственный неявный размер).

См. также Настройка всплывающего окна.

[с QtQuick.Controls 2.5 (Qt 5.12)] bottomInset : real

Это свойство содержит нижний отступ для фона.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также Макет всплывающего окна и topInset.

bottomMargin : real

Это свойство содержит расстояние между нижним краем всплывающего окна и нижним краем его окна.

Всплывающее окно с отрицательным нижним отступом не выводится за пределы нижнего края содержащего его окна. Значение по умолчанию — -1.

См. также margins, topMargin и Макет всплывающего окна.

bottomPadding : real

Это свойство содержит нижний отступ. Если не задано явно, значение равно verticalPadding.

Свойства отступа используются для управления геометрией элемента содержимого.

Всплывающее окно использует тот же подход к отступам, что и Control. Визуальное объяснение системы отступов см. в разделе Макет элемента управления документации.

См. также padding, topPadding, verticalPadding и availableHeight.

clip : bool

Это свойство указывает, включена ли обрезка. Значение по умолчанию — false.

closePolicy : enumeration

Это свойство определяет условия закрытия всплывающего окна. Флаги могут быть объединены для поддержки нескольких способов закрытия.

Доступные значения:

Постоянная	Описание
`Popup.NoAutoClose`	Всплывающее окно закроется только при явном указании.
`Popup.CloseOnPressOutside`	Всплывающее окно закроется при нажатии мыши за его пределами.
`Popup.CloseOnPressOutsideParent`	Всплывающее окно закроется при нажатии мыши за пределами его родителя.
`Popup.CloseOnReleaseOutside`	Всплывающее окно закроется при отпускании мыши за его пределами.
`Popup.CloseOnReleaseOutsideParent`	Всплывающее окно закроется при отпускании мыши за пределами его родителя.
`Popup.CloseOnEscape`	Всплывающее окно закроется при нажатии клавиши Esc, если оно имеет активный фокус.

Значение по умолчанию — Popup.CloseOnEscape | Popup.CloseOnPressOutside.

Примечание: Известно ограничение: политики Popup.CloseOnReleaseOutside и Popup.CloseOnReleaseOutsideParent работают только с модальными всплывающими окнами.

contentChildren : list<Item>

Это свойство содержит список дочерних элементов содержимого.

Список включает все элементы, объявленные в QML как дочерние элементы всплывающего окна.

Примечание: В отличие от contentData, contentChildren не включает невидимые объекты QML.

См. также Item::children и contentData.

[значение по умолчанию] contentData : list<Object>

Это свойство содержит список данных содержимого.

Список включает все объекты, объявленные в QML как дочерние элементы всплывающего окна.

Примечание: В отличие от contentChildren, contentData включает невидимые объекты QML.

См. также Item::data и contentChildren.

contentHeight : real

Это свойство содержит высоту содержимого. Оно используется для расчета общей неявной высоты всплывающего окна.

Дополнительную информацию см. в разделе Изменение размеров всплывающего окна.

См. также contentWidth.

contentItem : Item

Это свойство содержит элемент содержимого всплывающего окна.

Элемент содержимого — это визуальная реализация всплывающего окна. При отображении всплывающего окна элемент содержимого автоматически перенаследуется к элементу перекрытия.

Примечание: Элемент содержимого автоматически изменяет размер, чтобы соответствовать отступам всплывающего окна.

Примечание: Большинство всплывающих окон используют неявный размер элемента содержимого для расчета собственного неявного размера. Если вы замените элемент содержимого пользовательским, вы также должны обеспечить разумный неявный размер для него (если это не элемент, как Text, у которого есть свой неявный размер).

См. также Настройка всплывающего окна.

contentWidth : real

Это свойство содержит ширину содержимого. Оно используется для вычисления общей неявной ширины всплывающего окна.

Для получения дополнительной информации см. Размещение всплывающего окна.

См. также contentHeight.

dim : bool

Это свойство указывает, затемняет ли всплывающее окно фон.

Если явно не задано, это свойство следует за значением modal. Чтобы вернуться к значению по умолчанию, установите это свойство в undefined.

См. также modal и Overlay.modeless.

[since QtQuick.Controls 2.3 (Qt 5.10)] enabled : bool

Это свойство указывает, включено ли всплывающее окно. Значение по умолчанию — true.

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также visible и Item::enabled.

enter : Transition

Это свойство содержит переход, применяемый к элементу всплывающего окна при его открытии и появлении на экране.

Следующий пример анимирует непрозрачность всплывающего окна при его появлении на экране:

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

См. также exit.

exit : Transition

Это свойство содержит переход, применяемый к элементу всплывающего окна при его закрытии и скрытии с экрана.

Следующий пример анимирует непрозрачность всплывающего окна при его скрытии с экрана:

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

См. также enter.

focus : bool

Это свойство указывает, хочет ли всплывающее окно получить фокус.

Когда всплывающее окно фактически получает фокус, activeFocus будет true. Для получения дополнительной информации см. Фокус клавиатуры в Qt Quick.

Значение по умолчанию — false.

См. также activeFocus.

font : font

Это свойство содержит шрифт, который в настоящее время установлен для всплывающего окна.

Всплывающее окно передает явные свойства шрифта своим дочерним элементам. Если вы измените определенное свойство шрифта всплывающего окна, это свойство будет передано всем дочерним элементам всплывающего окна, переопределяя любые системные значения по умолчанию для этого свойства.

Popup {
    font.family: "Courier"

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

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

См. также Control::font и ApplicationWindow::font.

height : real

Это свойство содержит высоту всплывающего окна.

[since QtQuick.Controls 2.5 (Qt 5.12)] horizontalPadding : real

Это свойство содержит горизонтальный отступ. Если явно не задано, значение равно padding.

Свойства отступа используются для управления геометрией элемента содержимого.

Всплывающее окно использует тот же подход к отступам, что и Control. Визуальное объяснение системы отступов см. в разделе Макет управления документации.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также padding, leftPadding, rightPadding и verticalPadding.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundHeight : real

Это свойство содержит неявную высоту фона.

Значение равно background ? background.implicitHeight : 0.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitBackgroundWidth и implicitContentHeight.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundWidth : real

Это свойство содержит неявную ширину фона.

Значение равно background ? background.implicitWidth : 0.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitBackgroundHeight и implicitContentWidth.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitContentHeight : real

Это свойство содержит неявную высоту содержимого.

Значение вычисляется на основе дочерних элементов содержимого.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitContentWidth и implicitBackgroundHeight.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitContentWidth : real

Это свойство содержит неявную ширину содержимого.

Значение вычисляется на основе дочерних элементов содержимого.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitContentHeight и implicitBackgroundWidth.

implicitHeight : real

Это свойство содержит неявную высоту всплывающего окна.

implicitWidth : real

Это свойство содержит неявную ширину всплывающего окна.

[since QtQuick.Controls 2.5 (Qt 5.12)] leftInset : real

Это свойство содержит левый отступ фона.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также Макет всплывающего окна и rightInset.

leftMargin : real

Это свойство содержит расстояние между левым краем всплывающего окна и левым краем его окна.

Всплывающее окно с отрицательным левым отступом не выводится внутри левого края содержащего окна. Значение по умолчанию — -1.

См. также отступы, rightMargin и Макет всплывающего окна.

leftPadding : real

Это свойство содержит левый отступ. Если явно не задано, значение равно horizontalPadding.

Свойства отступа используются для управления геометрией элемента содержимого.

См. также padding, rightPadding, horizontalPadding и availableWidth.

locale : Locale

Это свойство содержит локаль всплывающего окна.

См. также mirrored и LayoutMirroring.

margins : real

Это свойство содержит расстояние между краями всплывающего окна и краями его окна.

Всплывающее окно с отрицательными отступами не выводится внутри границ содержащего окна. Значение по умолчанию — -1.

См. также topMargin, leftMargin, rightMargin, bottomMargin и Макет всплывающего окна.

[только для чтения, начиная с QtQuick.Controls 2.3 (Qt 5.10)] mirrored : bool

Это свойство указывает, зеркально ли отображается всплывающее окно.

Это свойство предоставляется для удобства. Всплывающее окно считается зеркальным, когда его направление визуального макета — справа налево; то есть, когда используется локаль справа налево.

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также locale и Интерфейсы пользователя справа налево.

Это свойство определяет, является ли всплывающее окно модальным.

Модальные всплывающие окна часто имеют отличительный эффект затемнения фона, определяемый в Overlay.modal, и не пропускают события нажатия или отпускания на элементы, расположенные под ними. Например, если пользователь случайно щелкнёт за пределами всплывающего окна, любой элемент под этим всплывающим окном в месте щелчка не получит это событие.

На настольных платформах обычно модальные всплывающие окна закрываются только при нажатии клавиши Escape. Для достижения этого поведения установите closePolicy в Popup.CloseOnEscape. По умолчанию, closePolicy установлено в значение Popup.CloseOnEscape | Popup.CloseOnPressOutside, что означает, что щелчок за пределами модального всплывающего окна закроет его.

Значение по умолчанию — false.

См. также dim.

opacity : real

Это свойство содержит значение непрозрачности всплывающего окна. Непрозрачность задаётся числом от 0.0 (полностью прозрачное) до 1.0 (полностью непрозрачное). Значение по умолчанию — 1.0.

См. также visible.

[с QtQuick.Controls 2.3 (Qt 5.10)] opened : bool

Это свойство указывает, полностью ли открыто всплывающее окно. Всплывающее окно считается открытым, когда оно видимое и ни анимация входа (enter) ни анимация выхода (exit) не выполняются.

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также open(), close() и visible.

padding : real

Это свойство содержит значение отступа по умолчанию.

Свойства отступа используются для управления геометрией элемента содержимого.

Всплывающее окно использует тот же подход к отступам, что и Control. Визуальное объяснение системы отступов см. в разделе Макет элементов управления документации.

См. также availableWidth, availableHeight, topPadding, leftPadding, rightPadding и bottomPadding.

[с QtQuick.Controls 2.3 (Qt 5.10)] palette : palette

Это свойство содержит палитру, в данный момент установленную для всплывающего окна.

Всплывающее окно передает явные свойства палитры своим дочерним элементам. Если вы измените конкретное свойство палитры всплывающего окна, это свойство распространится на все дочерние элементы всплывающего окна, переопределяя любые системные значения по умолчанию для этого свойства.

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.

parent : Item

Это свойство содержит родительский элемент.

[с QtQuick.Controls 2.5 (Qt 5.12)] rightInset : real

Это свойство содержит правый отступ для фона.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также Макет всплывающего окна и leftInset.

rightMargin : real

Это свойство содержит расстояние между правым краем всплывающего окна и правым краем его окна.

Всплывающее окно с отрицательным правым отступом не смещается внутри правого края содержащего окна. Значение по умолчанию — -1.

См. также отступы, leftMargin и Макет всплывающего окна.

rightPadding : real

Это свойство содержит правый отступ. Если не задано явно, значение равно horizontalPadding.

Свойства отступа используются для управления геометрией элемента содержимого.

См. также padding, leftPadding, horizontalPadding и availableWidth.

scale : real

Это свойство содержит коэффициент масштабирования всплывающего окна. Значение по умолчанию — 1.0.

Масштаб меньше 1.0 приводит к отображению всплывающего окна в меньшем размере, а масштаб больше 1.0 — в большем. Отрицательные масштабы не поддерживаются.

[с QtQuick.Controls 2.1 (Qt 5.8)] spacing : real

Это свойство содержит значение интервала.

Интервал полезен для всплывающих окон, содержащих несколько или повторяющихся блоков. Например, некоторые стили используют интервал для определения расстояния между заголовком, содержимым и подвалом Диалога. Интервал не навязывается всплывающим окном, поэтому каждый стиль может интерпретировать его по-разному, и некоторые могут его вообще игнорировать.

Это свойство было добавлено в QtQuick.Controls 2.1 (Qt 5.8).

[с QtQuick.Controls 2.5 (Qt 5.12)] topInset : real

Это свойство содержит верхний отступ для фона.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также Макет всплывающего окна и bottomInset.

topMargin : real

Это свойство содержит расстояние между верхним краем всплывающего окна и верхним краем его окна.

Всплывающее окно с отрицательным верхним отступом не смещается внутри верхнего края содержащего окна. Значение по умолчанию — -1.

См. также отступы, bottomMargin и Макет всплывающего окна.

topPadding : real

Это свойство содержит верхний отступ. Если не задано явно, значение равно verticalPadding.

Свойства отступа используются для управления геометрией элемента содержимого.

См. также padding, bottomPadding, verticalPadding и availableHeight.

transformOrigin : enumeration

Это свойство определяет точку начала преобразований в анимациях входа и выхода.

Доступно девять точек начала преобразований, как показано на изображении ниже. Значение по умолчанию — Popup.Center.

См. также enter, exit и Item::transformOrigin.

[с QtQuick.Controls 2.5 (Qt 5.12)] verticalPadding : real

Это свойство содержит вертикальный отступ. Если не задано явно, значение равно padding.

Свойства отступа используются для управления геометрией элемента содержимого.

Это свойство было добавлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также padding, topPadding, bottomPadding и horizontalPadding.

visible : bool

Это свойство указывает, отображается ли всплывающее окно. Значение по умолчанию — false.

См. также open(), close() и opened.

width : real

Это свойство содержит ширину всплывающего окна.

x : real

Это свойство содержит координату x всплывающего окна.

См. также y и z.

y : real

Это свойство содержит координату y всплывающего окна.

См. также x и z.

z : real

Это свойство содержит значение z всплывающего окна. Значение z определяет порядок отображения всплывающих окон.

Если у двух видимых всплывающих окон одинаковое значение z, на верху будет то, которое было открыто последним.

Значение z по умолчанию — 0.

См. также x и y.

Документация сигналов

void aboutToHide()

Этот сигнал испускается, когда всплывающее окно собирается скрыть.

Примечание: Соответствующий обработчик — onAboutToHide.

См. также closed().

void aboutToShow()

Этот сигнал испускается, когда всплывающее окно собирается показать.

Примечание: Соответствующий обработчик — onAboutToShow.

См. также opened().

void closed()

Этот сигнал испускается, когда всплывающее окно закрыто.

Примечание: Соответствующий обработчик — onClosed.

См. также aboutToHide().

void opened()

Этот сигнал испускается, когда всплывающее окно открыто.

Примечание: Соответствующий обработчик — onOpened.

См. также aboutToShow().

Документация методов

void close()

Закрывает всплывающее окно.

См. также visible.

forceActiveFocus(enumeration reason = Qt.OtherFocusReason)

Принудительно устанавливает активный фокус на всплывающее окно с указанным reason.

Этот метод устанавливает фокус на всплывающее окно и гарантирует, что все родительские объекты FocusScope в иерархии объектов также получат focus.

См. также activeFocus и Qt::FocusReason.

void open()

Открывает всплывающее окно.

См. также visible.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qml-qtquick-controls2-popup.html

Тип QML Popup

Свойства

Сигналы

Методы

Подробное описание

Компоновка Popup

Размер всплывающего окна

Размещение всплывающего окна

Переходы всплывающих окон

Документация свойств

[только для чтения] activeFocus : bool

[с QtQuick.Controls 2.5 (Qt 5.12)] anchors.centerIn : Object

[только для чтения] availableHeight : real

[только для чтения] availableWidth : real

background : Item

[с QtQuick.Controls 2.5 (Qt 5.12)] bottomInset : real

bottomMargin : real

bottomPadding : real

clip : bool

closePolicy : enumeration

contentChildren : list<Item>

[значение по умолчанию] contentData : list<Object>

contentHeight : real

contentItem : Item

contentWidth : real

dim : bool

[since QtQuick.Controls 2.3 (Qt 5.10)] enabled : bool

enter : Transition

exit : Transition

focus : bool

font : font

height : real

[since QtQuick.Controls 2.5 (Qt 5.12)] horizontalPadding : real

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundHeight : real

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundWidth : real

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitContentHeight : real

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitContentWidth : real

implicitHeight : real

implicitWidth : real

[since QtQuick.Controls 2.5 (Qt 5.12)] leftInset : real

leftMargin : real

leftPadding : real

locale : Locale

margins : real

[только для чтения, начиная с QtQuick.Controls 2.3 (Qt 5.10)] mirrored : bool

modal : bool

opacity : real

[с QtQuick.Controls 2.3 (Qt 5.10)] opened : bool

padding : real

[с QtQuick.Controls 2.3 (Qt 5.10)] palette : palette

parent : Item

[с QtQuick.Controls 2.5 (Qt 5.12)] rightInset : real

rightMargin : real

rightPadding : real

scale : real

[с QtQuick.Controls 2.1 (Qt 5.8)] spacing : real

[с QtQuick.Controls 2.5 (Qt 5.12)] topInset : real

topMargin : real

topPadding : real

transformOrigin : enumeration

[с QtQuick.Controls 2.5 (Qt 5.12)] verticalPadding : real

visible : bool

width : real

x : real

y : real

z : real

Документация сигналов

void aboutToHide()

void aboutToShow()

void closed()

void opened()

Документация методов

void close()

forceActiveFocus(enumeration reason = Qt.OtherFocusReason)

void open()