wayland_server::backend

Trait GlobalHandler

pub trait GlobalHandler<D>: DowncastSync {
    // Required method
    fn bind(
        self: Arc<Self>,
        handle: &Handle,
        data: &mut D,
        client_id: ClientId,
        global_id: GlobalId,
        object_id: ObjectId,
    ) -> Arc<dyn ObjectData<D>>;

    // Provided methods
    fn can_view(
        &self,
        _client_id: ClientId,
        _client_data: &Arc<dyn ClientData>,
        _global_id: GlobalId,
    ) -> bool { ... }
    fn debug(&self, f: &mut Formatter<'_>) -> Result<(), Error> { ... }
}
Expand description

A trait representing the handling of new bound globals

Required Methods§

fn bind( self: Arc<Self>, handle: &Handle, data: &mut D, client_id: ClientId, global_id: GlobalId, object_id: ObjectId, ) -> Arc<dyn ObjectData<D>>

A global has been bound

Given client bound given global, creating given object.

The method must return the object data for the newly created object.

Provided Methods§

fn can_view( &self, _client_id: ClientId, _client_data: &Arc<dyn ClientData>, _global_id: GlobalId, ) -> bool

Check if given client is allowed to interact with given global

If this function returns false, the client will not be notified of the existence of this global, and any attempt to bind it will result in a protocol error as if the global did not exist.

Default implementation always return true.

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

Helper for forwarding a Debug implementation of your GlobalHandler type

By default will just print GlobalHandler { ... }

Implementations§

§

impl<D> dyn GlobalHandler<D>
where D: Any + 'static,

pub fn is<__T>(&self) -> bool
where __T: GlobalHandler<D>,

Returns true if the trait object wraps an object of type __T.

pub fn downcast<__T>( self: Box<dyn GlobalHandler<D>>, ) -> Result<Box<__T>, Box<dyn GlobalHandler<D>>>
where __T: GlobalHandler<D>,

Returns a boxed object from a boxed trait object if the underlying object is of type __T. Returns the original boxed trait if it isn’t.

pub fn downcast_rc<__T>( self: Rc<dyn GlobalHandler<D>>, ) -> Result<Rc<__T>, Rc<dyn GlobalHandler<D>>>
where __T: GlobalHandler<D>,

Returns an Rc-ed object from an Rc-ed trait object if the underlying object is of type __T. Returns the original Rc-ed trait if it isn’t.

pub fn downcast_ref<__T>(&self) -> Option<&__T>
where __T: GlobalHandler<D>,

Returns a reference to the object within the trait object if it is of type __T, or None if it isn’t.

pub fn downcast_mut<__T>(&mut self) -> Option<&mut __T>
where __T: GlobalHandler<D>,

Returns a mutable reference to the object within the trait object if it is of type __T, or None if it isn’t.

pub fn downcast_arc<__T>( self: Arc<dyn GlobalHandler<D>>, ) -> Result<Arc<__T>, Arc<dyn GlobalHandler<D>>>
where __T: GlobalHandler<D> + Any + Send + Sync,

Returns an Arc-ed object from an Arc-ed trait object if the underlying object is of type __T. Returns the original Arc-ed trait if it isn’t.

Trait Implementations§

§

impl<D> Debug for dyn GlobalHandler<D>
where D: 'static,

§

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

Formats the value using the given formatter. Read more

Implementors§