A widget holding this trait can handle one or more navigator widgets
Format
#include <Xm/ScrollFrameT.h>
typdefe struct {
int version;
XmScrollFrameInitProc init;
XmScrollFrameGetInfoProc getInfo;
XmScrollFrameAddNavigatorProc addNavigator;
XmScrollFrameRemoveNavigatorProc removeNavigator;
} XmSrollFrameTraitRec, *XmScrollFrameTrait;
void
(*XmScrollFrameInitProc)WidgetXtCallbackProcWidget
Boolean
(*XmScrollFrameGetInfoProc)WidgetCardinal*Widget**Cardinal*
void
(*XmScrollFrameAddNavigatorProc)WidgetWidgetMask
void
(*XmScrollFrameRemoveNavigatorProc)WidgetWidget
DESCRIPTION
A widget holding the XmQTscrollFrame trait can handle one or more navigator widgets and use them to pan a scrollable object. The trait methods of XmQTscrollFrame are useful if you are writing you own navigator or scrollable widget.
The following standard Motif manager widgets hold this trait:
In addition, the following standard Motif widgets access the trait methods of XmQTscrollFrame:
void initWidget scrollFrameWidgetXtCallbackProc moveCBWidget scrollableWidget
The init trait method initializes several internal data fields. One of these fields must hold the name the default move callback ( moveCB) procedure that is to be associated with this widget.
Boolean getInfoWidget scrollFrameWidgetCardinal *dimensionWidget **nav_listCardinal *num_nav_list
The getInfo trait method returns information about the scrollFrameWidget. The caller may set the dimension, nav_list, or num_nav_list fields to NULL if the returned information would be of no interest.
This method returns True if the init trait method was already called. This method returns False if init has not yet been called. If this method returns False, then the returned information in the other fields should be ignored.
void addNavigatorWidget scrollFrameWidgetWidget navigatorWidgetMask dimMask
The addNavigator trait method associates a navigatorWidget with a scrollFrameWidget. Since one scrollFrameWidget can support multiple navigator widgets, it is possible that this method will be called multiple times.
void removeNavigatorWidget scrollFrameWidgetWidget navigatorWidget
The removeNavigator trait method disassociates a navigatorWidget from a scrollFrameWidget. Since one scrollFrameWidget can support multiple navigatorWidgets, this method can be called multiple times.
It is the responsibility of whomever associated the navigatorWidget with the scrollFrameWidget to call removeNavigator prior to destroying it.
RELATED