XmeAddFocusChangeCallback

Registers a callback for focus changes

Format

#include
<Xm/VendorSEP.h>
void XmeAddFocusChangeCallback
Widget
widgetXtCallbackProc
callback_procedureXtPointer
data

DESCRIPTION

XmeAddFocusChangeCallback registers a callback_procedure to be called whenever there is a focus change to any widget in the widget tree managed by a specified VendorShell or subclass of VendorShell. This callback_procedure is called the focus change callback. Motif will not call the focus change callbacks when the VendorShell (or subclass) is in implicit mode. In explicit mode, Motif automatically calls the focus change callbacks whenever the user or the application attempts to change focus. Your focus change callback procedure has the option of accepting or rejecting the attempted focus change.

Registering a focus change callback can cause an entire application to run more slowly because the focus change callbacks might be called fairly frequently.

A focus change callback can be removed by calling XmeRemoveFocusChangeCallback.

typedef struct {
        int     
reason ;
        XEvent  *
event;
        Boolean 
cont;
        Widget 
old_focus;
        Widget 
new_focus;
        unsigned char 
focus_policy;
        XmTraversalDirection
direction;
} XmFocusMovedCallbackStruct;