 |
DECwindows Motif for OpenVMS Guide to Non-C
Bindings
DISPLAY NAME
OpenVMS Format
status_return = X$DISPLAY_NAME
(disp_string, disp_name_return, [disp_len_return])
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
status_return
|
cond_value
|
uns longword
|
write
|
value
|
disp_string
|
char_string
|
character string
|
read
|
descriptor
|
disp_name_return
|
char_string
|
character string
|
write
|
descriptor
|
disp_len_return
|
word
|
uns word
|
write
|
reference
|
Returns
status_return
Specifies whether or not the routine completed successfully. The
argument status_return can be set to any of the
OpenVMS condition codes returned by LIB$SCOPY_R_DX.
disp_string
The address of a character string descriptor that points to the display
name. If the descriptor address is zero or points to a character string
of zero length, the DISPLAY NAME function translates the logical name
DECW$DISPLAY to find the display name.
disp_name_return
The address of a character string descriptor that points to the string.
DISPLAY NAME returns the display name to this argument.
disp_len_return
DISPLAY NAME returns the length of the display name string to this
optional argument.
DISPLAY OF SCREEN
OpenVMS Format
X$DISPLAY_OF_SCREEN
(screen_id, display_return)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
screen_id
|
identifier
|
uns longword
|
read
|
reference
|
display_return
|
record
|
x$display
|
write
|
value
|
Arguments
display_return
The display of the specified screen.
DISPLAY PLANES
OpenVMS Format
planes_return = X$DISPLAY_PLANES
(display, screen_number)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
planes_return
|
longword
|
longword
|
write
|
value
|
display
|
identifier
|
uns longword
|
read
|
reference
|
screen_number
|
uns longword
|
uns longword
|
read
|
reference
|
DISPLAY STRING
OpenVMS Format
status_return = X$DISPLAY_STRING
(display, name_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
|
name_return
|
char_string
|
character string
|
write
|
descriptor
|
len_return
|
unsigned_word
|
uns word
|
write
|
reference
|
Arguments
name_return
The name of the string passed to OPEN DISPLAY when the current display
was opened.
The name_return argument is the address of a character
string descriptor that points to the string.
len_return
The length of the returned string. This argument is optional.
Returns
status_return
Specifies whether or not the routine completed successfully. The
argument status_return can be set to any of the
OpenVMS condition codes returned by LIB$SCOPY_R_DX.
DISPLAY WIDTH
OpenVMS Format
width_return = X$DISPLAY_WIDTH
(display, screen_number)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
width_return
|
uns longword
|
uns longword
|
write
|
value
|
display
|
identifier
|
uns longword
|
read
|
reference
|
screen_number
|
uns longword
|
uns longword
|
read
|
reference
|
DISPLAY WIDTH MM
OpenVMS Format
width_return = X$DISPLAY_WIDTH_MM
(display, screen_id)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
width_return
|
uns longword
|
uns longword
|
write
|
value
|
display
|
identifier
|
uns longword
|
read
|
reference
|
screen_id
|
identifier
|
uns longword
|
read
|
reference
|
DOES BACKING STORE
OpenVMS Format
support_value = X$DOES_BACKING_STORE
(screen_id)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
support_value
|
longword
|
longword
|
write
|
value
|
screen_id
|
identifier
|
uns longword
|
read
|
reference
|
Returns
support_value
Indicates whether the screen supports backing stores. This can be one
of the following values:
X$C_ALWAYS
X$C_WHEN_MAPPED
X$C_NOT_USEFUL
DOES SAVE UNDERS
OpenVMS Format
Bool = X$DOES_SAVE_UNDERS
(screen_id)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
Bool
|
Boolean
|
uns longword
|
write
|
value
|
screen_id
|
identifier
|
uns longword
|
read
|
reference
|
DRAW ARC
OpenVMS Format
X$DRAW_ARC
(display, drawable_id, gc_id, x_coord, y_coord, width, height, angle1,
angle2)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
drawable_id
|
identifier
|
uns longword
|
read
|
reference
|
gc_id
|
identifier
|
uns longword
|
read
|
reference
|
x_coord
|
longword
|
longword
|
read
|
reference
|
y_coord
|
longword
|
longword
|
read
|
reference
|
width
|
longword
|
uns longword
|
read
|
reference
|
height
|
longword
|
uns longword
|
read
|
reference
|
angle1
|
longword
|
longword
|
read
|
reference
|
angle2
|
longword
|
longword
|
read
|
reference
|
Note
The X Protocol defines that only the least significant 16 bits of the
following longword arguments are transmitted to the server:
x_coord, y_coord,
width, height,
angle1, angle2.
|
DRAW ARCS
OpenVMS Format
X$DRAW_ARCS
(display, drawable_id, gc_id, arcs, num_arcs)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
drawable_id
|
identifier
|
uns longword
|
read
|
reference
|
gc_id
|
identifier
|
uns longword
|
read
|
reference
|
arcs
|
array
|
x$arc
|
read
|
reference
|
num_arcs
|
longword
|
longword
|
read
|
reference
|
DRAW IMAGE STRING
OpenVMS Format
X$DRAW_IMAGE_STRING
(display, drawable_id, gc_id, x_coord, y_coord, string)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
drawable_id
|
identifier
|
uns longword
|
read
|
reference
|
gc_id
|
identifier
|
uns longword
|
read
|
reference
|
x_coord
|
longword
|
longword
|
read
|
reference
|
y_coord
|
longword
|
longword
|
read
|
reference
|
string
|
char_string
|
character string
|
read
|
descriptor
|
Note
The X Protocol defines that only the least significant 16 bits of the
following longword arguments are transmitted to the server:
x_coord, y_coord.
|
ARGUMENTS
string
The text string to be written to the screen. The
string argument is the address of a descriptor that
points to a string.
DRAW IMAGE STRING 16
OpenVMS Format
X$DRAW_IMAGE_STRING_16
(display, drawable_id, gc_id, x_coord, y_coord, string16, length)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
drawable_id
|
identifier
|
uns longword
|
read
|
reference
|
gc_id
|
identifier
|
uns longword
|
read
|
reference
|
x_coord
|
longword
|
longword
|
read
|
reference
|
y_coord
|
longword
|
longword
|
read
|
reference
|
string16
|
array
|
word
|
read
|
reference
|
length
|
word
|
uns word
|
read
|
reference
|
Note
The X Protocol defines that only the least significant 16 bits of the
following longword arguments are transmitted to the server:
x_coord, y_coord.
|
DRAW LINE
OpenVMS Format
X$DRAW_LINE
(display, drawable_id, gc_id, x1_coord, y1_coord, x2_coord, y2_coord)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
drawable_id
|
identifier
|
uns longword
|
read
|
reference
|
gc_id
|
identifier
|
uns longword
|
read
|
reference
|
x1_coord
|
longword
|
longword
|
read
|
reference
|
y1_coord
|
longword
|
longword
|
read
|
reference
|
x2_coord
|
longword
|
longword
|
read
|
reference
|
y2_coord
|
longword
|
longword
|
read
|
reference
|
Note
The X Protocol defines that only the least significant 16 bits of the
following longword arguments are transmitted to the server:
x1_coord, y1_coord,
x2_coord, and y2_coord.
|
DRAW LINES
OpenVMS Format
X$DRAW_LINES
(display, drawable_id, gc_id, points, num_points, line_mode)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
drawable_id
|
identifier
|
uns longword
|
read
|
reference
|
gc_id
|
identifier
|
uns longword
|
read
|
reference
|
points
|
array
|
x$point
|
read
|
reference
|
num_points
|
longword
|
longword
|
read
|
reference
|
line_mode
|
longword
|
longword
|
read
|
reference
|
Arguments
line_mode
The coordinate mode of the points. The coordinates of the points can be
relative to the drawable origin or to the previous point. The
predefined values for line_mode are as follows:
X$C_COORD_MODE_ORIGIN
X$C_COORD_MODE_PREVIOUS
Other values specified in this argument are not valid.
DRAW POINT
OpenVMS Format
X$DRAW_POINT
(display, drawable_id, gc_id, x_coord, y_coord)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
drawable_id
|
identifier
|
uns longword
|
read
|
reference
|
gc_id
|
identifier
|
uns longword
|
read
|
reference
|
x_coord
|
longword
|
longword
|
read
|
reference
|
y_coord
|
longword
|
longword
|
read
|
reference
|
Note
The X Protocol defines that only the least significant 16 bits of the
following longword arguments are transmitted to the server:
x_coord, y_coord.
|
|