 |
DECwindows Motif for OpenVMS Guide to Non-C
Bindings
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
|
|
