DwtScrollWindow(3Dwt) 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.
name Specifies the name of the created widget.
x Specifies 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.
y Specifies, 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.
width Specifies in pixels the width of the widget window. This argument sets the DwtNwidth core widget attribute.
height Specifies 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 win-
dow 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 wid-
gets 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 geome-
try manager
DwtNy Position Determined by the geome-
try 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 con-
tained in that window to
be set to the same sen-
sitivity as the scroll
window.
DwtNancestorSensitive Boolean The bitwise AND of the
parent widget's DwtNsen-
sitive and DwtNances-
torSensitive attributes
DwtNaccelerators XtTranslations NULL
DwtNdepth int Depth of the parent win-
dow
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.
DwtNworkWindow Specifies 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.
See Also
Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding
DwtScrollWindow(3Dwt)