SoXtInputFocus(3IV)

NAME
     SoXtInputFocus (SoXtInFocus) - reports input focus change events

INHERITS FROM
     SoXtDevice > SoXtInputFocus

SYNOPSIS
     #include <Inventor_c/Xt/devices/SoXtInputFocus.h>

     typedef SoXtInputFocus  SoXtInFocus

                                  #define SO_XT_ALL_FOCUS_EVENTS
                                  (EnterWindowMask | LeaveWindowMask)

          Functions from class SoXtInputFocus:

     SoXtInputFocus *    SoXtInFocusCreate(EventMask mask =
                              SO_XT_ALL_FOCUS_EVENTS)
     void                SoXtInFocusDelete(SoXtInFocus *this)

          Functions from class SoXtDevice:

     void                SoXtInFocusEnable(SoXtInFocus *this, Widget w,
                              XtEventHandler f, XtPointer data, Window win =
                              NULL)
     void                SoXtInFocusDisable(SoXtInFocus *this, Widget w,
                              XtEventHandler f, XtPointer data)
     const SoEvent *     SoXtInFocusXlateEv(SoXtInFocus *this, XAnyEvent
                              *xevent)
     void                SoXtInFocusSetWinSize(SoXtInFocus *this, const
                              SbVec2s *size)
     const SbVec2s *     SoXtInFocusGetWinSize(const SoXtInFocus *this)


DESCRIPTION
     This class reports input focus change events (i.e. when the cursor
     crosses into or out of the window). There are no input focus events in
     Inventor, so this always returns NULL when asked to translate events.
     When this class is registered on a render area, the render area will
     receive X input focus change events. (This class is extensively employed
     by the viewer classes.)

FUNCTIONS
     SoXtInputFocus *    SoXtInFocusCreate(EventMask mask =
                              SO_XT_ALL_FOCUS_EVENTS)
     void                SoXtInFocusDelete(SoXtInFocus *this)
          Constructor and destructor. To the constructor, pass which input
          focus events you are interested in as a bitwise OR of the following
          values:

          EnterWindowMask - Input focus entered the window
          LeaveWindowMask - Input focus left the window

          Or simply pass the defined value SO_XT_ALL_FOCUS_EVENTS for all
          input focus events.


SEE ALSO
     SoXtDevice