'\"macro stdmacro
.if n .pH g3w.olInputFocus @(#)olInputFocus	40.2 of 1/8/90
.ig
Created:  gah 10/12/89
format -dgrumpy -rs1 -man6 Toolkit
THIS IS THE SECOND VERSION
..
.nr oN 0
.nr X
.if \nX=0 .ds x} ""INPUT FOCUS ROUTINES" 3W "\&"
.if \nX=1 .ds x} ""INPUT FOCUS ROUTINES" 3W
.if \nX=2 .ds x} ""INPUT FOCUS "" "\&"
.if \nX=3 .ds x} ""INPUT "" "" "\&"
.TH \*(x}
.SH "SYNOPSIS"
.sp
Four convenience routines are available to support input focus:
.sp 1.5
\f3OlCallAcceptFocus()\f1
\f(CW.sp
.nf
Boolean OlCallAcceptFocus(w, time)
Widget  w;
Time  *time;
.fi
\f1
If widget \f(CWw\f1 is currently capable of accepting input focus,
then focus is assigned to \f(CWw\fP and the function returns \f(CWTRUE\fP;
otherwise, it returns \f(CWFALSE\fP.  \f(CWTime\fP 
specifies the X time of the event
that is causing the accept focus.
.sp
\f3OlMoveFocus()\f1
.sp
.nf
\f(CWWidget OlMoveFocus(w, direction, time)
Widget  w;
OlDefine  direction;
Time  *time;
.fi
\f1
This function moves the input focus and returns the \f(CWid\fP of the
widget that accepted focus.  Valid values for \f(CWdirection\fP are:
.sp -1
.sp
.IP "OL_CURRENT" 1i
Set focus to the next widget that will accept it, starting
with \f(CWw.\fP
.IP "OL_NEXT"   
Set focus to the next widget that will accept it, starting
with the first widget after \f(CWw.\fP
.IP "OL_PREVIOUS"
Set focus to the first preceding widget that will accept it,
starting with the widget before \f(CWw.\fP
.sp
.P
\f(CWTime\fP 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 \f(CW(Widget)0.\fP
.sp
\f3OlCanAcceptFocus()\fP
.sp
.nf
\f(CWBoolean OlCanAcceptFocus(w, time)   
Widget  w;
Time  *time;
.fi
\f1
This function returns \f(CWTRUE\fP if widget \f(CWw\fP can accept input focus,
and \f(CWFALSE\fP otherwise.  \f(CWTime\fP specifies the X time of the event
that is causing the accept focus.
.bp
\f3OlHasFocus\f1
.sp
.nf
\f(CWBoolean OlHasFocus(w)
Widget  w;
.fi
\f1
This function returns \f(CWTRUE\fP if \f(CWw\fP currently has input focus, and
\f(CWFALSE\fP otherwise.
