Struct GlobalList 

pub struct GlobalList { /* private fields */ }

A helper for global initialization.

See the module level documentation for more.

Implementations

impl GlobalList

pub fn contents(&self) -> &GlobalListContents

Access the contents of the list of globals

pub fn bind_singleton<I, State, U>( &self, qh: &QueueHandle<State>, version: RangeInclusive<u32>, udata: U, ) -> Result<I, BindError>

where I: Proxy + 'static, State: 'static, U: Dispatch<I, State> + Send + Sync + 'static,

Binds a global, returning a new protocol object associated with the global.

The version specifies the range of versions that should be bound. This function will guarantee the version of the returned protocol object is the lower of the maximum requested version and the advertised version.

If the lower bound of the version is greater than the version advertised by the server, then BindError::UnsupportedVersion is returned.

Multi-instance/Device globals.

This function is not intended to be used with globals that have multiple instances such as wl_output and wl_seat. These types of globals need their own initialization mechanism because these multi-instance globals may be removed at runtime. To handle then, you should instead call Self::bind_specific in the GlobalListHandler of your State.

Panics

This function will panic if the maximum requested version is greater than the known maximum version of the interface. The known maximum version is determined by the code generated using wayland-scanner.

pub fn bind_specific<I, State, U>( &self, qh: &QueueHandle<State>, name: u32, version: RangeInclusive<u32>, udata: U, ) -> Result<I, BindError>

where I: Proxy + 'static, State: 'static, U: Dispatch<I, State> + Send + Sync + 'static,

Binds a global, returning a new object associated with the global.

This binds a specific object by its name.

Typically, this should be called in GlobalListHandler::runtime_add_global for dynamically added globals.

pub fn registry(&self) -> &WlRegistry

Returns the WlRegistry protocol object.

This may be used if more direct control when creating globals is needed.

pub fn destroy(self)

Tries to destroy the WlRegistry protocol object.

If successful no new events will be emitted and the GlobalListContent will not be updated anymore. Other proocol objects are not affected.

This might end up doing nothing if the compositor doesn’t support wl_fixes in which case the registry cannot be destroyed without closing the connection.

Trait Implementations

impl Clone for GlobalList

fn clone(&self) -> GlobalList

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GlobalList

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.