XmDirectionMatch(3X) UNIX System V XmDirectionMatch(3X)
NAME
XmDirectionMatch - A function that checks for a specified
direction component
SYNOPSIS
#include <Xm/Xm.h>
Boolean XmDirectionMatch (d1, d2)
XmDirection d1;
XmDirection d2;
(void)
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmDirectionMatch compares two XmDirection values. The
function returns a Boolean value depending on whether or not
the two input values "match." The simplest match is when d1
and d2 are identical. However, other matches are possible.
XmDirectionMatch attempts to compare specified bits only;
nonspecified bits automatically match.
For example, suppose that d1 equals
XmTOPTOBOTTOMRIGHTTOLEFT. In this case, the function
will return True if d2 equals either XmRIGHTTOLEFT or
XmTOPTOBOTTOM. However, the function will return False if
d2 equals XmTOPTOBOTTOMLEFTTORIGHT,
XmBOTTOMTOTOPRIGHTTOLEFT, or
XmBOTTOMTOTOPLEFTTORIGHT.
Note that direction can be thought of as having three
components, a horizontal component, a vertical component,
and the precedence among them. This means that in addition
to the previously mentioned directions, the function will
still return False if d1 equals
XmTOPTOBOTTOMRIGHTTOLEFT and d2 equals
XmRIGHTTOLEFTTOPTOBOTTOM.
d1 Specifies an XmDirection value.
d2 Specifies an XmDirection value.
RETURN VALUES
Returns True if d1 "matches" d2; otherwise, returns False.
RELATED INFORMATION
XmDirection(3), XmDirectionMatchPartial(3),
XmDirectionToStringDirection(3), XmString(3),
XmStringDirection(3), and XmStringDirectionToDirection(3).
Page 1 (printed 1/22/99)