DwtScrollWindow(3Dwt)

Name

DwtScrollWindow, DwtScrollWindowCreate − Creates a scroll window widget for simple applications in the main window widget work area.

Syntax

Widget DwtScrollWindow(parent_widget, name, x, y,
                          width, height)
     Widget parent_widget;
     char *name;
     Position x, y;
     Dimension width, height;

Widget DwtScrollWindowCreate (parent_widget, name,
                              override_arglist,
                              override_argcount)
     Widget parent_widget;
     char *name;
     ArgList override_arglist;
     int override_argcount;

Arguments

parent_widget
Specifies the parent widget ID.

nameSpecifies the name of the created widget.

xSpecifies the placement, in pixels, of the left side of the widget window relative to the inner upper left corner of the parent window. This argument sets the DwtNx core widget attribute.

ySpecifies, in pixels, the placement of the top of the widget window relative to the inner upper left corner of the parent window. This argument sets the DwtNy core widget attribute.

widthSpecifies in pixels the width of the widget window. This argument sets the DwtNwidth core widget attribute.

heightSpecifies in pixels the height of the widget window. This argument sets the DwtNheight core widget attribute.

override_arglist
Specifies the application override argument list.

override_argcount
Specifies the number of attributes in the application override argument list (override_arglist).

Description

The DwtScrollWindow and DwtScrollWindowCreate functions create an instance of a scroll window widget and return its associated widget ID. This widget provides a more direct XUI interface for applications with scroll bars. When calling DwtScrollWindow, you set the scroll window widget attributes presented in the formal parameter list. For DwtScrollWindowCreate, you specify a list of attribute name/value pairs that represent all the possible scroll window widget attributes.

The DwtScrollWindow and DwtScrollWindowCreate functions create a composite widget that can contain vertical and horizontal scroll bar widgets and any widget as the window region. Scroll bar positioning and scroll bar slider sizes are automatically maintained. The scroll window widget simplifies programming by allowing you to create an application with scroll bars directly in the scroll window widget work area.

Inherited Attributes

Attribute Name	Data Type	Default
Core Attributes
DwtNx	Position	Determined by the geometry manager
DwtNy	Position	Determined by the geometry manager
DwtNwidth	Dimension	Widget-specific
DwtNheight	Dimension	Widget-specific
DwtNborderWidth	Dimension	One pixel
DwtNborder	Pixel	Default foreground color
DwtNborderPixmap	Pixmap	NULL
DwtNbackground	Pixel	Default background color
DwtNbackgroundPixmap	Pixmap	NULL
DwtNcolormap	Colormap	Default color map
DwtNsensitive	Boolean	True
		Setting the sensitivity of the scroll window causes all widgets contained in that window to be set to the same sensitivity as the scroll window.
DwtNancestorSensitive	Boolean	The bitwise AND of the parent widget’s DwtNsensitive and DwtNancestorSensitive attributes
DwtNaccelerators	XtTranslations	NULL
DwtNdepth	int	Depth of the parent window
DwtNtranslations	XtTranslations	NULL
DwtNmappedWhenManaged	Boolean	True
DwtNscreen	Screen *	The parent screen
DwtNdestroyCallback	DwtCallbackPtr	NULL
Common Attributes
DwtNforeground	Pixel	Default foreground color
DwtNhighlight	Pixel	Default foreground color
DwtNhighlightPixmap	Pixmap	NULL
DwtNuserData	Opaque *	NULL
DwtNdirectionRToL	unsigned char	DwtDirectionRightDown
DwtNfont	NOT SUPPORTED
DwtNhelpCallback	NOT SUPPORTED

Widget-Specific Attributes

You can set the following widget-specific attributes in the override_arglist:

Attribute Name	Data Type	Default
DwtNhorizontalScrollBar	Widget	NULL
DwtNverticalScrollBar	Widget	NULL
DwtNworkWindow	Widget	NULL
DwtNshownValueAutomaticHoriz	Boolean	True
DwtNshownValueAutomaticVert	Boolean	True

DwtNhorizontalScrollBar
Specifies the scroll bar widget ID for the horizontal scroll bar to be associated with the scroll window widget. You can set this ID only after creating an instance of the main window widget.

DwtNverticalScrollBar
Specifies the scroll bar widget ID for the vertical scroll bar to be associated with the scroll window widget. You can set this ID only after creating an instance of the main window widget.

DwtNworkWindowSpecifies the widget ID for the work window to be associated with the scroll window widget. You can set this ID only after creating an instance of the main window widget.

DwtNshownValueAutomaticHoriz
Specifies a boolean value that, when True, indicates that DwtScrollWindow automatically sets the value for the DwtNshown attribute for the specified horizontal scroll bar widget.

DwtNshownValueAutomaticVert
Specifies a boolean value that, when True, indicates that DwtScrollWindow automatically sets the value for the DwtNshown attribute for the specified vertical scroll bar widget.

Return Values

These functions return the ID of the created widget.

Museum