Identifies the slider component that is to be modified. Specify one of the
following:
Format
attribute.
Identifies the format in which the information should be interpreted by
the slider if setting the slider arm position is requested. This value is
a reserved field for other set requests. The format is one of the following:
SMA_RANGEVALUE
Number of pixels between the home
position and the current arm position.
SMA_INCREMENTVALUE
Increment position using the primary scale.
ulInfo (ULONG)
New
value.
New value to change the slider component to. The format of the information
depends on the component being changed and is indicated by the SMA_* message
attribute or attributes that are set.
- If the SMA_SHAFTDIMENSIONS attribute is set, the ulInfo
parameter is as follows:
usShaftBreadth (USHORT)
Width (for vertical sliders) or height (for horizontal
sliders) the slider shaft should be set to, in pixels. This is the breadth
the shaft should be.
If
the SMA_SHAFTPOSITION attribute is set, the ulInfo parameter is as
follows:
xShaftCoord (USHORT)
X-coordinate
to set the position of the shaft to within the slider window. This value
is expressed in window coordinates and represents the lower-left corner
of the shaft.
yShaftCoord (USHORT)
Y-coordinate to set the position of the shaft to
within the slider window. This value is expressed in window coordinates
and represents the lower-left corner of the shaft.
If
the SMA_SLIDERARMDIMENSIONS attribute is set, the ulInfo parameter
is as follows:
usArmLength (USHORT)
Length
of the slider arm, in pixels. This is the width of the arm for horizontal
sliders and the height of the arm for vertical sliders.
usArmBreadth
(USHORT)
Breadth
of the slider arm, in pixels. This is the height of the arm for horizontal
sliders and the width of the arm for vertical sliders.
If
the SMA_SLIDERARMPOSITION and SMA_RANGEVALUE attributes are set, the ulInfo
parameter is as follows:
usArmPos (USHORT)
Number
of pixels to be set from home to the slider arm.
If
the SMA_SLIDERARMPOSITION and SMA_INCREMENTVALUE attributes are set, the
ulInfo parameter is as follows:
usIncrementPos (USHORT)
Increment value which corresponds to the position
the slider arm should be set to.
rc (BOOL)
Success
indicator.
TRUE
Slider component was successfully set.
FALSE
An error occurred. The WinGetLastError
function may return the following errors:
- PMERR_INVALID_PARAMETERS
PMERR_PARAMETER_OUT_OF_RANGE.
[Back]
[Next]