Тип QML Overlay

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

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

Присоединённые свойства

• modal : Компонент
• modeless : Компонент
• overlay : Перекрытие

Присоединённые сигналы

• pressed()
• released()

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

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

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

Следующий пример использует присоединённое свойство 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
    }
}

См. такжеApplicationWindow.

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

Overlay.modal : Компонент

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

Свойство может быть присоединён к любому всплывающему окну.

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

Popup {
    id: popup
    width: 400
    height: 400
    modal: true
    visible: true

    Overlay.modal: Rectangle {
        color: "#aacfdbe7"
    }
}

См. такжеPopup::modal.

Overlay.modeless : Компонент

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

Свойство может быть присоединён к любому всплывающему окну.

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

Popup {
    id: popup
    width: 400
    height: 400
    dim: true
    visible: true

    Overlay.modeless: Rectangle {
        color: "#aacfdbe7"
    }
}

См. такжеPopup::dim.

[только для чтения] Overlay.overlay : Перекрытие

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

Свойство может быть присоединён к любому элементу, всплывающему окну или окну. При присоединении к элементу или всплывающему окну значение равно null если элемент или всплывающее окно не находятся в окне.

Документация по присоединённому сигналу

pressed()

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

Сигнал может быть присоединён к любому элементу, всплывающему окну или окну. При присоединении к элементу или всплывающему окну сигнал генерируется только если элемент или всплывающее окно находятся в окне.

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

released()

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

Сигнал может быть присоединён к любому элементу, всплывающему окну или окну. При присоединении к элементу или всплывающему окну сигнал генерируется только если элемент или всплывающее окно находятся в окне.

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