XESetWireToEvent Extension Function

Purpose

Defines a procedure to call when an event is to be converted from wire format to host format.

Library

Enhanced X-Windows Library (libX11.a)

C Syntax

int (*XESetWireToEvent(DisplayPtr, EventNumber, Procedure))()
Display *DisplayPtr;
int EventNumber;
Bool (*Procedure)();

Description

The XESetWireToEvent extension function defines a procedure to call when an event is converted from wire format (the xEvent structure in the <X11/Xproto.h> header file) to host format (the XEvent structure in the <X11/Xlib.h> header file).

The XESetWireToEvent extension function returns any previously defined procedure.

Note: The host event structure size cannot be bigger than the size of the XEvent extension function union of structures.

When the Xlib library needs to convert an event from wire format to natural host format, the XESetWireToEvent extension function is called with the following syntax:

Status(*Procedure)(DisplayPtr, Re, Event);
Display *DisplayPtr;
XEvent *Re;
xEvent Event;

where:

• The Re parameter is a pointer to where the host format event should be stored. It is the source (the information to be converted).
• The Event parameter is the 32-byte wire event structure. It is the destination (the structure that needs to be filled).

In the XEvent structure, the type field must be the first field and the window field must be the second field. Copy the type field with the type specified for the xEvent structure. Copy all other fields from the xEvent structure (wire format) to the XEvent structure (host format).

Parameters

Related Information

Using Extensions in AIXwindows in AIX Version 4.3 AIXwindows Programming Guide.

AIXwindows Overview for Programmers in AIX Version 4.3 AIXwindows Programming Guide.