Name

DwtScrollBarSetSlider − Sets or changes the current size/position parameters of the slider in the scroll bar widget. 

Syntax

void DwtScrollBarSetSlider(widget, value, shown, inc,
                           page_inc, notify)
     Widget widget;
     int value;
     int shown;
     int inc, page_inc;
     Boolean notify;

Arguments

widgetSpecifies the scroll bar widget ID. 

valueSpecifies the scroll bar’s top thumb (slider) position between DwtNminValue and DwtNmaxValue.  The attribute name associated with this argument is DwtNvalue. 

shownSpecifies the size of the slider as a value between zero and the absolute value of DwtNmaxValue minus DwtNminValue.  The size of the slider varies, depending on how much of the slider scroll area it represents.  This argument sets the DwtNshown attribute associated with DwtScrollBarCreate. 

incSpecifies the amount of button increment and decrement.  If this argument is nonzero, the scroll bar widget automatically adjusts the slider when an increment or decrement action occurs.  This argument sets the DwtNinc attribute associated with DwtScrollBarCreate. 

page_incSpecifies the amount of page increment and decrement.  If this argument is nonzero, the scroll bar widget automatically adjusts the slider when an increment or decrement action occurs.  This argument sets the DwtNpageInc attribute associated with DwtScrollBarCreate. 

notifySpecifies a boolean value that, when True, indicates a change in the scroll bar value and that the scroll bar widget automatically activates the DwtNvalueChangedCallback with the recent change.  If False, no change in the scroll bar’s value has occurred and DwtNvalueChangedCallback is not activated. 

Description

The DwtScrollBarSetSlider function sets or changes the currently displayed scroll bar widget slider for the application.  The scroll region is overlaid with a slider bar that is adjusted in size and position using the main scroll bar or set slider function attributes.  The stepping arrows and the slider are the scroll activator objects providing the user interface syntax “feel.”

See Also

DwtScrollBarGetSlider (3Dwt)
Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding