Paned widget

Table of Contents

      The Paned widget manages children in a vertically or horizontally tiled fashion. The panes may be dynamically resized by the user by using the grips that appear near the right or bottom edge of the border between two panes. The Paned widget may accept any widget class as a pane except Grip. Grip widgets have a special meaning for the Paned widget, and adding a Grip as its own pane will confuse the Paned widget.

Using the Paned widget

betweenCursor	If this resource is not None then this cursor to be used for the grip when changing the boundary between two panes for both vertical and horizontal orientations. If this resource is None then horizontalBetweenCursor and verticalBetweenCursor to be used depend on orientation.
cursor	The cursor to use when the mouse pointer is over the Paned widget, but not in any of its children (children may also inherit this cursor). It should be noted that the internal borders are actually part of the Paned widget, not the children.
gripCursor	The cursor to use when the grips are not active. The default value is verticalGripCursor or horizontalGripCursor depending on the orientation of the Paned widget.
gripIndent	The amount of space left between the right (or bottom) edge of the Paned widget and all the grips.
gripTranslation	Translation table that will be applied to all grips.
horizontalBetweenCursor verticalBetweenCursor	If betweenCursor is not set to None than this cursor to be used for the grip when changing the boundary between two panes. These resources allow the cursors to be different depending on the orientation of the Paned widget.
horizontalGripCursor verticalGripCursor	The cursor to be used for the grips when they are not active. These resources allow the cursors to be different depending on the orientation of the Paned widget.
internalBorderColor	This resource is obsolete in Xraw.
internalBorderWidth	The width of the internal borders. This is the amount of space left between the panes. The class name of this resource allows Paned*BorderWidth: 3 to set the internal border width for the Paned widget.
leftCursor rightCursor	The cursor used to indicate which is the important pane to resize when the Paned widget is oriented horizontally.
lowerCursor upperCursor	The cursor used to indicate which is the important pane to resize when the Paned widget is oriented vertically. This is not the same as the number of panes, since this also contains a grip for some of the panes, use XawPanedGetNumSub to retrieve the number of panes.
orientation	The orientation to stack the panes. This resource cannot be changed after widget have been created. This value can be either XtorientVertical or XtorientHorizontal. In resource file it must be Paned*Orientation:vertical or Paned*Orientation:horizontal.
refigureMode	This resource is obsolete in Xraw. Use convenience routine XawPanedSetRefigureMode() to control layout of panes.
hSpace vSpace	The amount of space, in pixels, to leave between edge of Paned widget and corresponding edge of virtual layout box.

New Constraint Resources

Inherited Resources

Container class resources
Name	Class	Type	Notes	Default Value
bottomShadowPixel	BottomShadowPixel	Pixel	CSG	Dinamic
bottomShadowPixmap	BottomShadowPixmap	Pixmap	CSG	UnspecifiedPixmap
shadowWidth	ShadowWidth	Dimension	CSG	0
topShadowPixmap	TopShadowPixmap	Pixmap	CSG	UnspecifiedPixmap
topShadowPixel	TopShadowPixel	Pixel	CSG	Dinamic
userData	UserData	XtPointer	CSG	NULL

Composit class resources
Name	Class	Type	Notes	Default Value
children	ReadOnly	WidgetList	C	NULL
insertPosition	InsertPosition	XtOrderProc	CSG	Insert new children at the end of the child list
numChildren	ReadOnly	Cardinal	C	0

Core class resources
Name	Class	Type	Notes	Default Value
accelerators	Accelerators	XtAccelerators	CSG	NULL
ancestorSensitive	AncestorSensitive	Boolean	G	True
background	Background	Pixel	CSG	XtDefaultBackground
backgroundPixmap	Pixmap	Pixmap	CSG	XtUnspecifiedPixmap
borderColor	BorderColor	Pixel	CSG	XtDefaultForeground
borderPixmap	Pixmap	Pixmap	CSG	XtUnspecifiedPixmap
borderWidth	BorderWidth	Dimension	CSG	0
colormap	Colormap	Colormap	CG	Parent's Colormap
depth	Depth	int	CG	Parent's Depth
destroyCallback	Callback	XtCallbackList	C	NULL
height	Height	Dimension	CSG	Depends on orientation
initialResourcesPersistent	InitialResourcesPersistent	Boolean	C	True
mappedWhenManaged	MappedWhenManaged	Boolean	CSG	True
screen	Screen	Screen	CG	Parent's Screen
sensitive	Sensitive	Boolean	CSG	True
translations	Translations	XtTranslations	CSG	NULL
width	Width	Dimension	CSG	Depends on orientation
x	Position	Position	CSG	0
y	Position	Position	CSG	0

Grip Translations

        <Btn1Down>:     GripAction(Start, UpLeftPane)
        <Btn2Down>:     GripAction(Start, ThisBorderOnly)
        <Btn3Down>:     GripAction(Start, LowRightPane) 
        <Btn1Motion>:   GripAction(Move, UpLeftPane) 
        <Btn2Motion>:   GripAction(Move, ThisBorderOnly) 
        <Btn3Motion>:   GripAction(Move, LowRightPane)
        Any<BtnUp>:     GripAction(Commit)

Convenience routines

void XawPanedAllowResize (w, allow_resize)
     Widget w;
     Boolean allow_resize;

If allow_resize is True, the Paned widget allows geometry requests from the child to change the pane's height. If allow_resize is False, the Paned widget ignores geometry requests from the child to change the pane's height. The default state is True before the Pane is realized and False after it is realized. This procedure is equivalent to changing the allowResize constraint resource for the child.

To change the minimum and maximum height settings for a pane, use

void XawPanedSetMinMax(w, min, max)
     Widget w;
     int min, max;

This procedure is equivalent to setting the min and max constraint resources for the child.

To retrieve the minimum and maximum height settings for a pane, use

void XawPanedGetMinMax(w, min_return, max_return)
     Widget w;
     int *min_return, *max_return;

This procedure is equivalent to getting the min and max resources for this child child.

To enable or disable automatic recalculation of pane sizes and positions, use

void XawPanedSetRefigureMode(w, mode)
     Widget w;
     Boolean mode;

When making several changes to the children of a Paned widget after the Paned has been realized, it is a good idea to disable relayout until after all changes have been made.

To retrieve the number of panes in a paned widget use

int XawPanedGetNumSub(w)
     Widget w;

This function returns the number of panes in the Paned widget. This is not the same as the number of children, since the grips are also children of the Paned widget.

[Xraw home] [Xraw widget class hierarchy]