XmQTscrollFrame(3X) UNIX System V XmQTscrollFrame(3X)
NAME
XmQTscrollFrame - A widget holding this trait can handle one
or more navigator widgets
SYNOPSIS
#include <Xm/ScrollFrameT.h>
typdefe struct {
int version;
XmScrollFrameInitProc init;
XmScrollFrameGetInfoProc getInfo;
XmScrollFrameAddNavigatorProc addNavigator;
XmScrollFrameRemoveNavigatorProc removeNavigator;
} XmSrollFrameTraitRec, *XmScrollFrameTrait;
void (*XmScrollFrameInitProc)(
Widget,
XtCallbackProc,
Widget,
Boolean (*XmScrollFrameGetInfoProc)(
Widget,
Cardinal*,
Widget**,
Cardinal*,
void (*XmScrollFrameAddNavigatorProc)(
Widget,
Widget,
Mask,
void (*XmScrollFrameRemoveNavigatorProc)(
Widget,
Widget);
VERSION
This page documents Motif 2.1.
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:
o XmScrolledWindow
o XmNotebook
In addition, the following standard Motif widgets access the
trait methods of XmQTscrollFrame:
o XmList
Page 1 (printed 7/20/06)
XmQTscrollFrame(3X) UNIX System V XmQTscrollFrame(3X)
o XmText
The init Trait Method
void init(
Widget scrollFrameWidget,
XtCallbackProc moveCB,
Widget 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.
scrollFrameWidget
Specifies the widget that holds the
XmQTscrollFrame trait.
moveCB Specifies the default move callback procedure that
is to be associated with this widget. Typically,
this callback is going to be added to a list of
navigator widgets maintained by the
scrollFrameWidget.
scrollableWidget
Specifies client data to be passed to the moveCB.
Typically, the client data will be the name of a
scrollable widget.
The getInfo Trait Method
Boolean getInfo(
Widget scrollFrameWidget,
Cardinal *dimension,
Widget **nav_list,
Cardinal *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.
scrollFrameWidget
Specifies the widget that is providing this
method.
dimension Returns the dimension(s) that scrollFrameWidgetis
capable of operating upon.
nav_list Returns the current list of navigators associated
with this scrollFrameWidget. This data is
returned to internal storage, and should not be
modified or freed by the caller.
Page 2 (printed 7/20/06)
XmQTscrollFrame(3X) UNIX System V XmQTscrollFrame(3X)
num_nav_list
Returns the number of navigators returned in
nav_list.
This method returns True if the init trait method was
already called. This method returns False if inithas not yet
been called. If this method returns False, then the returned
information in the other fields should be ignored.
The addNavigator Trait Method
void addNavigator(
Widget scrollFrameWidget,
Widget navigatorWidget,
Mask dimMask);
The addNavigator trait method associates a
navigatorWidgetwith a scrollFrameWidget. Since one
scrollFrameWidget can support multiple navigator widgets, it
is possible that this method will be called multiple times.
scrollFrameWidget
Specifies the scroll frame widget that is
providing this method.
navigatorWidget
Specifies the navigator widget to be associated
with the scrollFrameWidget.
dimMask Specifies the dimension(s) upon which the
navigatorWidgetis going to operate.
The removeNavigator Trait Method
void removeNavigator(
Widget scrollFrameWidget,
Widget navigatorWidget);
The removeNavigator trait method disassociates a
navigatorWidgetfrom a scrollFrameWidget. Since one
scrollFrameWidget can support multiple navigatorWidgets,
this method can be called multiple times.
It is the responsibility of whomever associated the
navigatorWidgetwith the scrollFrameWidget to call
removeNavigator prior to destroying it.
scrollFrameWidget
Specifies the scroll frame widget that is
providing this method.
navigatorWidget
Specifies the navigator widget to be disassociated
from the scrollFrameWidget.
Page 3 (printed 7/20/06)
XmQTscrollFrame(3X) UNIX System V XmQTscrollFrame(3X)
RELATED
XmScrolledWindow(3), XmNotebook(3), and XmQTnavigator(3).
Page 4 (printed 7/20/06)