XmDirectionMatch - Man Page

#include <Xm/Xm​.h>
Boolean XmDirectionMatch (d1, d2)
        XmDirection     d1;
        XmDirection     d2;
(void)

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 XmTOP_TO_BOTTOM_RIGHT_TO_LEFT​. In this case, the function will return True if d2 equals either XmRIGHT_TO_LEFT or XmTOP_TO_BOTTOM​. However, the function will return False if d2 equals XmTOP_TO_BOTTOM_LEFT_TO_RIGHT, XmBOTTOM_TO_TOP_RIGHT_TO_LEFT, or XmBOTTOM_TO_TOP_LEFT_TO_RIGHT​.

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 XmTOP_TO_BOTTOM_RIGHT_TO_LEFT and d2 equals XmRIGHT_TO_LEFT_TOP_TO_BOTTOM​.

d1

Specifies an XmDirection value​.

d2

Specifies an XmDirection value​.

Returns True if d1 "matches" d2; otherwise, returns False​.

XmDirection(3), XmDirectionMatchPartial(3), XmDirectionToStringDirection(3), XmString(3), XmStringDirection(3), and XmStringDirectionToDirection(3)​.

XmDirection(3), XmDirectionMatchPartial(3), XmDirectionToStringDirection(3).