xcbsendevent(3) XCB Requests xcbsendevent(3)

NAME
       xcbsendevent - send an event

SYNOPSIS
       #include 

   Request function
       xcbvoidcookiet xcbsendevent(xcbconnectiont *conn,
              uint8t propagate, xcbwindowt destination,
              uint32t eventmask, const char *event);

REQUEST ARGUMENTS
       conn      The XCB connection to X11.

       propagate If propagate is true and no clients have selected any event
                 on destination, the destination is replaced with the closest
                 ancestor of destination for which some client has selected a
                 type in eventmask and for which no intervening window has
                 that type in its do-not-propagate-mask. If no such window ex‐
                 ists or if the window is an ancestor of the focus window and
                 InputFocus was originally specified as the destination, the
                 event is not sent to any clients. Otherwise, the event is re‐
                 ported to every client selecting on the final destination any
                 of the types specified in eventmask.

       destination
                 The window to send this event to. Every client which selects
                 any event within eventmask on destination will get the
                 event.

                 The special value XCBSENDEVENTDESTPOINTERWINDOW refers
                 to the window that contains the mouse pointer.

                 The special value XCBSENDEVENTDESTITEMFOCUS refers to
                 the window which has the keyboard focus.

       eventmask
                 Eventmask for determining which clients should receive the
                 specified event.  See destination and propagate.

       event     The event to send to the specified destination.

DESCRIPTION
       Identifies the destination window, determines which clients should re‐
       ceive the specified event and ignores any active grabs.

       The event must be one of the core events or an event defined by an ex‐
       tension, so that the X server can correctly byte-swap the contents as
       necessary. The contents of event are otherwise unaltered and unchecked
       except for the sendevent field which is forced to 'true'.

RETURN VALUE
       Returns an xcbvoidcookiet. Errors (if any) have to be handled in the
       event loop.

       If you want to handle errors directly with xcbrequestcheck instead,
       use xcbsendeventchecked. See xcb-requests(3) for details.

ERRORS
       xcbvalueerrort
                 The given event is neither a core event nor an event defined
                 by an extension.

       xcbwindowerrort
                 The specified destination window does not exist.

EXAMPLE
       /*
        * Tell the given window that it was configured to a size of 800x600 pixels.
        *
        */
       void myexample(xcbconnectiont *conn, xcbwindowt window) {
           /* Every X11 event is 32 bytes long. Therefore, XCB will copy 32 bytes.
            * In order to properly initialize these bytes, we allocate 32 bytes even
            * though we only need less for an xcbconfigurenotifyeventt */
           xcbconfigurenotifyeventt *event = calloc(32, 1);

           event->event = window;
           event->window = window;
           event->responsetype = XCBCONFIGURENOTIFY;

           event->x = 0;
           event->y = 0;
           event->width = 800;
           event->height = 600;

           event->borderwidth = 0;
           event->abovesibling = XCBNONE;
           event->overrideredirect = false;

           xcbsendevent(conn, false, window, XCBEVENTMASKSTRUCTURENOTIFY,
                          (char*)event);
           xcbflush(conn);
           free(event);
       }

SEE ALSO
       xcb-requests(3), xcb-examples(3), xcbconfigurenotifyeventt(3)

AUTHOR
       Generated from xproto.xml. Contact xcb@lists.freedesktop.org for cor‐
       rections and improvements.



X Version 11                      libxcb 1.13                xcbsendevent(3)