---
name: "wayland_server_xdg_activation_v1_t"
section: "3"
platform: "linux"
package: "waylandpp-dev"
version: "1.0.0-6+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/wayland_server_xdg_activation_v1_t"
---

# wayland\_server\_xdg\_activation\_v1\_t(3)

interface for activating surfaces

## NAME

wayland::server::xdg\_activation\_v1\_t - interface for activating surfaces

## SYNOPSIS

`#include <wayland-server-protocol-unstable.hpp>`

Inherits wayland::server::resource\_t.

### Public Member Functions

std::function\< void()\> & **on\_destroy** ()\
 destroy the xdg\_activation object  std::function\< void(**xdg\_activation\_token\_v1\_t**)\> & **on\_get\_activation\_token** ()\
 requests a token  std::function\< void(std::string, **surface\_t**)\> & **on\_activate** ()\
 notify new interaction being available  bool **proxy\_has\_object** () const\
 Check whether this wrapper actually wraps an object.  void **post\_no\_memory** () const\
 uint32\_t **get\_id** () const\
 client\_t **get\_client** () const\
 unsigned int **get\_version** () const\
 std::string **get\_class** ()\

## Detailed Description

interface for activating surfaces

A global interface used for informing the compositor about applications being activated or started, or for applications to request to be activated.

Definition at line **7514** of file **wayland-server-protocol-unstable.hpp**.

## Member Function Documentation

### std::string wayland::server::resource\_t::get\_class ()` [inherited]`

Retrieve the interface name (class) of a resource object.

**Returns**

Interface name of the resource object.

### client\_t wayland::server::resource\_t::get\_client () const` [inherited]`

Get the associated client

**Returns**

the client that owns the resource.

### uint32\_t wayland::server::resource\_t::get\_id () const` [inherited]`

Get the internal ID of the resource

**Returns**

the internal ID of the resource

### unsigned int wayland::server::resource\_t::get\_version () const` [inherited]`

Get interface version

**Returns**

Interface version this resource has been constructed with.

### std::function\< void(std::string, surface\_t)\> & xdg\_activation\_v1\_t::on\_activate ()

notify new interaction being available

**Parameters**

*token* the activation token of the initiating client \
 *surface* the wl\_surface to activate

Requests surface activation. It's up to the compositor to display this information as desired, for example by placing the surface above the rest.

The compositor may know who requested this by checking the activation token and might decide not to follow through with the activation if it's considered unwanted.

Compositors can ignore unknown presentation tokens when an invalid token is passed.

Definition at line **7435** of file **wayland-server-protocol-unstable.cpp**.

### std::function\< void()\> & xdg\_activation\_v1\_t::on\_destroy ()

destroy the xdg\_activation object Notify the compositor that the xdg\_activation object will no longer be used.

The child objects created via this interface are unaffected and should be destroyed separately.

Definition at line **7423** of file **wayland-server-protocol-unstable.cpp**.

### std::function\< void(xdg\_activation\_token\_v1\_t)\> & xdg\_activation\_v1\_t::on\_get\_activation\_token ()

requests a token

**Parameters**

*id*

Creates an xdg\_activation\_token\_v1 object that will provide the initiating client with a unique token for this activation. This token should be offered to the clients to be activated.

Definition at line **7429** of file **wayland-server-protocol-unstable.cpp**.

### void wayland::server::resource\_t::post\_no\_memory () const` [inherited]`

Post 'not enough memory' error to the client

If the compositor has not enough memory to fulfill a certail request of the client, this function can be called to notify the client of this circumstance.

### bool wayland::server::resource\_t::proxy\_has\_object () const` [inherited]`

Check whether this wrapper actually wraps an object.

**Returns**

true if there is an underlying object, false if this wrapper is empty

## Author

Generated automatically by Doxygen for Wayland++ from the source code.