SYNOPSIS

Four convenience routines are  available  to  support  input
focus:

OlCallAcceptFocus()

Boolean OlCallAcceptFocus(w, time)
Widget  w;
Time  *time;

If widget w is currently capable of accepting  input  focus,
then  focus  is assigned to w and the function returns TRUE;
otherwise, it returns FALSE.  Time specifies the X  time  of
the event that is causing the accept focus.

OlMoveFocus()

Widget OlMoveFocus(w, direction, time)
Widget  w;
OlDefine  direction;
Time  *time;

This function moves the input focus and returns  the  id  of
the  widget that accepted focus.  Valid values for direction
are:

OL_CURRENT
          Set focus to the next widget that will accept  it,
          starting with w.

OL_NEXT   Set focus to the next widget that will accept  it,
          starting with the first widget after w.

OL_PREVIOUS
          Set focus to the first preceding widget that  will
          accept it, starting with the widget before w.

          Time specifies the X time of  the  event  that  is
          causing the move focus.  If the function is unable
          to move the input focus for any reason, it returns
          (Widget)0.

          OlCanAcceptFocus()

          Boolean OlCanAcceptFocus(w, time)
          Widget  w;
          Time  *time;

          This function returns TRUE if widget w can  accept
          input  focus, and FALSE otherwise.  Time specifies
          the X time of the event that is causing the accept
          focus.

          OlHasFocus

          Boolean OlHasFocus(w)
          Widget  w;

          This function returns  TRUE  if  w  currently  has
          input focus, and FALSE otherwise.