blob: 210b5c3f61a13cfd467944821da1e5254468e793 (
plain) (
tree)
|
|
.TH LIBAXL_REQUEST_CREATE_WINDOW 3 libaxl
.SH NAME
LIBAXL_REQUEST_CREATE_WINDOW - Create an unmapped window
.SH SYNOPSIS
.nf
#include <libaxl.h>
#define LIBAXL_REQUEST_CREATE_WINDOW_BACKGROUND_PIXMAP 0x00000001UL
#define LIBAXL_REQUEST_CREATE_WINDOW_BACKGROUND_PIXEL 0x00000002UL
#define LIBAXL_REQUEST_CREATE_WINDOW_BORDER_PIXMAP 0x00000004UL
#define LIBAXL_REQUEST_CREATE_WINDOW_BORDER_PIXEL 0x00000008UL
#define LIBAXL_REQUEST_CREATE_WINDOW_BIT_GRAVITY 0x00000010UL
#define LIBAXL_REQUEST_CREATE_WINDOW_WIN_GRAVITY 0x00000020UL
#define LIBAXL_REQUEST_CREATE_WINDOW_BACKING_STORE 0x00000040UL
#define LIBAXL_REQUEST_CREATE_WINDOW_BACKING_PLANES 0x00000080UL
#define LIBAXL_REQUEST_CREATE_WINDOW_BACKING_PIXEL 0x00000100UL
#define LIBAXL_REQUEST_CREATE_WINDOW_OVERRIDE_REDIRECT 0x00000200UL
#define LIBAXL_REQUEST_CREATE_WINDOW_SAVE_UNDER 0x00000400UL
#define LIBAXL_REQUEST_CREATE_WINDOW_EVENT_MASK 0x00000800UL
#define LIBAXL_REQUEST_CREATE_WINDOW_DO_NOT_PROPAGATE_MASK 0x00001000UL
#define LIBAXL_REQUEST_CREATE_WINDOW_COLORMAP 0x00002000UL
#define LIBAXL_REQUEST_CREATE_WINDOW_CURSOR 0x00004000UL
#define LIBAXL_REQUEST_CREATE_WINDOW 1
struct libaxl_request_create_window {
uint8_t \fIopcode\fP;
uint8_t \fIdepth\fP;
uint16_t \fI_request_length\fP;
libaxl_window_t \fIwid\fP;
libaxl_window_t \fIparent\fP;
int16_t \fIx\fP;
int16_t \fIy\fP;
uint16_t \fIwidth\fP;
uint16_t \fIheight\fP;
uint16_t \fIborder_width\fP;
uint16_t \fIclass\fP;
libaxl_visual_t \fIvisual\fP;
uint32_t \fIvalue_mask\fP;
libaxl_pixmap_t \fIbackground_pixmap\fP;
uint32_t \fIbackground_pixel\fP;
libaxl_pixmap_t \fIborder_pixmap\fP;
uint32_t \fIborder_pixel\fP;
uint8_t \fIbit_gravity\fP;
uint8_t \fIwin_gravity\fP;
uint8_t \fIbacking_store\fP;
uint8_t \fI__omitted1\fP;
uint32_t \fIbacking_planes\fP;
uint32_t \fIbacking_pixel\fP;
libaxl_bool_t \fIoverride_redirect\fP;
libaxl_bool_t \fIsave_under\fP;
uint16_t \fI__omitted2\fP;
uint32_t \fIevent_mask\fP;
uint32_t \fIdo_not_propagate_mask\fP;
libaxl_colormap_t \fIcolormap\fP;
libaxl_cursor_t \fIcursor\fP;
};
.fi
.SH DESCRIPTION
The display server shall create an unmapped
window, with the ID specified in the
.I wid
field, which shall be an unused ID generated
with the
.BR libaxl_generate_id (3)
function.
.PP
The value of the
.I opcode
field shall be
.I LIBAXL_REQUEST_CREATE_WINDOW
to signify that the request is of the
request described in this document.
.PP
Other fields are filled in automatically by the
.BR libaxl_send_request (3)
function.
.SH ERRORS
.TP
.BR LIBAXL_ERROR_ALLOC (3)
The display server failed to allocate
enough memory to fulfil the request.
.TP
.BR LIBAXL_ERROR_ID_CHOICE (3)
The specified ID for the window
.RI ( wid )
is outside the range of IDs allocated to
the client or is already in use. Use the
.BR libaxl_generate_id (3)
function to avoid this error.
.SH REPLIES
None.
.SH SEE ALSO
.BR libaxl_send_request (3),
.BR libaxl_generate_id (3),
.BR LIBAXL_REQUEST_MAP_WINDOW (3),
.BR LIBAXL_REQUEST_DESTROY_WINDOW (3),
.BR LIBAXL_REQUEST_REPARENT_WINDOW (3)
|
