DECwindows Motif for OpenVMS Guide to Non-C Bindings


Previous Contents Index


LIST FONTS WITH INFO


OpenVMS Format

status_return = X$LIST_FONTS_WITH_INFO

(display, pattern_name, maxnames, count_return, font_names_return, [len_return], [info_return], [info_size], [info_buff_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
maxnames longword longword read reference
count_return longword longword write reference
font_names_return char_string character string write descriptor
len_return word uns word write reference
info_return address uns longword read reference
info_size longword longword read reference
info_buff_return uns longword uns longword write reference

Returns

status_return

Return value that specifies whether the routine completed successfully. LIST FONTS WITH INFO 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

len_return

The length of the string of font names returned in font_names_return.

info_return

The virtual address of a pointer to an array of font information data, returned by the routine and residing in space reserved by Xlib.

info_size

The size of the buffer specified in info_buff_return.

info_buff_return

A pointer to a data buffer residing in space space you have reserved. Each entry is one font information element. The length of the buffer is specified by info_size. The property data is returned by the routine.

LIST HOSTS


OpenVMS Format

status_return = X$LIST_HOSTS

(display, num_hosts_return, state_return, [hosts_return], [hosts_size], [hosts_buff_return])

Argument Information
Argument Usage Data Type Access Mechanism
status_return cond_value uns longword write value
display identifier uns longword read reference
num_hosts_return longword longword write reference
state_return longword longword write reference
hosts_return address uns longword write reference
hosts_size longword longword read reference
hosts_buff_return array uns longword write reference

Returns

status_return

Specifies whether the routine completed successfully. Possible status values returned by the OpenVMS binding are as follows:
Value Description
X$_ERRORREPLY Error received from server.
X$_NOHOSTS No hosts available to make connections.
X$_TRUNCATED User buffer specified in time_buff_return was not large enough.
SS$_NORMAL Routine completed successfully.

Arguments

hosts_return

The virtual address of the hosts buffer, which contains the current access control list, is returned. This argument is optional. If you specify this argument, LIST HOSTS determines the size of the hosts buffer to create. If you specify hosts_return, you do not need to specify hosts_size and hosts_buff_return.

hosts_size

The size of the hosts buffer to which LIST HOSTS returns the list of hosts that can access a display. This argument is optional.

hosts_buff_return

A pointer to an array of addresses residing in space space you have reserved, where each element is the address of a host. The length of the array is specified by num_hosts_return. This argument is optional.

LIST INSTALLED COLORMAPS


OpenVMS Format

status_return = X$LIST_INSTALLED_COLORMAPS

(display, window_id, num_colormaps_return, [colormaps_return], [colormaps_size], [colormaps_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
num_colormaps_return longword longword write reference
colormaps_return address uns longword write reference
colormaps_size longword longword read reference
colormaps_buff_return array uns longword write reference

Returns

status_return

Specifies whether the routine completed successfully. Possible status values returned by the OpenVMS binding are as follows:
Value Description
0 None.
X$_TRUNCATED User buffer specified in time_buff_return was not large enough.
SS$_NORMAL Routine completed successfully.

Arguments

colormaps_return

The address of the buffer where the list of color map identifiers is returned. This argument is optional. If you specify this argument, LIST INSTALLED COLORMAPS determines the size of the buffer to create. If you specify colormaps_return, you do not need to specify colormaps_size and colormaps_buff_return.

colormaps_size

The size of the color map buffer.

colormaps_buff_return

A pointer to a buffer residing in space you have reserved, where the list of color map identifiers is returned.

LIST PIXMAP FORMATS


OpenVMS Format

status_return = X$LIST_PIXMAP_FORMATS

(display, count_return, [formats_return], [formats_size], [formats_buff_return])

Argument Information
Argument Usage Data Type Access Mechanism
status_return cond_value uns longword write value
display identifier uns longword read reference
count_return longword uns longword write reference
formats_return address array write reference
formats_size longword uns longword read reference
formats_buff_return array uns longword write reference

Arguments

formats_return

Pointer to a data buffer returned by the routine and residing in space reserved by Xlib. Each entry is a pixmap format structure. This argument is optional.

formats_size

Size of the formats_buff_return buffer that receives the pixmap data

formats_buff_return

Pointer to a data buffer residing in space you have reserved, where each entry is a pixmap format structure. This argument is optional.

LIST PROPERTIES


OpenVMS Format

status_return = X$LIST_PROPERTIES

(display, window_id, num_prop_return, [properties_return], [properties_size], [properties_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
num_prop_return longword longword write reference
properties_return address uns longword write reference
properties_size longword longword read reference
properties_buff_return array longword write reference

Returns

status_return

Specifies whether the routine completed successfully. LIST PROPERTIES returns one of the following values:
Value Description
SS$_NORMAL Routine completed successfully.
X$_ERRORREPLY Error received from server; window no longer exists.
X$_TRUNCATED Results truncated; user-supplied buffer not large enough.

Arguments

properties_return

The virtual address of a pointer to an array of property data, returned by the routine and residing in space reserved by Xlib.

properties_size

The size of the properties_buff_return buffer that will receive the property list.

properties_buff_return

A pointer to a data buffer returned by the routine and residing in space you have reserved, where each entry is one property element. The length of the buffer is specified by properties_size.

LOAD FONT


OpenVMS Format

font_id = X$LOAD_FONT

(display, font_name)

Argument Information
Argument Usage Data Type Access Mechanism
font_id identifier uns longword write value
display identifier uns longword read reference
font_name char_string character string read descriptor

LOAD QUERY FONT


OpenVMS Format

status_return = X$LOAD_QUERY_FONT

(display, font_name, 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_name char_string character string read descriptor
font_struc_return record x$font_struct write reference

Returns

status_return

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

LOOKUP COLOR


OpenVMS Format

status_return = X$LOOKUP_COLOR

(display, colormap_id, color_name, [screen_def_return], [exact_def_return])

Argument Information
Argument Usage Data Type Access Mechanism
status_return cond_value uns longword write value
display identifier uns longword read reference
colormap_id identifier uns longword read reference
color_name char_string character string read descriptor
screen_def_return record x$color write reference
exact_def_return record x$color write reference

Returns

status_return

Specifies whether the routine completed successfully. LOOKUP COLOR returns one of the following values:
Value Description
SS$_NORMAL Routine completed successfully.
X$_ERRORREPLY Color name does not exist in database.

Arguments

screen_def_return

The color data structure where the red, green, and blue values of the color most closely supported by the screen hardware are returned. The screen is determined from the specified color map. This argument is optional.

exact_def_return

The color definition data structure where the red, green, and blue values of the exact color as defined in the color database are returned. The pixel, pad, and flags members are not used. This argument is optional.

LOOKUP KEYSYM


OpenVMS Format

keysym_id_return = X$LOOKUP_KEYSYM

(key_event, index)

Argument Information
Argument Usage Data Type Access Mechanism
keysym_id_return identifier uns longword write value
key_event record x$key_event read reference
index longword longword read reference


Previous Next Contents Index