DECwindows Motif for OpenVMS Guide to Non-C Bindings

3.39 Modifier Keymap Data Structure

Figure 3-39 illustrates the modifier keymap data structure (X$MODIFIER_KEYMAP).

Figure 3-39 Modifier Keymap Data Structure

Table 3-41 describes the members of the motion event data structure.

Table 3-41 Motion Event Data Structure Members
Member Name Contents

X$L_MTEV_TYPE Type of event reported. The member can have only the value specified by the constant x$c_motion_notify.

X$L_MTEV_SERIAL Number of the last request processed by the server.

X$L_MTEV_SEND_EVENT Value defined by the constant true if the event came from a SEND EVENT request.

X$A_MTEV_DISPLAY Display on which the event occurred.

X$L_MTEV_WINDOW Event window.

X$L_MTEV_ROOT Root window in which the event occurred.

X$L_MTEV_SUBWINDOW Source window in which the event occurred.

X$L_MTEV_TIME Time in milliseconds at which the event occurred.

X$L_MTEV_X The x value of the pointer coordinates in the source window.

X$L_MTEV_Y The y value of the pointer coordinates in the source window.

X$L_MTEV_X_ROOT The x value of the pointer coordinates relative to the root window.

X$L_MTEV_Y_ROOT The y value of the pointer coordinates relative to the root window.

X$L_MTEV_STATE State of the button just prior to the event. Xlib can set this member to the bitwise OR of one or more of the following masks:

x$m_button1 x$m_mod1

x$m_button2 x$m_mod2

x$m_button3 x$m_mod3

x$m_button4 x$m_mod4

x$m_button5 x$m_mod5

X$B_MTEV_IS_HINT Indicates that motion hints are active. No other events reported until pointer moves out of window.

X$L_MTEV_SAME_SCREEN Indicates whether or not the event window is on the same screen as the root window.

3.41 No Expose Event Data Structure

Figure 3-41 illustrates the no expose event data structure (X$NO_EXPOSE_EVENT).

Figure 3-41 No Expose Event Data Structure

Table 3-43 describes the members of the pixmap format values data structure.

Table 3-43 Pixmap Format Values Data Structure Members
Member Name Contents

X$L_PFV_DEPTH Depth of screen

X$L_PFV_BITS_PER_PIXEL Number of bits used to hold each pixel

X$L_PFV_SCANLINE_PAD Specifies whether padding should be done in units of 8, 16, or 32 bits

**Table 3-43 Pixmap Format Values Data Structure Members**
Member Name	Contents
X$L_PFV_DEPTH	Depth of screen
X$L_PFV_BITS_PER_PIXEL	Number of bits used to hold each pixel
X$L_PFV_SCANLINE_PAD	Specifies whether padding should be done in units of 8, 16, or 32 bits

3.43 Point Data Structure

Figure 3-43 illustrates the point data structure (X$POINT).

Figure 3-43 Point Data Structure

Table 3-45 describes the members of the property event data structure.

Table 3-45 Property Event Data Structure Members
Member Name Contents

X$L_PPEV_TYPE Value defined by the x$c_property_notify constant.

X$L_PPEV_SERIAL Number of the last request processed by the server.

X$L_PPEV_SEND_EVENT Value defined by the constant true if the event came from a SEND EVENT request.

X$A_PPEV_DISPLAY Display on which the event occurred.

X$L_PPEV_WINDOW Window whose property was changed.

X$L_PPEV_ATOM Identifies the property that was changed.

X$L_PPEV_TIME Server time that the property changed.

X$L_PPEV_STATE Value specified by the constant x$c_property_new_value if a client changes a property by calling either the CHANGE PROPERTY or the ROTATE PROPERTY routine.

**Table 3-45 Property Event Data Structure Members**
Member Name	Contents
X$L_PPEV_TYPE	Value defined by the x$c_property_notify constant.
X$L_PPEV_SERIAL	Number of the last request processed by the server.
X$L_PPEV_SEND_EVENT	Value defined by the constant true if the event came from a SEND EVENT request.
X$A_PPEV_DISPLAY	Display on which the event occurred.
X$L_PPEV_WINDOW	Window whose property was changed.
X$L_PPEV_ATOM	Identifies the property that was changed.
X$L_PPEV_TIME	Server time that the property changed.
X$L_PPEV_STATE	Value specified by the constant x$c_property_new_value if a client changes a property by calling either the CHANGE PROPERTY or the ROTATE PROPERTY routine.

3.45 Rectangle Data Structure

Figure 3-45 illustrates the rectangle data structure (X$RECTANGLE).

Figure 3-45 Rectangle Data Structure

Table 3-47 describes the members of the reparent event data structure.

Table 3-47 Reparent Event Data Structure Members
Member Name Contents

X$L_RPEV_TYPE Value defined by the x$c_reparent_notify constant.

X$L_RPEV_SERIAL Number of the last request processed by the server.

X$L_RPEV_SEND_EVENT Value defined by the constant true if the event came from a SEND EVENT request.

X$A_RPEV_DISPLAY Display on which the event occurred.

X$L_RPEV_EVENT Event window.

X$L_RPEV_WINDOW Window reparented.

X$L_RPEV_PARENT New parent of the window.

X$L_RPEV_X The x value of the coordinates that define the upper left corner of the window relative to the upper left corner of the parent window.

X$L_RPEV_Y The y value of the coordinates that define the upper left corner of the window relative to the upper left corner of the parent window.

X$L_RPEV_OVERRIDE_REDIRECT If this member has a value defined by the constant true, the window manager ignores requests to reparent the window. When true, it overrides a substructure redirect on the parent window.

**Table 3-47 Reparent Event Data Structure Members**
Member Name	Contents
X$L_RPEV_TYPE	Value defined by the x$c_reparent_notify constant.
X$L_RPEV_SERIAL	Number of the last request processed by the server.
X$L_RPEV_SEND_EVENT	Value defined by the constant true if the event came from a SEND EVENT request.
X$A_RPEV_DISPLAY	Display on which the event occurred.
X$L_RPEV_EVENT	Event window.
X$L_RPEV_WINDOW	Window reparented.
X$L_RPEV_PARENT	New parent of the window.
X$L_RPEV_X	The x value of the coordinates that define the upper left corner of the window relative to the upper left corner of the parent window.
X$L_RPEV_Y	The y value of the coordinates that define the upper left corner of the window relative to the upper left corner of the parent window.
X$L_RPEV_OVERRIDE_REDIRECT	If this member has a value defined by the constant true, the window manager ignores requests to reparent the window. When true, it overrides a substructure redirect on the parent window.

3.47 Resize Request Event Data Structure

Figure 3-47 illustrates the resize request event data structure (X$RESZ_REQUEST_EVENT).

Figure 3-47 Resize Request Event Data Structure

Table 3-49 describes the members of the resource manager option data structure.

Table 3-49 Resource Manager Option Data Structure Members
Member Name Contents

X$A_OPTD_OPTION Option specification string in argv.

X$A_OPTD_RESOURCE_NAME Binding and resource name.

X$L_OPTD_ARG_KIND Style of option. Xlib can set this member to one of the following constants:

x$rm_option_no_arg x$rm_option_res_arg

x$rm_option_is_arg x$rm_option_skip_arg

x$rm_option_sticky_arg x$rm_option_skip_line

x$rm_option_sep_arg x$rm_option_skip_n_args

X$A_OPTD_VALUE Value if x$rm_option_no_arg or x$rm_option_skip_n_args used.

3.49 Resource Manager Value Data Structure

Figure 3-49 illustrates the resource manager value data structure (X$RM_VALUE).

Figure 3-49 Resource Manager Value Data Structure

Table 3-51 describes the members of the segment data structure.

Table 3-51 Segment Data Structure Members
Member Name Contents

X$W_GSEG_X1 The x value of the coordinate that specifies one endpoint of the segment

X$W_GSEG_Y1 The y value of the coordinate that specifies one endpoint of the segment

X$W_GSEG_X2 The x value of the coordinate that specifies the other endpoint of the segment

X$W_GSEG_Y2 The y value of the coordinate that specifies the other endpoint of the segment

**Table 3-51 Segment Data Structure Members**
Member Name	Contents
X$W_GSEG_X1	The x value of the coordinate that specifies one endpoint of the segment
X$W_GSEG_Y1	The y value of the coordinate that specifies one endpoint of the segment
X$W_GSEG_X2	The x value of the coordinate that specifies the other endpoint of the segment
X$W_GSEG_Y2	The y value of the coordinate that specifies the other endpoint of the segment

3.51 Selection Clear Event Data Structure

Figure 3-51 illustrates the selection clear event data structure (X$SELECT_CLEAR_EVENT).

Figure 3-51 Selection Clear Event Data Structure

Table 3-53 describes the members of the selection event data structure.

Table 3-53 Selection Event Data Structure Members
Member Name Contents

X$L_SLEV_TYPE Value defined by the x$c_selection_notify constant.

X$L_SLEV_SERIAL Number of the last request processed by the server.

X$L_SLEV_SEND_EVENT Value defined by the constant true if the event came from a SEND EVENT request.

X$A_SLEV_DISPLAY Display on which the event occurred.

X$L_SLEV_REQUESTOR Window that has requested the selection.

X$L_SLEV_SELECTION Selection atom.

X$L_SLEV_TARGET Data type to which selection is converted.

X$L_SLEV_PROPERTY Atom that specifies a property or the constant x$c_none.

X$L_SLEV_TIME Timestamp, expressed in milliseconds, or the constant x$c_current_time from the convert selection request.

**Table 3-53 Selection Event Data Structure Members**
Member Name	Contents
X$L_SLEV_TYPE	Value defined by the x$c_selection_notify constant.
X$L_SLEV_SERIAL	Number of the last request processed by the server.
X$L_SLEV_SEND_EVENT	Value defined by the constant true if the event came from a SEND EVENT request.
X$A_SLEV_DISPLAY	Display on which the event occurred.
X$L_SLEV_REQUESTOR	Window that has requested the selection.
X$L_SLEV_SELECTION	Selection atom.
X$L_SLEV_TARGET	Data type to which selection is converted.
X$L_SLEV_PROPERTY	Atom that specifies a property or the constant x$c_none.
X$L_SLEV_TIME	Timestamp, expressed in milliseconds, or the constant x$c_current_time from the convert selection request.

3.53 Selection Request Event Data Structure

Figure 3-53 illustrates the selection request event data structure (X$SEL_REQUEST_EVENT).

Figure 3-53 Selection Request Event Data Structure

Table 3-55 describes the members of the set window attributes data structure.

Table 3-55 Set Window Attributes Data Structure Members
Member Name Contents

X$L_SWDA_BACKGROUND_PIXMAP Defines the window background of an input-output window. This member can assume one of three possible values: pixmap identifier, the constant x$c_none (default), or the constant x$c_parent_relative.

X$L_SWDA_BACKGROUND_PIXEL Specifying a value for the X$L_SWDA_BACKGROUND_PIXEL member causes the server to override the X$L_SWDA_BACKGROUND_PIXMAP member.

X$L_SWDA_BORDER_PIXMAP Defines the window border of an input-output window. This member can be either X$C_COPY_FROM_PARENT or a pixmap identifier.

X$L_SWDA_BORDER_PIXEL Specifying a value for X$L_SWDA_BORDER_PIXEL causes the server to override the X$L_SWDA_BORDER_PIXMAP member.

X$L_SWDA_BIT_GRAVITY Defines how window contents should be moved when an input-only or input-output window is resized.

X$L_SWDA_WIN_GRAVITY Defines how the server should reposition the newly created input-only or input-output window when its parent window is resized.

X$L_SWDA_BACKING_STORE Provides a hint to the server about how to manage obscured portions of the window.

X$L_SWDA_BACKING_PLANES Indicates (with bits set to one) which bit planes of the window hold dynamic data that must be preserved if the window obscures, or is obscured, by another window.

X$L_SWDA_BACKING_PIXEL Defines what values to use in planes not specified by the X$L_SWDA_BACKING_PLANES member.

X$L_SWDA_SAVE_UNDER Setting the X$L_SWDA_SAVE_UNDER member to true informs the server that the client requests the contents of the screen to be saved when an input-output window obscures them.

X$L_SWDA_EVENT_MASK Defines which types of events associated with an input-only or input-output window the server should report to the client.

X$L_SWDA_DO_NOT_PROPAGATE_MASK Defines which kinds of events should not be propagated to ancestors.

X$L_SWDA_OVERRIDE_REDIRECT Specifies whether calls to map and configure an input-only or input-output window should override a request by another client to redirect those calls.

X$L_SWDA_COLORMAP Specifies the color map, if any, that best reflects the colors of an input-output window.

X$L_SWDA_CURSOR Specifying a value for the cursor member causes the server to use a particular cursor when the pointer is in an input-only or input-output window.

**Table 3-55 Set Window Attributes Data Structure Members**
Member Name	Contents
X$L_SWDA_BACKGROUND_PIXMAP	Defines the window background of an input-output window. This member can assume one of three possible values: pixmap identifier, the constant x$c_none (default), or the constant x$c_parent_relative.
X$L_SWDA_BACKGROUND_PIXEL	Specifying a value for the X$L_SWDA_BACKGROUND_PIXEL member causes the server to override the X$L_SWDA_BACKGROUND_PIXMAP member.
X$L_SWDA_BORDER_PIXMAP	Defines the window border of an input-output window. This member can be either X$C_COPY_FROM_PARENT or a pixmap identifier.
X$L_SWDA_BORDER_PIXEL	Specifying a value for X$L_SWDA_BORDER_PIXEL causes the server to override the X$L_SWDA_BORDER_PIXMAP member.
X$L_SWDA_BIT_GRAVITY	Defines how window contents should be moved when an input-only or input-output window is resized.
X$L_SWDA_WIN_GRAVITY	Defines how the server should reposition the newly created input-only or input-output window when its parent window is resized.
X$L_SWDA_BACKING_STORE	Provides a hint to the server about how to manage obscured portions of the window.
X$L_SWDA_BACKING_PLANES	Indicates (with bits set to one) which bit planes of the window hold dynamic data that must be preserved if the window obscures, or is obscured, by another window.
X$L_SWDA_BACKING_PIXEL	Defines what values to use in planes not specified by the X$L_SWDA_BACKING_PLANES member.
X$L_SWDA_SAVE_UNDER	Setting the X$L_SWDA_SAVE_UNDER member to true informs the server that the client requests the contents of the screen to be saved when an input-output window obscures them.
X$L_SWDA_EVENT_MASK	Defines which types of events associated with an input-only or input-output window the server should report to the client.
X$L_SWDA_DO_NOT_PROPAGATE_MASK	Defines which kinds of events should not be propagated to ancestors.
X$L_SWDA_OVERRIDE_REDIRECT	Specifies whether calls to map and configure an input-only or input-output window should override a request by another client to redirect those calls.
X$L_SWDA_COLORMAP	Specifies the color map, if any, that best reflects the colors of an input-output window.
X$L_SWDA_CURSOR	Specifying a value for the cursor member causes the server to use a particular cursor when the pointer is in an input-only or input-output window.

3.55 Size Hints Data Structure

Figure 3-55 illustrates the size hints data structure (X$SIZE_HINTS).

Figure 3-55 Size Hints Data Structure

Table 3-57 describes the members of the standard color map data structure.

Table 3-57 Standard Color Map Data Structure Members
Member Name Contents

X$L_SCMP_COLORMAP A color map identifier returned by CREATE COLORMAP

X$L_SCMP_RED_MAX The maximum number of red values

X$L_SCMP_RED_MULT Scale factor used to create a full pixel value

X$L_SCMP_GREEN_MAX The maximum number of green values

X$L_SCMP_GREEN_MULT Scale factor used to create a full pixel value

X$L_SCMP_BLUE_MAX The maximum number of blue values

X$L_SCMP_BLUE_MULT Scale factor used to create a full pixel value

X$L_SCMP_BASE_PIXEL The base pixel value used to compose a full color index

X$L_SCMP_VISUAL_ID ID number of the visual

X$L_SCMP_KILL_ID Resource ID that indicates whether cells are to be released by freeing the color map ID or by calling the KILL CLIENT routine

**Table 3-57 Standard Color Map Data Structure Members**
Member Name	Contents
X$L_SCMP_COLORMAP	A color map identifier returned by CREATE COLORMAP
X$L_SCMP_RED_MAX	The maximum number of red values
X$L_SCMP_RED_MULT	Scale factor used to create a full pixel value
X$L_SCMP_GREEN_MAX	The maximum number of green values
X$L_SCMP_GREEN_MULT	Scale factor used to create a full pixel value
X$L_SCMP_BLUE_MAX	The maximum number of blue values
X$L_SCMP_BLUE_MULT	Scale factor used to create a full pixel value
X$L_SCMP_BASE_PIXEL	The base pixel value used to compose a full color index
X$L_SCMP_VISUAL_ID	ID number of the visual
X$L_SCMP_KILL_ID	Resource ID that indicates whether cells are to be released by freeing the color map ID or by calling the KILL CLIENT routine

3.57 Text Item Data Structure

Figure 3-57 illustrates the text item data structure (X$TEXT_ITEM).

Figure 3-57 Text Item Data Structure

Table 3-59 describes the members of the text item 16 data structure.

Table 3-59 Text Item 16 Data Structure Members
Member Name Contents

X$A_TX16_CHARS Address of a string of characters stored in a char 2b data structure

X$L_TX16_N_CHARS Number of characters in the string

X$L_TX16_DELTA Spacing before the start of the string

X$L_TX16_FONT Identifier of the font used to print the string

**Table 3-59 Text Item 16 Data Structure Members**
Member Name	Contents
X$A_TX16_CHARS	Address of a string of characters stored in a char 2b data structure
X$L_TX16_N_CHARS	Number of characters in the string
X$L_TX16_DELTA	Spacing before the start of the string
X$L_TX16_FONT	Identifier of the font used to print the string

3.59 Text Property Data Structure

Figure 3-59 illustrates the text property data structure (X$TEXT_PROPERTY).

Figure 3-59 Text Property Data Structure

Table 3-61 describes the members of the time coordinate data structure.

Table 3-61 Time Coordinate Data Structure Members
Member Name Contents

X$L_TIMC_TIME Set to the time, in milliseconds

X$W_TIMC_X Set to the x-coordinate of the pointer cursor and is reported relative to the origin of the specified window

X$W_TIMC_Y Set to the y-coordinate of the pointer cursor and is reported relative to the origin of the specified window

**Table 3-61 Time Coordinate Data Structure Members**
Member Name	Contents
X$L_TIMC_TIME	Set to the time, in milliseconds
X$W_TIMC_X	Set to the x-coordinate of the pointer cursor and is reported relative to the origin of the specified window
X$W_TIMC_Y	Set to the y-coordinate of the pointer cursor and is reported relative to the origin of the specified window

3.61 Unmap Event Data Structure

Figure 3-61 illustrates the unmap event data structure (X$UNMAP_EVENT).

Figure 3-61 Unmap Event Data Structure

Table 3-63 describes the members of the visibility event data structure.

Table 3-63 Visibility Event Data Structure Members
Member Name Contents

X$L_VSEV_TYPE Value defined by the x$c_visibility_notify constant.

X$L_VSEV_SERIAL Number of the last request processed by the server.

X$L_VSEV_SEND_EVENT Value defined by the constant true if the event came from a SEND EVENT request.

X$A_VSEV_DISPLAY Display on which the event occurred.

X$L_VSEV_WINDOW Window whose visibility changed.

X$L_VSEV_STATE Determines the visibility state of the window. Xlib can set this member to one of the following constants:

x$c_visibility_unobscured

x$c_visibility_part_obscured

x$c_visibility_fully_obscured

Contents

Index