|
DECwindows Motif for OpenVMS Guide to Non-C
Bindings
STRING TO KEYSYM
OpenVMS Format
keysym_return = X$STRING_TO_KEYSYM
(keysym_name)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
keysym_return
|
identifier
|
uns longword
|
write
|
value
|
keysym_name
|
char_string
|
character string
|
read
|
descriptor
|
SUB IMAGE
OpenVMS Format
X$SUB_IMAGE
(ximage, x_coord, y_coord, width, height, sub_image_return)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
ximage
|
record
|
x$image
|
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
|
sub_image_return
|
record
|
x$image
|
write
|
reference
|
SUBTRACT REGION
OpenVMS Format
X$SUBTRACT_REGION
(src_region1_id, src_region2_id, dst_region_id_return)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
src_region1_id
|
identifier
|
uns longword
|
read
|
reference
|
src_region2_id
|
identifier
|
uns longword
|
read
|
reference
|
dst_region_id_return
|
identifier
|
uns longword
|
write
|
reference
|
SYNC
OpenVMS Format
X$SYNC
(display, discard)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
discard
|
longword
|
longword
|
read
|
reference
|
SYNCHRONIZE
OpenVMS Format
state_return = X$SYNCHRONIZE
(display, onoff, after_function_return)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
state_return
|
longword
|
longword
|
write
|
value
|
display
|
identifier
|
uns longword
|
read
|
reference
|
onoff
|
longword
|
longword
|
read
|
reference
|
after_function_return
|
procedure
|
proc entry mask
|
write
|
reference
|
TEXT EXTENTS
OpenVMS Format
X$TEXT_EXTENTS
(font_ptr, string, [direction_return], [ascent_return],
[descent_return], [overall_return])
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
font_ptr
|
record
|
x$font_struct
|
read
|
reference
|
string
|
char_string
|
character string
|
read
|
descriptor
|
direction_return
|
longword
|
longword
|
write
|
reference
|
ascent_return
|
longword
|
longword
|
write
|
reference
|
descent_return
|
longword
|
longword
|
write
|
reference
|
overall_return
|
record
|
x$char_struct
|
write
|
reference
|
ARGUMENTS
direction_return
The direction the font is painted on the screen. The
direction_return argument is the returned value of the
direction element of the font data structure. This argument is optional.
ascent_return
The maximum ascent of the font that draws the string. The
ascent_return argument is the returned value of the
font ascent element of the font data structure. This argument is
optional.
descent_return
Maximum descent of the font that draws the string. The
descent_return argument is the returned value of the
font descent element of the font data structure. This argument is
optional.
overall_return
The minimum left bearing, maximum right bearing, string width, maximum
character ascent, and maximum character descent. This argument is
optional.
TEXT EXTENTS 16
OpenVMS Format
X$TEXT_EXTENTS_16
(font_ptr, string, num_chars, [direction_return], [ascent_return],
[descent_return], [overall_return])
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
font_ptr
|
record
|
x$font_struct
|
read
|
reference
|
string
|
array
|
word
|
read
|
reference
|
num_chars
|
word
|
uns word
|
read
|
reference
|
direction_return
|
longword
|
longword
|
write
|
reference
|
ascent_return
|
longword
|
longword
|
write
|
reference
|
descent_return
|
longword
|
longword
|
write
|
reference
|
overall_return
|
record
|
x$char_struct
|
write
|
reference
|
ARGUMENTS
direction_return
The direction the string is painted on the screen. The
direction_return argument is the returned value of the
direction element of the font data structure. This argument is optional.
ascent_return
Maximum ascent of the font used to draw the string. The
ascent_return argument is the returned value of the
font ascent element of the font data structure. This argument is
optional.
descent_return
Maximum descent of the font used to draw the string. The
descent_return argument is the returned value of the
font descent element of the font data structure. This argument is
optional.
overall_return
The minimum left bearing, maximum right bearing, string width, maximum
character ascent, and maximum character descent of the string. This
argument is optional.
TEXT PROPERTY TO STRING LIST
OpenVMS Format
status_return = X$TEXT_PROPERTY_TO_STRING_LIST
(text_prop, list_return, count_return)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
status_return
|
longword
|
uns longword
|
write
|
value
|
text_prop
|
record
|
x$text_property
|
read
|
reference
|
list_return
|
char_string
|
character string
|
write
|
reference
|
count_return
|
longword
|
longword
|
write
|
reference
|
Returns
status_return
Specifies whether the routine completed successfully.
Value |
Description |
Non-zero
|
Routine completed successfully.
|
0
|
Routine did not complete successfully.
|
TEXT WIDTH
OpenVMS Format
width_return = X$TEXT_WIDTH
(font_ptr, string)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
width_return
|
longword
|
uns longword
|
write
|
value
|
font_ptr
|
record
|
x$font_struct
|
read
|
reference
|
string
|
char_string
|
character string
|
read
|
descriptor
|
TEXT WIDTH 16
OpenVMS Format
width_return = X$TEXT_WIDTH_16
(font_ptr, string16, count)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
width_return
|
longword
|
uns longword
|
write
|
value
|
font_ptr
|
record
|
x$font_struct
|
read
|
reference
|
string16
|
array
|
word
|
read
|
reference
|
count
|
word
|
uns word
|
read
|
reference
|
TRANSLATE COORDINATES
OpenVMS Format
same_screen_return = X$TRANSLATE_COORDINATES
(display, src_window_id, dst_window_id, src_x_coord, src_y_coord,
[dst_x_coord_return], [dst_y_coord_return], [child_id_return])
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
same_screen_return
|
Boolean
|
longword
|
write
|
value
|
display
|
identifier
|
uns longword
|
read
|
reference
|
src_window_id
|
identifier
|
uns longword
|
read
|
reference
|
dst_window_id
|
identifier
|
uns longword
|
read
|
reference
|
src_x_coord
|
longword
|
longword
|
read
|
reference
|
src_y_coord
|
longword
|
longword
|
read
|
reference
|
dst_x_coord_return
|
longword
|
longword
|
write
|
reference
|
dst_y_coord_return
|
longword
|
longword
|
write
|
reference
|
child_id_return
|
identifier
|
uns longword
|
write
|
reference
|
Arguments
dst_x_coord_return
The x-coordinate of the destination window. TRANSLATE COORDINATES
returns the source coordinates relative to the origin of the source
window to the dst_x_coord_return and
dst_y_coord_return arguments, which are relative to
the destination window's origin. This argument is optional.
dst_y_coord_return
The y-coordinate of the destination window. TRANSLATE COORDINATES
returns the source coordinates relative to the origin of the source
window to the dst_x_coord_return and
dst_y_coord_return arguments, which are relative to
the destination window's origin. This argument is optional.
child_id_return
If the destination coordinates are contained in a mapped child of the
destination window, the identifier of that child window is returned in
child_id_return. This argument is optional.
UNDEFINE CURSOR
OpenVMS Format
X$UNDEFINE_CURSOR
(display, window_id)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
window_id
|
identifier
|
uns longword
|
read
|
reference
|
UNGRAB BUTTON
OpenVMS Format
X$UNGRAB_BUTTON
(display, button, modifiers, window_id)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
button
|
longword
|
longword
|
read
|
reference
|
modifiers
|
mask_longword
|
uns longword
|
read
|
reference
|
window_id
|
identifier
|
uns longword
|
read
|
reference
|
Arguments
button
The button on the pointing device that is no longer grabbed. The
possible values are as follows:
X$C_BUTTON1
X$C_BUTTON2
X$C_BUTTON3
X$C_BUTTON4
X$C_BUTTON5
X$C_ANY_BUTTON
The predefined value X$C_ANY_BUTTON or AnyButton can be specified to
allow any pointer button to be released.
modifiers
A bit mask that specifies the set of key masks associated with the
button grab. This mask is the inclusive OR of these key mask bits:
Bit |
Predefined Value |
1
|
X$M_SHIFT
|
2
|
X$M_CAPS_LOCK
|
3
|
X$M_CONTROL
|
4
|
X$M_MOD1
|
5
|
X$M_MOD2
|
6
|
X$M_MOD3
|
7
|
X$M_MOD4
|
8
|
X$M_MOD5
|
Clients can also pass the X$_ANY_MODIFIER constants, which is
equivalent to issuing the ungrab request for all possible modifier
combinations (including the combination of no modifiers).
UNGRAB KEY
OpenVMS Format
X$UNGRAB_KEY
(display, keycode, modifiers, window_id)
Argument Information
Argument |
Usage |
Data Type |
Access |
Mechanism |
display
|
identifier
|
uns longword
|
read
|
reference
|
keycode
|
longword
|
longword
|
read
|
reference
|
modifiers
|
mask_longword
|
uns longword
|
read
|
reference
|
window_id
|
identifier
|
uns longword
|
read
|
reference
|
Arguments
modifiers
A bit mask that specifies the set of key masks associated with the
button grab. This mask is the inclusive OR of these key mask bits:
Bit |
Predefined Value |
1
|
X$M_SHIFT
|
2
|
X$M_CAPS_LOCK
|
3
|
X$M_CONTROL
|
4
|
X$M_MOD1
|
5
|
X$M_MOD2
|
6
|
X$M_MOD3
|
7
|
X$M_MOD4
|
8
|
X$M_MOD5
|
Clients can also pass the X$_ANY_MODIFIER constants, which is
equivalent to issuing the ungrab request for all possible modifier
combinations (including the combination of no modifiers).
|