HP OpenVMS Systems Documentation

Content starts here

DECwindows Motif for OpenVMS Guide to Non-C Bindings


Previous Contents Index


QUERY BEST STIPPLE


OpenVMS Format

status_return = X$QUERY_BEST_STIPPLE

(display, drawable_id, width, height, width_return, height_return)

Argument Information
Argument Usage Data Type Access Mechanism
status_return cond_value uns longword write value
display identifier uns longword read reference
drawable_id identifier uns longword read reference
width uns longword uns longword read reference
height uns longword uns longword read reference
width_return uns longword uns longword write reference
height_return uns longword uns longword write reference

Returns

status_return

Specifies whether the routine completed successfully. QUERY BEST STIPPLE returns one of the following values.
Value Description
X$_ERRORREPLY Error received from server.
SS$_NORMAL Routine completed successfully.

QUERY BEST TILE


OpenVMS Format

status_return = X$QUERY_BEST_TILE

(display, drawable_id, width, height, width_return, height_return)

Argument Information
Argument Usage Data Type Access Mechanism
status_return cond_value uns longword write value
display identifier uns longword read reference
drawable_id identifier uns longword read reference
width uns longword uns longword read reference
height uns longword uns longword read reference
width_return uns longword uns longword write reference
height_return uns longword uns longword read reference

Returns

status_return

Specifies whether the routine completed successfully. QUERY BEST TILE returns one of the following values:
Value Description
X$_ERRORREPLY Error received from server.
SS$_NORMAL Routine completed successfully.

QUERY COLOR


OpenVMS Format

X$QUERY_COLOR

(display, colormap_id, screen_def_return)

Argument Information
Argument Usage Data Type Access Mechanism
display identifier uns longword read reference
colormap_id identifier uns longword read reference
screen_def_return record x$color write reference

QUERY COLORS


OpenVMS

X$QUERY_COLORS

(display, colormap_id, screen_defs_return, num_colors)

Argument Information
Argument Usage Data Type Access Mechanism
display identifier uns longword read reference
colormap_id identifier uns longword read reference
screen_defs_return record x$color write reference
num_colors longword longword read reference

QUERY FONT


OpenVMS Format

status_return = X$QUERY_FONT

(display, font_id, 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
font_id identifier uns longword read reference
font_struc_return record x$font_struct write reference

Returns

status_return

Specifies whether the routine completed successfully. QUERY FONT 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.

Arguments

font_struc_return

The address of the font data structure associated with the font. To obtain character structure information from the font data structure, use the GET CHAR STRUCT routine after calling LOAD QUERY FONT.

QUERY KEYMAP


OpenVMS Format

X$QUERY_KEYMAP

(display, keys_return)

Argument Information
Argument Usage Data Type Access Mechanism
display identifier uns longword read reference
keys_return array byte write reference

QUERY POINTER


OpenVMS Format

result_return = X$QUERY_POINTER

(display, window_id, root_id_return, [child_id_return], [root_x_coord_return], [root_y_coord_return], [win_x_coord_return], [win_y_coord_return], [state_mask_return])

Argument Information
Argument Usage Data Type Access Mechanism
result_return Boolean longword write value
display identifier uns longword read reference
window_id identifier uns longword read reference
root_id_return identifier uns longword write reference
child_id_return identifier uns longword write reference
root_x_coord_return longword longword write reference
root_y_coord_return longword longword write reference
win_x_coord_return longword longword write reference
win_y_coord_return longword longword write reference
state_mask_return uns longword uns longword write reference

QUERY TEXT EXTENTS


OpenVMS Format

X$QUERY_TEXT_EXTENTS

(display, font_id, string, [direction_return], [ascent_return], [descent_return], [overall_return])

Argument Information
Argument Usage Data Type Access Mechanism
display identifier uns longword read reference
font_id identifier uns longword read reference
string char_string character string read descriptor
direction_return cond_value uns longword write reference
ascent_return cond_value uns longword write reference
descent_return cond_value uns longword write reference
overall_return cond_value x$char_struct write reference

ARGUMENTS

direction_return

The direction the string is painted on the screen. The direction_return argument is the returned value of the direction element of the font data structure. This argument is optional.

ascent_return

The maximum ascent of the font used to draw the string. The ascent_return argument is the returned value of the font ascent element of the font data structure. This argument is optional.

descent_return

The maximum descent of the font used to draw the string. The descent_return argument is the returned value of the font descent element of the font data structure. This argument is optional.

overall_return

The minimum left bearing, maximum right bearing, string width, maximum character ascent, and maximum character descent. Values are returned from a character structure. This argument is optional.

QUERY TEXT EXTENTS 16


OpenVMS Format

X$QUERY_TEXT_EXTENTS_16

(display, font_id, string16, num_chars, [direction_return], [ascent_return], [descent_return], [overall_return])

Argument Information
Argument Usage Data Type Access Mechanism
display identifier uns longword read reference
font_id identifier uns longword read reference
string16 array word read reference
num_chars word word read reference
direction_return cond_value uns longword write reference
ascent_return cond_value uns longword write reference
descent_return cond_value uns longword write reference
overall_return cond_value x$char_struct read reference

ARGUMENTS

direction_return

The direction in which the string is painted on the screen. The direction_return argument is the returned value of the direction element of the font data structure. This argument is optional.

ascent_return

Maximum ascent of the font used to draw the string. The ascent_return argument is the returned value of the font ascent element of the font data structure. This argument is optional.

descent_return

Maximum descent of the font used to draw the string. The descent_return argument is the returned value of the font descent element of the font data structure. This argument is optional.

overall_return

The minimum left bearing, maximum right bearing, string width, maximum character ascent, and maximum character descent. Values are returned from a character structure. This argument is optional.

QUERY TREE


OpenVMS Format

status_return = X$QUERY_TREE

(display, window_id, [root_id_return], [parent_id_return], [children_return], [num_children_return], [children_size_return], [children_buff_return])

Argument Information
Argument Usage Data Type Access Mechanism
status_return cond_value uns longword write value
display identifier uns longword read reference
window_id identifier uns longword read reference
root_id_return identifier uns longword write reference
parent_id_return identifier uns longword write reference
children_return address uns longword write reference
num_children_return longword longword write reference
children_size_return longword longword write reference
children_buff_return identifier uns longword write reference

Returns

status_return

Specifies whether the routine completed successfully. QUERY TREE returns one of the following values:
Value Description
X$_ERRORREPLY Error received from server; window no longer exists.
SS$_NORMAL Routine completed successfully.
Otherwise Failure for reason given.

Arguments

root_id_return

The identifier of the root window of the specified window. This argument is optional.

parent_id_return

The identifier of the parent window of the specified window. This argument is optional.

children_return

The virtual address of a pointer to an array of child windows, returned by the routine and residing in space reserved by Xlib. Each element in the array is a child window of the specified window. The number of elements in the array is specified by num_children_return. This argument is optional.

num_children_return

The number of children associated with the specified window. This argument is optional.

children_size_return

The size of the buffer containing the child windows, specified in children_buff_return. This argument is optional.

children_buff_return

A pointer to a data buffer residing in space you have reserved, where each entry is one child window identifier. The size of the buffer is specified by children_size_return. This argument is optional.

RAISE WINDOW


OpenVMS Format

X$RAISE_WINDOW

(display, window_id)

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


Previous Next Contents Index