OpenVMS Format

X$GET_MODIFIER_MAPPING

(display, modifier_keys_return)

Arguments

modifier_keys_return

The modifier key map data structure containing the values for the modifier keys. GET MODIFIER MAPPING returns the values in this argument.

OpenVMS Format

status_return = X$GET_MOTION_EVENTS

(display, window_id, start, stop, num_events_return, [time_return], [time_size], [time_buff_return])

Returns

status_return

Specifies whether the routine completed successfully. GET MOTION EVENTS returns one of the following values:

Value	Description
X$_ERRORREPLY	Error received from server.
X$_TRUNCATED	User buffer specified in time_buff_return not large enough.
SS$_NORMAL	Routine completed successfully.

Arguments

time_return

The address of the time coordinate data structure returned by the routine and residing in space reserved by Xlib. You can specify either time_return to receive the address of the time coordinate data structure, or the time_size and time_buff_return arguments to receive an array of time coordinates in a buffer. This argument is optional.

time_size

The length of the time coordinate buffer. This argument is optional.

time_buff_return

A pointer to an array of time coordinates. The length of the array is specified by time_size and resides in space that you have reserved. This argument is optional.

OpenVMS Format

status_return = X$GET_NORMAL_HINTS

(display, window_id, hints_return)

Returns

status_return

Specifies whether the return completed successfully. The routine returns a non-zero value for success and zero for failure.

OpenVMS Format

pixel_value_return = X$GET_PIXEL

(ximage, x_coord, y_coord)

OpenVMS Format

X$GET_POINTER_CONTROL

(display, [accel_numerator_return], [accel_denominator_return], [threshold_return])

Arguments

accel_numerator_return

The acceleration numerator. The accel_numerator_return and accel_denominator_return arguments specify the complete acceleration multiplier. This argument is optional.

accel_denominator_return

The acceleration denominator. The accel_numerator_return and accel_denominator_return arguments specify the complete acceleration multiplier. This argument is optional.

threshold_return

The acceleration threshold, specified in the number of pixels moved during one movement. This argument is optional.

OpenVMS Format

num_elements_return = X$GET_POINTER_MAPPING

(display, map_return, num_map)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
num_elements_return	longword	longword	write	value
display	identifier	uns longword	read	reference
map_return	array	byte	write	reference
num_map	word	uns word	read	reference

OpenVMS Format

status_return = X$GET_RGB_COLORMAPS

(display, window_id, [standard_colormap_return], [count_return], property_id, [colormap_size], [colormap_buff_return])

Arguments

colormap_size

Size of the colormap_buff_return argument in bytes. This argument is optional.

colormap_buff_return

Pointer to an array residing in space reserved you have reserved. Each entry is a window ID. This argument is optional.

OpenVMS Format

X$GET_SCREEN_SAVER

(display, [timeout_return], [interval_return], [prefer_blanking_return], [allow_exposures_return])

Arguments

timeout_return

The time, in seconds, that the screen saver waits before turning on. The time represents the number of seconds when no input from the keyboard or pointing device is received. A value of zero means that the screen saver is disabled. This argument is optional.

interval_return

The time, in seconds, from one screen saver invocation to the next. This argument is optional.

prefer_blanking_return

The screen blanking mode. The predefined values for prefer_blanking_return are as follows:

X$C_DONT_PREFER_BLANKING
X$C_PREFER_BLANKING
X$C_DEFAULT_BLANKING

This argument is optional.

allow_exposures_return

The current screen saver control values are returned. The predefined values for allow_exposures_return are as follows:

X$C_DONT_ALLOW_EXPOSURES
X$C_ALLOW_EXPOSURES
X$C_DEFAULT_EXPOSURES

This argument is optional.

OpenVMS Format

owner_id_return = X$GET_SELECTION_OWNER

(display, selection_id)

OpenVMS Format

status_return = X$GET_SIZE_HINTS

(display, window_id, hints_return, property_id)

OpenVMS Format

status_return = X$GET_STANDARD_COLORMAP

(display, window_id, standard_colormap_return, property_id)

Returns

status_return

Specifies whether the routine completed successfully. The routine fails if the standard color map property is not defined for the specified window. This argument returns one of the following values.

Value	Description
SS$_NORMAL	Routine completed successfully.
X$_PROPUNDEF	The standard color map property has not been defined for the specified window.
X$_ERRORREPLY	Error received from server.
X$_TRUNCATED	Buffer not large enough; results truncated.

OpenVMS Format

status_return = X$GET_SUB_IMAGE

(display, drawable_id, x_coord, y_coord, width, height, plane_mask, image_format, dst_ximage_return, dst_x_coord, dst_y_coord)

Returns

status_return

Specifies whether the routine completed successfully. GET SUB IMAGE returns one of the following values:

Value	Description
SS$_NORMAL	Routine completed successfully.
X$_ERRORREPLY	Error received from server.

Arguments

image_format

The format of the image. The predefined values for image_format are as follows:

X$C_XY_BITMAP
X$C_XY_PIXMAP
X$C_Z_PIXMAP

Other values specified in this argument are not valid.