This section contains information about the programming elements used with up-down controls.

Overviews

Up-Down Controls

An up-down control is a pair of arrow buttons that the user can click to increment or decrement a value, such as a scroll position or a number displayed in a companion control (called a buddy window).

Functions

CreateUpDownControl

Creates an up-down control. Note: This function is obsolete. It is a 16 bit function and cannot handle 32 bit values for range and position.

Messages

UDM_GETACCEL

Retrieves acceleration information for an up-down control.

UDM_GETBASE

Retrieves the current radix base (that is, either base 10 or 16) for an up-down control.

UDM_GETBUDDY

Retrieves the handle to the current buddy window.

UDM_GETPOS

Retrieves the current position of an up-down control with 16-bit precision.

UDM_GETPOS32

Returns the 32-bit position of an up-down control.

UDM_GETRANGE

Retrieves the minimum and maximum positions (range) for an up-down control.

UDM_GETRANGE32

Retrieves the 32-bit range of an up-down control.

UDM_GETUNICODEFORMAT

Retrieves the Unicode character format flag for the control.

UDM_SETACCEL

Sets the acceleration for an up-down control.

UDM_SETBASE

Sets the radix base for an up-down control. The base value determines whether the buddy window displays numbers in decimal or hexadecimal digits. Hexadecimal numbers are always unsigned, and decimal numbers are signed.

UDM_SETBUDDY

Sets the buddy window for an up-down control.

UDM_SETPOS

Sets the current position for an up-down control with 16-bit precision.

UDM_SETPOS32

Sets the position of an up-down control with 32-bit precision.

UDM_SETRANGE

Sets the minimum and maximum positions (range) for an up-down control.

UDM_SETRANGE32

Sets the 32-bit range of an up-down control.

UDM_SETUNICODEFORMAT

Sets the Unicode character format flag for the control. This message allows you to change the character set used by the control at run time rather than having to re-create the control.

Notifications

NM_RELEASEDCAPTURE (up-down)

Notifies an up-down control's parent window that the control is releasing mouse capture. This notification is sent in the form of a WM_NOTIFY message.

UDN_DELTAPOS

Sent by the operating system to the parent window of an up-down control when the position of the control is about to change. This happens when the user requests a change in the value by pressing the control's up or down arrow. The UDN_DELTAPOS message is sent in the form of a WM_NOTIFY message.

Structures

NMUPDOWN

Contains information specific to up-down control notification messages. It is identical to and replaces the NM_UPDOWN structure.

UDACCEL

Contains acceleration information for an up-down control.

Constants

Up-Down Control Styles

This section lists the styles used when creating up-down controls.