QPlatformSurfaceEvent Class

The QPlatformSurfaceEvent class is used to notify about native platform surface events. More...

Header: #include <QPlatformSurfaceEvent>
CMake: find_package(Qt6 COMPONENTS Gui REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Since: Qt 5.5
Inherits: QEvent

Public Types

enum SurfaceEventType { SurfaceCreated, SurfaceAboutToBeDestroyed }

Public Functions

QPlatformSurfaceEvent(QPlatformSurfaceEvent::SurfaceEventType surfaceEventType)
QPlatformSurfaceEvent::SurfaceEventType surfaceEventType() const

Detailed Description

Platform window events are synchronously sent to windows and offscreen surfaces when their underlying native surfaces are created or are about to be destroyed.

Applications can respond to these events to know when the underlying platform surface exists.

Member Type Documentation

enum QPlatformSurfaceEvent::SurfaceEventType

This enum describes the type of platform surface event. The possible types are:

ConstantValueDescription
QPlatformSurfaceEvent::SurfaceCreated0The underlying native surface has been created
QPlatformSurfaceEvent::SurfaceAboutToBeDestroyed1The underlying native surface will be destroyed immediately after this event

The SurfaceAboutToBeDestroyed event type is useful as a means of stopping rendering to a platform window before it is destroyed.

Member Function Documentation

QPlatformSurfaceEvent::QPlatformSurfaceEvent(QPlatformSurfaceEvent::SurfaceEventType surfaceEventType)

Constructs a platform surface event for the given surfaceEventType.

QPlatformSurfaceEvent::SurfaceEventType QPlatformSurfaceEvent::surfaceEventType() const

Returns the specific type of platform surface event.