Тип QML Popup

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

Заявление об импорте:	import QtQuick.Controls 2.0
С:	Qt 5.7
Наследует:	QtObject
Наследуется в:	Dialog, Drawer, Menu и ToolTip

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

Свойства

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

Сигналы

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 Popup относительны к его родителю. Это означает, что открытие всплывающего окна, которое является дочерним элементом 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 ненулевым положительным значением.

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

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

[только для чтения] 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 после вычитания вертикального отступа из высоты всплывающего окна.

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

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

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

См. также 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 : перечисление

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

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

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

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

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

contentChildren : список<Item>

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

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

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

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

[по умолчанию] contentData : список<Object>

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

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

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

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

contentHeight : real

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

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

См. также contentWidth.

contentItem : Item

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

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

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

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

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

contentWidth : real

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

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

См. также contentHeight.

dim : bool

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

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

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

[с 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

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

[с 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

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

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

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

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

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

leftMargin : real

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

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

См. также margins, 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 и Интерфейсы пользователей справа налево.

END_OF_DOCUMENT_MARKER

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

Модальные всплывающие окна часто имеют отличительный эффект затемнения фона, определенный в 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 и Палитра.

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.0/qml-qtquick-controls2-popup.html

Тип QML Popup

Свойства

Сигналы

Методы

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

Компоновка Popup

Изменение размера 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 : перечисление

contentChildren : список<Item>

[по умолчанию] contentData : список<Object>

contentHeight : real

contentItem : Item

contentWidth : real

dim : bool

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

enter : Transition

exit : Transition

focus : bool

font : font

height : real

[с 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

[с 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()