DECwindows Motif for OpenVMS Guide to Non-C Bindings
Previous Contents Index

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.

Previous Next Contents Index