The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Win32::GUI::UpDown - Create and manipulate up-down controls

DESCRIPTION

[TBD]

METHODS

Common methods apply to most windows, controls and resources.

new

new(PARENT, %OPTIONS)

Creates a new UpDown object; can also be called as PARENT->AddUpDown(%OPTIONS).

Class specific %OPTIONS are:

  -align => left,right
    When Left, positions the up-down control next to the left edge of the buddy window.
    The buddy window is moved to the right, and its width is decreased to accommodate the
    width of the up-down control.
    When right, positions the up-down control next to the right edge of the buddy window.
    The width of the buddy window is decreased to accommodate the width of the up-down control.
  -nothousands => 0/1
    Does not insert a thousands separator between every three decimal digits.
  -wrap => 0/1 (default 0)
    Causes the position to "wrap" if it is incremented or decremented beyond the ending or beginning of the range.
  -horizontal => 0/1
    Causes the up-down control's arrows to point left and right instead of up and down.
  -autobuddy => 0/1
    Automatically selects the previous window in the z-order as the up-down control's buddy window.
  -setbuddy => 0/1
    Causes the up-down control to set the text of the buddy window (using the WM_SETTEXT message)
    when the position changes. The text consists of the position formatted as a decimal or hexadecimal string.
  -arrowkeys => 0/1
    Causes the up-down control to increment and decrement the position when the UP ARROW and
    DOWN ARROW keys are pressed.

See also the common options.

Base

Base([VALUE])

Gets or sets the radix base for the UpDown control; VALUE can be either 10 or 16 for decimal or hexadecimal base numbering.

Buddy

Buddy([OBJECT])

Gets or sets the buddy window for the UpDown control. Returns the handle of the buddy.

GetBase

GetBase()

Gets the radix base for the UpDown control.

GetBuddy

GetBuddy()

Returns the handle of the buddy.

GetPos

GetPos()

Gets the current position of the UpDown control.

GetRange

GetRange()

Gets the range for the UpDown control (16bit values)

GetRange32

GetRange32()

Gets the range for the UpDown control (32bit values)

Pos

Pos([VALUE])

Gets or sets the current position of the UpDown control.

Range

Range([MIN, MAX])

Gets or sets the range for the UpDown control; if no parameter is given, returns a two element array containing the MIN and MAX range values, otherwise sets them to the given values. If MAX is lower than MIN, the UpDown control function is reversed, eg. the up button decrements the value and the down button increments it

Range32

Range32([MIN, MAX])

Gets or sets the range for the UpDown control; if no parameter is given, returns a two element array containing the MIN and MAX range values, otherwise sets them to the given values. If MAX is lower than MIN, the UpDown control function is reversed, eg. the up button decrements the value and the down button increments it

SetBase

SetBase(VALUE)

Sets the radix base for the UpDown control; VALUE can be either 10 or 16 for decimal or hexadecimal base numbering.

SetBuddy

SetBuddy(OBJECT)

Sets the buddy window for the UpDown control. Returns the handle of the previous buddy.

SetPos

SetPos(VALUE)

Sets the current position of the UpDown control.

SetRange

SetRange(START,END)

Sets the range for the UpDown control (16bit values)

SetRange32

SetRange32(START,END)

Sets the range for the UpDown control (32bit values)

EVENTS

Common events apply to most windows and controls.

Scroll

Scroll(SCROLLBAR, OPERATION, POSITION)

Sent when one of the window scrollbars is moved. SCROLLBAR identifies which bar was moved, 0 for horizontal and 1 for vertical.

OPERATION can be compared against one of the following constants: SB_LINEUP, SB_LINELEFT, SB_LINEDOWN, SB_LINERIGHT, SB_PAGEUP SB_PAGELEFT, SB_PAGEDOWN, SB_PAGERIGHT, SB_THUMBPOSITION, SB_THUMBTRACK, SB_TOP, SB_LEFT, SB_BOTTOM, SB_RIGHT, SB_ENDSCROLL

VERSION

Documentation for Win32::GUI v1.14 created 01 Jun 2017

This document is autogenerated by the build process. Edits made here will be lost. Edit docs/per_package.tpl instead.

SUPPORT

Homepage: http://perl-win32-gui.sourceforge.net/.

For further support join the users mailing list from the website at http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users. There is a searchable list archive at http://sourceforge.net/p/perl-win32-gui/mailman/perl-win32-gui-users/.

COPYRIGHT and LICENCE

Copyright (c) 1997..2017 Aldo Calpini. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.