Struct winsafe::gui::UpDown

pub struct UpDown(/* private fields */);

Available on crate feature gui only.

Native up-down control.

Note that if the UpDown is created with UDS::AUTOBUDDY style, it takes the control created immediately before the UpDown as the buddy one, attaching the UpDown to it. This control should be an Edit with ES::NUMBER style.

Implementations

impl UpDown

pub fn new(parent: &impl GuiParent, opts: UpDownOpts) -> Self

Instantiates a new UpDown object, to be created on the parent window with HWND::CreateWindowEx.

Panics

Panics if the parent window was already created – that is, you cannot dynamically create an UpDown in an event closure.

Examples

In the example below, the UpDown has UDS::AUTOBUDDY style by default, so it will take the Edit, which was created immediately prior, as its buddy control. The UpDown will automatically attach itself to the Edit.

use winsafe::{self as w, prelude::*, co, gui};

let wnd: gui::WindowMain; // initialized somewhere

let txt = gui::Edit::new(
    &wnd,
    gui::EditOpts {
        edit_style: co::ES::AUTOHSCROLL | co::ES::NOHIDESEL | co::ES::NUMBER,
        ..Default::default()
    },
);

let updn = gui::UpDown::new(
    &wnd,
    gui::UpDownOpts {
        range: (0, 50),
        ..Default::default()
    },
);

pub fn new_dlg(parent: &impl GuiParent, ctrl_id: u16) -> Self

Instantiates a new UpDown object, to be loaded from a dialog resource with HWND::GetDlgItem.

Panics

Panics if the parent dialog was already created – that is, you cannot dynamically create an UpDown in an event closure.

pub fn pos(&self) -> i32

Retrieves the current position by sending an udm::GetPos32 message.

pub fn range(&self) -> (i32, i32)

Retrieves the minimum and maximum position values by sending an udm::GetRange32 message.

pub fn set_pos(&self, pos: i32)

Sets the current position by sending an udm::SetPos32 message.

pub fn set_range(&self, min: i32, max: i32)

Set the control range by sending an udm::SetRange32 message.

Trait Implementations

impl Clone for UpDown

fn clone(&self) -> UpDown

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl GuiChild for UpDown

fn ctrl_id(&self) -> u16

Returns the control ID, which is defined at control creation.

impl GuiNativeControl for UpDown

fn on_subclass(&self) -> &WindowEvents

Exposes the subclass events. If at least one event exists, the control will be subclassed.

impl GuiNativeControlEvents<UpDownEvents> for UpDown

fn on(&self) -> &UpDownEvents

Exposes the specific control events.

impl GuiWindow for UpDown

fn hwnd(&self) -> &HWND

Returns the underlying handle for this control.

fn as_any(&self) -> &dyn Any

Converts a reference to the Any trait. This is useful when storing a collection of polymorphic controls, because Any allows downcasting.

impl Send for UpDown