Name

XmeDrawArrow — Draws a Motif-style, three-dimensional arrow

Synopsis

#include <Xm/DrawP.h>
void XmeDrawArrow(display, drawable, top_gc, bottom_gc, center_gc, x, y, width, height, shadow_thickness, 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).