Function x11rb::protocol::xproto::create_window
source · pub fn create_window<'c, 'input, Conn>(
conn: &'c Conn,
depth: u8,
wid: Window,
parent: Window,
x: i16,
y: i16,
width: u16,
height: u16,
border_width: u16,
class: WindowClass,
visual: Visualid,
value_list: &'input CreateWindowAux
) -> Result<VoidCookie<'c, Conn>, ConnectionError>where
Conn: RequestConnection + ?Sized,Expand description
Creates a window.
Creates an unmapped window as child of the specified parent window. A
CreateNotify event will be generated. The new window is placed on top in the
stacking order with respect to siblings.
The coordinate system has the X axis horizontal and the Y axis vertical with the origin [0, 0] at the upper-left corner. Coordinates are integral, in terms of pixels, and coincide with pixel centers. Each window and pixmap has its own coordinate system. For a window, the origin is inside the border at the inside, upper-left corner.
The created window is not yet displayed (mapped), call xcb_map_window to
display it.
The created window will initially use the same cursor as its parent.
Fields
wid- The ID with which you will refer to the new window, created byxcb_generate_id.depth- Specifies the new window’s depth (TODO: what unit?).
The special value XCB_COPY_FROM_PARENT means the depth is taken from the
parent window.
visual- Specifies the id for the new window’s visual.
The special value XCB_COPY_FROM_PARENT means the visual is taken from the
parent window.
class-parent- The parent window of the new window.border_width- TODO:
Must be zero if the class is InputOnly or a xcb_match_error_t occurs.
x- The X coordinate of the new window.y- The Y coordinate of the new window.width- The width of the new window.height- The height of the new window.
Errors
Colormap- TODO: reasons?Match- TODO: reasons?Cursor- TODO: reasons?Pixmap- TODO: reasons?Value- TODO: reasons?Window- TODO: reasons?Alloc- The X server could not allocate the requested resources (no memory?).
See
xcb_generate_id: functionMapWindow: requestCreateNotify: event