Struct ChangeGCRequest

pub struct ChangeGCRequest<'input> {
    pub gc: u32,
    pub value_list: Cow<'input, ChangeGCAux>,
}

change graphics context components.

Changes the components specified by value_mask for the specified graphics context.

Fields

• gc - The graphics context to change.
• value_list - Values for each of the components specified in the bitmask value_mask. The order has to correspond to the order of possible value_mask bits. See the example.

Errors

• Font - TODO: reasons?
• GContext - TODO: reasons?
• Match - TODO: reasons?
• Pixmap - TODO: reasons?
• Value - TODO: reasons?
• Alloc - The X server could not allocate the requested resources (no memory?).

Example

/*
 * Changes the foreground color component of the specified graphics context.
 *
 */
void my_example(xcb_connection_t *conn, xcb_gcontext_t gc, uint32_t fg, uint32_t bg) {
    /* C99 allows us to use a compact way of changing a single component: */
    xcb_change_gc(conn, gc, XCB_GC_FOREGROUND, (uint32_t[]){ fg });

    /* The more explicit way. Beware that the order of values is important! */
    uint32_t mask = 0;
    mask |= XCB_GC_FOREGROUND;
    mask |= XCB_GC_BACKGROUND;

    uint32_t values[] = {
        fg,
        bg
    };
    xcb_change_gc(conn, gc, mask, values);
    xcb_flush(conn);
}

Fields

gc: u32

value_list: Cow<'input, ChangeGCAux>

Implementations

impl<'input> ChangeGCRequest<'input>

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

Serialize this request into bytes for the provided connection

pub fn into_owned(self) -> ChangeGCRequest<'static>

Clone all borrowed data in this ChangeGCRequest.

Trait Implementations

impl<'input> Clone for ChangeGCRequest<'input>

fn clone(&self) -> ChangeGCRequest<'input>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ChangeGCRequest<'_>

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

Formats the value using the given formatter.

impl<'input> Default for ChangeGCRequest<'input>

fn default() -> ChangeGCRequest<'input>

Returns the “default value” for a type.

impl<'input> Request for ChangeGCRequest<'input>

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<'input> VoidRequest for ChangeGCRequest<'input>