Struct x11rb::protocol::xproto::GetPropertyRequest

pub struct GetPropertyRequest {
    pub delete: bool,
    pub window: u32,
    pub property: u32,
    pub type_: u32,
    pub long_offset: u32,
    pub long_length: u32,
}

Gets a window property.

Gets the specified property from the specified window. Properties are for example the window title (WM_NAME) or its minimum size (WM_NORMAL_HINTS). Protocols such as EWMH also use properties - for example EWMH defines the window title, encoded as UTF-8 string, in the _NET_WM_NAME property.

TODO: talk about type

TODO: talk about delete

TODO: talk about the offset/length thing. what’s a valid use case?

Fields

• window - The window whose property you want to get.
• delete - Whether the property should actually be deleted. For deleting a property, the specified type has to match the actual property type.
• property - The property you want to get (an atom).
• type - The type of the property you want to get (an atom).
• long_offset - Specifies the offset (in 32-bit multiples) in the specified property where the data is to be retrieved.
• long_length - Specifies how many 32-bit multiples of data should be retrieved (e.g. if you set long_length to 4, you will receive 16 bytes of data).

Errors

• Window - The specified window does not exist.
• Atom - property or type do not refer to a valid atom.
• Value - The specified long_offset is beyond the actual property length (e.g. the property has a length of 3 bytes and you are setting long_offset to 1, resulting in a byte offset of 4).

See

• InternAtom: request
• xprop: program

Example

/*
 * Prints the WM_NAME property of the window.
 *
 */
void my_example(xcb_connection_t *c, xcb_window_t window) {
    xcb_get_property_cookie_t cookie;
    xcb_get_property_reply_t *reply;

    /* These atoms are predefined in the X11 protocol. */
    xcb_atom_t property = XCB_ATOM_WM_NAME;
    xcb_atom_t type = XCB_ATOM_STRING;

    // TODO: a reasonable long_length for WM_NAME?
    cookie = xcb_get_property(c, 0, window, property, type, 0, 0);
    if ((reply = xcb_get_property_reply(c, cookie, NULL))) {
        int len = xcb_get_property_value_length(reply);
        if (len == 0) {
            printf("TODO\\n");
            free(reply);
            return;
        }
        printf("WM_NAME is %.*s\\n", len,
               (char*)xcb_get_property_value(reply));
    }
    free(reply);
}

Fields

delete: bool

window: u32

property: u32

type_: u32

long_offset: u32

long_length: u32

Implementations

impl GetPropertyRequest

pub fn serialize(self) -> ([Cow<'static, [u8]>; 1], Vec<OwnedFd>)

Serialize this request into bytes for the provided connection

pub fn try_parse_request( header: RequestHeader, value: &[u8] ) -> Result<GetPropertyRequest, ParseError>

Parse this request given its header, its body, and any fds that go along with it

Trait Implementations

impl Clone for GetPropertyRequest

fn clone(&self) -> GetPropertyRequest

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GetPropertyRequest

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

Formats the value using the given formatter.

impl Default for GetPropertyRequest

fn default() -> GetPropertyRequest

Returns the “default value” for a type.

impl Hash for GetPropertyRequest

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for GetPropertyRequest

fn cmp(&self, other: &GetPropertyRequest) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for GetPropertyRequest

fn eq(&self, other: &GetPropertyRequest) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for GetPropertyRequest

fn partial_cmp(&self, other: &GetPropertyRequest) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl ReplyRequest for GetPropertyRequest

type Reply = GetPropertyReply

The kind of reply that this request generates.

impl Request for GetPropertyRequest

const EXTENSION_NAME: Option<&'static str> = None

The protocol name of the extension that this request belongs to, or None for core requests

fn serialize(self, _major_opcode: u8) -> (Vec<u8>, Vec<OwnedFd>)

Serialize this request into its X11 protocol wire representation.

impl Copy for GetPropertyRequest

impl Eq for GetPropertyRequest

impl StructuralPartialEq for GetPropertyRequest