QWaylandSurface Class

Documentación de las funciones miembro

QWaylandSurface::QWaylandSurface()

Construye una QWaylandSurface no inicializada.

QWaylandSurface::QWaylandSurface(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

Construye e inicializa una QWaylandSurface para los datos compositor y client, y con los datos id y version.

[override virtual noexcept] QWaylandSurface::~QWaylandSurface()

Destruye el QWaylandSurface.

[signal] void QWaylandSurface::childAdded(QWaylandSurface *child)

Esta señal se emite cuando se ha añadido una wl_subsuperficie, child, a la superficie.

QWaylandCompositor *QWaylandSurface::compositor() const

Devuelve el compositor para este QWaylandSurface.

[invokable] void QWaylandSurface::destroy()

Destruye la página QWaylandSurface.

[signal] void QWaylandSurface::dragStarted(QWaylandDrag *drag)

Esta señal se emite cuando se ha iniciado un drag desde esta superficie.

[invokable] void QWaylandSurface::frameStarted()

Prepara todas las retrollamadas de fotogramas para su envío.

[static] QWaylandSurface *QWaylandSurface::fromResource(wl_resource *resource)

Devuelve el QWaylandSurface correspondiente al recurso Wayland resource.

[invokable] void QWaylandSurface::initialize(QWaylandCompositor *compositor, QWaylandClient *client, uint id, int version)

Inicializa el QWaylandSurface con los datos compositor y client, y con los datos id y version.

bool QWaylandSurface::inputRegionContains(const QPoint &p) const

Devuelve true si la región de entrada de QWaylandSurface contiene el punto p. En caso contrario, devuelve false.

bool QWaylandSurface::inputRegionContains(const QPointF &position) const

Devuelve true si la región de entrada de QWaylandSurface contiene el punto position. En caso contrario, devuelve false.

[invokable] bool QWaylandSurface::isDestroyed() const

Devuelve true si el QWaylandSurface ha sido destruido. En caso contrario devuelve false.

bool QWaylandSurface::isInitialized() const

Devuelve true si se ha inicializado QWaylandSurface.

QWaylandView *QWaylandSurface::primaryView() const

Devuelve la vista principal de este QWaylandSurface.

Véase también QWaylandView::advance() y QWaylandSurface::setPrimaryView().

struct wl_resource *QWaylandSurface::resource() const

Devuelve el recurso Wayland correspondiente a este QWaylandSurface.

[invokable] void QWaylandSurface::sendFrameCallbacks()

Envía las retrollamadas de fotogramas pendientes.

void QWaylandSurface::setPrimaryView(QWaylandView *view)

Establece la vista principal de QWaylandSurface en view, en caso de que haya varias vistas de esta superficie. La vista primaria es la vista que rige la frecuencia de actualización del cliente. Se encarga de descartar las referencias del buffer cuando se llama a QWaylandView::advance(). Consulta la documentación de QWaylandView::advance() para más detalles.

En integraciones de superficies shell, como QWaylandWlShellIntegration y QWaylandXdgShellV5Integration, las peticiones de maximizar y pantalla completa desde el cliente solo tendrán efecto si la integración tiene la vista primaria de la superficie.

Véase también primaryView() y QWaylandView::advance().

bool QWaylandSurface::setRole(QWaylandSurfaceRole *role, wl_resource *errorResource, uint32_t errorCode)

Establece un role en la superficie. Un rol define cómo se mapeará una superficie en pantalla; sin un rol se supone que una superficie está oculta. Una vez que se asigna un rol a una superficie, éste se convierte en su rol permanente. Cualquier llamada posterior a setRole() con un rol diferente provocará un error de protocolo a errorResource y enviará un errorCode al cliente. Cumplir este requisito es el principal objetivo del rol de superficie.

role se compara por el valor del puntero. Dos objetos cualesquiera de QWaylandSurfaceRole se considerarán roles diferentes, independientemente de sus nombres.

El rol de superficie es establecido internamente por las implementaciones de protocolo cuando se adopta una superficie para un propósito específico, por ejemplo en una extensión de shell. A menos que esté desarrollando extensiones que utilicen superficies de esta forma, no debería llamar a esta función.

Devuelve true si se puede asignar un rol; false en caso contrario.

[signal] void QWaylandSurface::surfaceDestroyed()

Esta señal se emite cuando se destruye la wl_surface correspondiente.

[slot] void QWaylandSurface::updateSelection()

Actualiza la superficie con la selección retenida en el portapapeles del compositor. Aunque esto se hace automáticamente cuando la superficie recibe el foco del teclado, esta función es útil para actualizar clientes que no tienen el foco del teclado.

QList<QWaylandView *> QWaylandSurface::views() const

Devuelve las vistas de este QWaylandSurface.

wl_client *QWaylandSurface::waylandClient() const

Sujeta el wl_client utilizando este QWaylandSurface.