[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Widget Writer's Guide

XmeDrawArrow

Draws a Motif-style, three-dimensional arrow

Format

#include <Xm/DrawP.h>
void XmeDrawArrowDisplay
*displayDrawable drawableGC
top_gcGC bottom_gcGC
center_gcPosition xPosition
yDimension widthDimension
heightDimension
shadow_thicknessunsigned char
direction

DESCRIPTION

XmeDrawArrow draws a Motif-style arrowhead surrounded by Motif-style shadows. The routine always draws the arrowhead as an equilateral triangle.

This function does not draw the tail of the arrow. Furthermore, this function does not allow you to draw a broad range of arrow shapes (for example, you cannot draw a curved arrow). You can, however, control the direction that the arrowhead faces.

Four of the arguments to XmeDrawArrow ( x, y, width, and height) describe a bounding box. The bounding box encloses not only the arrowhead but its shadows as well. XmeDrawArrow centers the arrowhead within the bounding box.

display
Specifies the display on which the arrow is to be rendered.

drawable
Specifies the drawable in which the arrow is to be rendered. (Typically, this drawable is a widget window.)

top_gc
Specifies the graphics context of the shadow that is generally above and to the left of the triangular arrowhead.

bottom_gc
Specifies the graphics context of the shadow that is generally below and to the right of the triangular arrowhead.

center_gc
Specifies the graphics context of the arrow itself.

If center_gc is NULL, the diamond will not be filled, but the shadow will still be drawn.

x
Specifies the leftmost point of the bounding box.

y
Specifies the top of the bounding box.

width
Specifies the width of the bounding box.

height
Specifies the height of the bounding box.

shadow_thickness
Specifies the thickness of the arrow's shadows in pixels. At Motif Release 2.0, the only supported values of shadow_thickness are 0 (no shadow), 1, or 2.

direction
Specifies the direction of the arrow. The direction must be one of the following values: XmARROW_RIGHT, XmARROW_LEFT, XmARROW_UP, or XmARROW_DOWN.

RELATED

XmArrowButton(3).

[ Previous | Next | Contents | Glossary | Home | Search ]