SYNOPSIS

Four convenience routines are available to support input focus: OlCallAcceptFocus() .sp .sp

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

If widget w is currently capable of accepting input focus, If widget w is currently capable of accepting input focus, then focus is assigned to w and the function returns TRUE; then focus is assigned to w and the function returns TRUE; otherwise, it returns FALSE.  Time 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 OlMoveFocus(w, direction, time)
Widget  w;
OlDefine  direction;
Time  ∗time;

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

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

OL_NEXTSet focus to the next widget that will accept it, starting with the first widget after w. 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. starting with the widget before w.

Time specifies the X time of the event that is causing the 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. focus for any reason, it returns (Widget)0. OlCanAcceptFocus()

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

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

Boolean OlHasFocus(w)
Boolean OlHasFocus(w)
Widget  w;

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

Sun Release 4.1  —  Last change: 1/8/90