DECwindows Motif for OpenVMS Guide to Non-C Bindings

FETCH NAME

OpenVMS Format

status_return = X$FETCH_NAME
(display, window_id, window_name_return, [name_len_return])

Argument Information

Argument	Usage	Data Type	Access	Mechanism
status_return	longword	longword	write	value
display	identifier	uns longword	read	reference
window_id	identifier	uns longword	read	reference
window_name_return	char_string	character string	write	descriptor
name_len_return	word	uns word	write	reference

Returns

status_return
Specifies whether the routine completed successfully.

Value Description

0 Routine completed successfully.

Non-zero Routine did not complete successfully.

Value	Description
0	Routine completed successfully.
Non-zero	Routine did not complete successfully.

Arguments

name_len_return
The length of window_name_return. This argument is optional.

FILL ARC

OpenVMS Format

X$FILL_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.

FILL ARCS

OpenVMS Format

X$FILL_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

FILL POLYGON

OpenVMS Format

X$FILL_POLYGON
(display, drawable_id, gc_id, points, num_points, shape, 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
shape	longword	longword	read	reference
mode	longword	longword	read	reference

Arguments

shape
The shape of the polygon. The predefined values for shape are as follows:
X$C_POLYCOMPLEX
X$C_CONVEX
X$C_NONCONVEX

If the shape of the polygon is known and correctly specified with this argument, server performance can be improved. If the shape is specified incorrectly, the result of the operation will be undefined. Other values specified in this argument are not valid.
mode
The coordinate mode of the points. The coordinates of the points can be relative to the drawable origin or relative to the previous point. The predefined values for mode are as follows:
X$C_COORD_ MODE_ORIGIN
X$C_COORD_ MODE_PREVIOUS
Other values specified in this argument are not valid.

FILL RECTANGLE

OpenVMS Format

X$FILL_RECTANGLE
(display, drawable_id, gc_id, x_coord, y_coord, width, height)

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

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.

FILL RECTANGLES

OpenVMS Format

X$FILL_RECTANGLES
(display, drawable_id, gc_id, rectangles, num_rectangles)

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
rectangles	array	x$rectangle	read	reference
num_rectangles	longword	longword	read	reference

FILTER EVENT

OpenVMS Format

X$FILTER_EVENT
(event, window)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
event	record	x$event	read	reference
window	identifier	uns longword	read	reference

FIND CONTEXT

OpenVMS Format

status_return = X$FIND_CONTEXT
(display, window_id, context_id, [window_data_return], [buff_len], [buff_ptr_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
window_id	identifier	uns longword	read	reference
context_id	identifier	uns longword	read	reference
window_data_return	longword	uns longword	read	reference
buff_len	longword	longword	read	reference
buff_ptr_return	array	byte	write	reference
len_return	word	uns word	write	reference

Returns

status_return
Specifies whether the return completed successfully. The routine returns zero for success and a non-zero value for failure.

Arguments

buff_len
The length of the supplied buffer. This argument is optional.
buff_ptr_return
The buffer into which data is written. This argument is optional.
len_return
The length of the data written into the buffer. This argument is optional.

FLUSH

OpenVMS Format

X$FLUSH
(display)

Argument Information

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

FLUSH GC

OpenVMS Format

X$FLUSH_GC
(display, gc)

Argument Information

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

FORCE SCREEN SAVER

OpenVMS Format

X$FORCE_SCREEN_SAVER
(display, saver_mode)

Argument Information

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

Arguments

saver_mode
Specifies how the screen saver is activated. The predefined values for saver_mode are as follows:

Value Description

X$C_SCREEN_SAVER_ACTIVE Activates the screen saver even if it has been disabled.

X$C_SCREEN_SAVER_RESET Resets the screen saver to its inital state.

Value	Description
X$C_SCREEN_SAVER_ACTIVE	Activates the screen saver even if it has been disabled.
X$C_SCREEN_SAVER_RESET	Resets the screen saver to its inital state.

FREE

OpenVMS Format

X$FREE
(buff_ptr)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
buff_ptr	byte	v uns byte	read	reference

FREE COLORMAP

OpenVMS Format

X$FREE_COLORMAP
(display, colormap_id)

Argument Information

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

FREE COLORS

OpenVMS Format

X$FREE_COLORS
(display, colormap_id, pixels, num_pixels, planes)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
display	identifier	uns longword	read	reference
colormap_id	identifier	uns longword	read	reference
pixels	array	longword	read	reference
num_pixels	longword	longword	read	reference
planes	longword	uns longword	read	reference

FREE CURSOR

OpenVMS Format

X$FREE_CURSOR
(display, cursor_id)

Argument Information

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

FREE FONT

OpenVMS Format

X$FREE_FONT
(display, font_struc)

Argument Information

Argument	Usage	Data Type	Access	Mechanism
display	identifier	uns longword	read	reference
font_struc	record	x$font_struct	read	reference

Contents

Index