Trait wayland_client::Proxy [−] [src]

pub trait Proxy {
    fn ptr(&self) -> *mut wl_proxy;
    unsafe fn from_ptr_new(_: *mut wl_proxy) -> Self;
    unsafe fn from_ptr_initialized(_: *mut wl_proxy) -> Self;
    fn interface_ptr() -> *const wl_interface;
    fn interface_name() -> &'static str;
    fn supported_version() -> u32;
    fn version(&self) -> u32;
    fn is_alive(&self) -> bool;
    fn equals(&self, _: &Self) -> bool;
    fn set_user_data(&self, ptr: *mut ());
    fn get_user_data(&self) -> *mut ();
}

Common routines for wayland proxy objects.

All wayland objects automatically implement this trait as generated by the scanner.

It is mostly used for internal use by the library, and you should only need these methods for interfacing with C library working on wayland objects.

Required Methods

Pointer to the underlying wayland proxy object

Create an instance from a wayland pointer

The pointer must refer to a valid wayland proxy of the appropriate interface, but that have not yet been seen by the library.

The library will take control of the object (notably overwrite its user_data).

Create an instance from a wayland pointer

The pointer must refer to a valid wayland proxy of the appropriate interface, and have already been initialized by the library (it'll assume this proxy user_data contains a certain kind of data).

Pointer to the interface representation

Internal wayland name of this interface

Max version of this interface supported

Current version of the interface this proxy is instanciated with

Check if the proxt behind this handle is actually still alive

Check of two handles are actually the same wayland object

Returns false if any of the objects has already been destroyed

Set a pointer associated as user data on this proxy

All proxies to the same wayland object share the same user data pointer.

The get/set operations are atomic, no more guarantee is given. If you need to synchronise access to this data, it is your responsibility to add a Mutex or any other similar mechanism.

Get the pointer associated as user data on this proxy

All proxies to the same wayland object share the same user data pointer.

See set_user_data for synchronisation guarantee.

Implementors