DECwindows Motif for OpenVMS Guide to Non-C Bindings

GRAB SERVER

OpenVMS Format

X$GRAB_SERVER
(display)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
display	identifier	uns longword	read	reference

HEIGHT MM OF SCREEN

OpenVMS Format

height_return = X$HEIGHT_MM_OF_SCREEN
(screen_id)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
height_return	longword	longword	write	value
screen_id	identifier	uns longword	read	reference

HEIGHT OF SCREEN

OpenVMS Format

height_return = X$HEIGHT_OF_SCREEN
(screen_id)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
height_return	longword	longword	write	value
screen_id	identifier	uns longword	read	reference

ICONIFY WINDOW

OpenVMS Format

status_return = X$ICONIFY_WINDOW
(display, window_id, screen_number)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
status_return	longword	uns longword	write	reference
display	identifier	uns longword	read	reference
window_id	identifier	uns longword	read	reference
screen_number	uns longword	uns longword	read	reference

Returns

status_return
Specifies whether the routine completed successfully.

Value Description

Non-zero Routine completed successfully.

0 Routine did not complete successfully.

Value	Description
Non-zero	Routine completed successfully.
0	Routine did not complete successfully.

IF EVENT

OpenVMS Format

X$IF_EVENT
(display, event_return, predicate, arg)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
display	identifier	uns longword	read	reference
event_return	record	x$event	write	reference
predicate	procedure	proc entry mask	read	reference
arg	longword	uns longword	read	value

IMAGE BYTE ORDER

OpenVMS Format

order_return = X$IMAGE_BYTE_ORDER
(display)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
order_return	longword	longword	write	value
display	identifier	uns longword	read	reference

Returns

order_return
The byte order for images for each scanline unit in XYFormat (bitmap) or for each pixel value in ZFormat. IMAGE BYTE ORDER returns one of the following constants:

Value Description

X$C_LSB_FIRST Least significant bit first

X$C_MSB_FIRST Most significant bit first

Value	Description
X$C_LSB_FIRST	Least significant bit first
X$C_MSB_FIRST	Most significant bit first

INSERT MODIFIERMAP ENTRY

OpenVMS Format

X$INSERT_MODIFIERMAP_ENTRY
(modifier_keys, keycode_entry, modifier, modifier_keys_return)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
modifier_keys	record	x$modifier_keymap	read	reference
keycode_entry	identifier	uns longword	read	reference
modifier	longword	uns longword	read	reference
modifier_keys_return	record	x$modifier_keymap	write	reference

Arguments

modifier
The modifier for which you add a key symbol. There are eight modifiers in the order (starting from zero) shift, lock, control, mod1, mod2, mod3, mod4, and mod5. You can pass the integer value or one of the following constants:
X$C_SHIFT_MAP_INDEX
X$C_LOCK_MAP_INDEX
X$C_CONTROL_MAP_INDEX
X$C_MOD1_MAP_INDEX
X$C_MOD2_MAP_INDEX
X$C_MOD3_MAP_INDEX
X$C_MOD4_MAP_INDEX
X$C_MOD5_MAP_INDEX

modifier_keys_return
INSERT MODIFIER MAP ENTRY returns the revised modifier key map data structure.

INSTALL COLORMAP

OpenVMS Format

X$INSTALL_COLORMAP
(display, colormap_id)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
display	identifier	uns longword	read	reference
colormap_id	identifier	uns longword	read	reference

INTERN ATOM

OpenVMS Format

atom_id_return = X$INTERN_ATOM
(display, atom_name, only_if_exists)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
atom_id_return	identifier	uns longword	write	value
display	identifier	uns longword	read	reference
atom_name	char_string	character string	read	descriptor
only_if_exists	Boolean	longword	read	reference

INTERSECT REGION

OpenVMS Format

X$INTERSECT_REGION
(src_region1_id, src_region2_id, dst_region_id_return)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
src_region1_id	identifier	uns longword	read	reference
src_region2_id	identifier	uns longword	read	reference
dst_region_id_return	identifier	uns longword	write	reference

KEYCODE TO KEYSYM

OpenVMS Format

keysym_return = X$KEYCODE_TO_KEYSYM
(display, keycode, index)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
keysym_return	identifier	uns longword	write	value
display	identifier	uns longword	read	reference
keycode	word	uns word	read	reference
index	longword	longword	read	reference

KEYSYM TO KEYCODE

OpenVMS Format

keycode_return = X$KEYSYM_TO_KEYCODE
(display, keysym_id)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
keycode_return	word	uns word	write	value
display	identifier	uns longword	read	reference
keysym_id	identifier	uns longword	read	reference

KEYSYM TO STRING

OpenVMS Format

status_return = X$KEYSYM_TO_STRING
(keysym_id, keysym_name_return)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
status_return	cond_value	uns longword	write	value
keysym_id	identifier	uns longword	read	reference
keysym_name_return	char_string	character string	write	descriptor

Returns

status_return
Specifies whether the routine completed successfully.

Arguments

keysym_name_return
The name of the key symbol string.

KILL CLIENT

OpenVMS Format

X$KILL_CLIENT
(display, resource)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
display	identifier	uns longword	read	reference
resource	longword	longword	read	reference

LAST KNOWN REQUEST PROCESSED

OpenVMS Format

request_return = X$LAST_KNOWN_REQUEST_PROCESSED
(display)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
request_return	uns longword	uns longword	write	value
display	identifier	uns longword	read	reference

LIST DEPTHS

OpenVMS Format

status_return = X$LIST_DEPTHS
(display, screen_number, count_return, depths_return)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
status_return	cond_value	uns longword	write	value
display	identifier	uns longword	read	reference
screen_number	uns longword	uns longword	read	reference
count_return	longword	uns longword	write	reference
depths_return	address	array	write	reference

LIST FONT

OpenVMS Format

status_return = X$LIST_FONT
(display, pattern_name, context, name, [len_return])

Argument Information

Argument	Usage	Data Type	Access	Mechanism
status_return	cond_value	uns longword	write	value
display	identifier	uns longword	read	reference
pattern_name	char_string	character string	read	descriptor
context	context	uns longword	modify	reference
name	char_string	character string	write	descriptor
len_return	word	uns word	write	reference

LIST FONTS

OpenVMS Format

status_return = X$LIST_FONTS
(display, pattern_name, match_limit, actual_count_return, names_return, [len_return])

Argument Information

Argument	Usage	Data Type	Access	Mechanism
status_return	cond_value	uns longword	write	value
display	identifier	uns longword	read	reference
pattern_name	char_string	character string	read	descriptor
match_limit	longword	longword	read	reference
actual_count_return	longword	longword	write	value
names_return	char_string	character string	write	descriptor
len_return	longword	longword	write	reference

Returns

status_return
Specifies whether the routine completed successfully.

Value Description

SS$_NORMAL Routine completed successfully.

Value	Description
SS$_NORMAL	Routine completed successfully.

Arguments

names_return
A character string containing all the returned font names, separated by commas.
len_return
Length of the returned string of font names. This argument is optional.

LIST FONT WITH INFO

OpenVMS Format

status_return = X$LIST_FONT_WITH_INFO
(display, pattern_name, context, font_name_return, [len_return], font_struc_return)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
status_return	cond_value	uns longword	write	value
display	identifier	uns longword	read	reference
pattern_name	char_string	character string	read	descriptor
context	context	uns longword	modify	reference
font_name_return	char_string	character string	write	descriptor
len_return	word	uns word	write	reference
font_struc_return	record	x$font_struct	write	reference

Returns

status_return
Specifies whether the routine completed successfully. LIST FONTS returns one of the following values:

Value Description

SS$_NORMAL Routine completed successfully.

X$_NOTFOUND No fonts matched pattern.

LIB$_STRTRU Font names returned but truncated.

LIB$_FATALERR LIB$SCOPY_R_DX fatal error.

LIB$_INSVIRMEM Insufficient virtual memory; LIB$GET_VM call failed.

LIB$_INVSTRDES Invalid string descriptor.

Value	Description
SS$_NORMAL	Routine completed successfully.
X$_NOTFOUND	No fonts matched pattern.
LIB$_STRTRU	Font names returned but truncated.
LIB$_FATALERR	LIB$SCOPY_R_DX fatal error.
LIB$_INSVIRMEM	Insufficient virtual memory; LIB$GET_VM call failed.
LIB$_INVSTRDES	Invalid string descriptor.

Arguments

font_name_return
The virtual address of a descriptor that points to a character string. The string containing the font name is returned by the routine and resides in space reserved by Xlib.
len_return
The length of the returned string of font names. This argument is optional.
font_struct_return
The address of the font data structure associated with the font.

Contents

Index