Classes¶

TabStack inherits behavior and resources form Core, Composite, Constraint, XmManager and XmBulletinBoard Classes.

The class pointer is xmTabStackWidgetClass.

The class name is XmTabStack.

New Resources¶

The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the XmN or XmC prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the Xm or prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time(C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is not applicable (N/A).

XmNfontList

Specifies the XmFontList to use when drawing the label strings for the tabs.

XmNhighlightThickness

Specifies the thickness of the rectangle drawn around the label string and label pixmap of the tab with keyboard traversal.

XmNstackedEffect

Specifies if the visuals should depict a stack of folders, True, or if the XmTabStack should use all available space for its children, False.

XmNtabAutoSelect

Specifies if a tab is automatically selected when it receives keyboard traversal.

XmNtabCornerPercent

Specifies the percent of the font height that should be used for the corner visual.

XmNtabLabelSpacing

Specifies the amount of space to leave between a text label and a pixmap in the tab area.

XmNtabMarginHeight

Specifies the vertical border that is placed around the label area of a tab.

XmNtabMarginWidth

Specifies the horizontal border that is placed around the label area of a tab.

XmNtabMode

Specifies the mode in which the XmTabStack distributes the tabs. Valid values for this resource include:

XmNtabOffset

Specifies the amount of indentation used to stagger the tab rows when displaying tabs in either the XmTABS_STACKED or XmTABS_STACKED_STATIC mode.

XmNtabOrientation

Specifies the orientation of the tab, and the rotation factor of the tab label. Valid values for this resource include:

XmNtabSelectColor

Specifies the color of the selected tab.

XmNtabSelectedCallback

Specifies the list of callbacks to call when a child becomes the selected tab.

XmNtabSelectPixmap

Specifies the pixmap of the selected tab.

XmNtabSide

Specifies the location of the tab with respect to the children of the XmTabStack. Valid values for this resource include:

XmNtabStyle

Specifies the appearance of the tabs associated with the children of the XmTabStack. Valid values for this resource include:

XmNuniformTabSize

Determines if all tabs should have a uniform major dimension, where the major dimension is width if the tab orientation is XmTABS_LEFT_TO_RIGHT or XmTABS_RIGHT_TO_LEFT or height if the tab orientation is XmTABS_TOP_TO_BOTTOM or XmTABS_BOTTOM_TO_TOP. When XmNtabMode is either XmTABS_STACKED or XmTABS_STACKED_STATIC, this resource is forced to True.

XmNuseImageCache

Destermines if the Xmmages used for rotating text and pixmaps should be cached. This increases performance but uses up more memory.

XmTabStack Constraint Resource Set
Name	Default	Access
Class	Type
XmNfreeTabPixmap	False	CSG
XmCFreeTabPixmap	Boolean
XmNtabAlignment	XmALIGNMENT_CENTER	CSG
XmCAlignment	unsigned char
XmNtabBackground	Dynamic	CSG
XmCBackground	Pixel
XmNtabBackgroundPixmap	Dynamic	CSG
XmCBackgroundPixmap	Pixmap
XmNtabForeground	Dynamic	CSG
XmCForeground	Pixel
XmNtabLabelPixmap	XmUNSPECIFIED_PIXMAP	CSG
XmCTabLabelPixmap	Pixmap
XmNtabLabelString	NULL	CSG
XmCTabLabelString	XmString
XmNtabPixmapPlacement	XmPIXMAP_RIGHT	CSG
XmCTabPixmapPlacement	XmPixmapPlacement
XmNtabStringDirection	XmSTRING_DIRECTION_DEFAULT	CSG
XmCTabStringDirection	unsigned char

XmNfreeTabPixmap

Specifies that the pixmaps assigned to the XmNlabelPixmap resources should be freed when the widget is destroyed.

XmNtabAlignment

Specifies the alignment of the tab label. Valid values for this resource include:

XmNtabBackground

Specifies the background pixel for the tab.

XmNtabBackgroundPixmap

Specifies the background pixmap for the tab.

XmNtabForeground

Specifies the foreground pixel for the tab.

XmNtabLabelPixmap

Specifies the pixmap to display in the tab label.

XmNtabLabelString

Specifies the XmString to display as the textual portion of the tab label. This is copied when set on the widget. The value fetched via XtGetValues should not be freed as it returns a pointer to the widgets value. If you wish to use the value returned from XtGetValues use XmStringCopy the returned value.

XmNtabPixmapPlacement

Specifies the location of the pixmap with respect to the text in the tab label. Valid values for this resource include:

XmNtabStringDirection

Specifies the string direction for the XmString portion of the tab label. Valid values for this resource include:

Inherited Resources¶

TabStack inherits behavior and resources from the following superclasses. For a complete description of each resource, refer to the man page for that superclass.

Calback Information¶

A pointer to the following structure is passed to each callback:

typedef struct _XmTabStackCallbackStruct {
	int	reason;
	XEvent	*event;
	Widget	selected_child;
} XmTabStackCallbackStruct;

reason

Indicates why the callback was invoked. Valid callbacks reasons include:

event

Points to the XEvent that triggered the callback.

selected_child

Contains the widget ID of the selected child.

Translations¶

XmTabStack includes the translations from the XmManager.

Additional Behavior¶

The XmTabStack has no additional behavior.

Virtual Bindings¶

The bindings for virtual keys are vendor specific. For information about bindings for virtual buttons and keys, see VirtualBindings(3X).