QPlatformSurfaceEvent Class

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

Header: #include <QPlatformSurfaceEvent>
qmake: QT += gui
Since: Qt 5.5
Inherits: QEvent

This class was introduced in Qt 5.5.

Public Types

enum SurfaceEventType { SurfaceCreated, SurfaceAboutToBeDestroyed }

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.