Struct native_windows_gui::TrackBar

pub struct TrackBar {
    pub handle: ControlHandle,
    /* private fields */
}

A trackbar is a window that contains a slider (sometimes called a thumb) in a channel, and optional tick marks. When the user moves the slider, using either the mouse or the direction keys, the trackbar sends notification messages to indicate the change.

Requires the trackbar feature.

Builder parameters:

• parent: Required. The trackbar parent container.
• size: The trackbar size.
• position: The trackbar position.
• focus: The control receive focus after being created
• flags: A combination of the TrackBarFlags values.
• ex_flags: A combination of win32 window extended flags. Unlike flags, ex_flags must be used straight from winapi
• range: The value range of the trackbar
• selected_range: The selected value range of the trackbar. Used with TrackBarFlags::RANGE
• pos: The current value of the trackbar
• background_color: The background color the of the trackbar

Control events:

• OnVerticalScroll: When the value of a trackbar with the VERTICAL flags is changed
• OnHorizontalScroll: When the value of a trackbar with the HORIZONTAL flags is changed
• MousePress(_): Generic mouse press events on the button
• OnMouseMove: Generic mouse mouse event
• OnMouseWheel: Generic mouse wheel event

use native_windows_gui as nwg;
fn build_trackbar(track: &mut nwg::TrackBar, window: &nwg::Window) {
    nwg::TrackBar::builder()
        .range(Some(0..100))
        .pos(Some(10))
        .parent(window)
        .build(track);
}

Fields

handle: ControlHandle

Implementations

impl TrackBar

pub fn builder() -> TrackBarBuilder

pub fn pos(&self) -> usize

Retrieves the current logical position of the slider in a trackbar. The logical positions are the integer values in the trackbar’s range of minimum to maximum slider positions.

pub fn set_pos(&self, p: usize)

Sets the current logical position of the slider in a trackbar.

pub fn selection_range_pos(&self) -> Range<usize>

Retrieves the starting and ending position of the current selection range in a trackbar. Only work for trackbar with the Range flags

pub fn set_selection_range_pos(&self, value: Range<usize>)

Sets the range value of the trackbar Only work for trackbar with the Range flags

pub fn range_min(&self) -> usize

Retrieves the minimum position for the slider in a trackbar.

pub fn set_range_min(&self, min: usize)

Sets the minium logical position for the slider in a trackbar.

pub fn range_max(&self) -> usize

Retrieves the maximum position for the slider in a trackbar.

pub fn set_range_max(&self, max: usize)

Sets the maximum logical position for the slider in a trackbar.

pub fn tics_len(&self) -> usize

Retrieves the number of tick marks in a trackbar

pub fn tic_value(&self, index: usize) -> usize

Retrieves the logical position of a tick mark in a trackbar. The logical position can be any of the integer values in the trackbar’s range of minimum to maximum slider positions.

pub fn enabled(&self) -> bool

Return true if the control user can interact with the control, return false otherwise

pub fn set_enabled(&self, v: bool)

Enable or disable the control

pub fn visible(&self) -> bool

Return true if the control is visible to the user. Will return true even if the control is outside of the parent client view (ex: at the position (10000, 10000))

pub fn set_visible(&self, v: bool)

Show or hide the control to the user

pub fn size(&self) -> (u32, u32)

Return the size of the button in the parent window

pub fn set_size(&self, x: u32, y: u32)

Set the size of the button in the parent window

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

Return the position of the button in the parent window

pub fn set_position(&self, x: i32, y: i32)

Set the position of the button in the parent window

pub fn focus(&self) -> bool

Return true if the control currently has the keyboard focus

pub fn set_focus(&self)

Set the keyboard focus on the track bar

pub fn class_name(&self) -> &'static str

Winapi class name used during control creation

pub fn flags(&self) -> u32

Winapi base flags used during window creation

pub fn forced_flags(&self) -> u32

Winapi flags required by the control

Trait Implementations

impl Default for TrackBar

fn default() -> TrackBar

Returns the “default value” for a type.

impl Drop for TrackBar

fn drop(&mut self)

Executes the destructor for this type.

impl From<&TrackBar> for ControlHandle

fn from(control: &TrackBar) -> Self

Converts to this type from the input type.

impl From<&mut TrackBar> for ControlHandle

fn from(control: &mut TrackBar) -> Self

Converts to this type from the input type.

impl PartialEq<ControlHandle> for TrackBar

fn eq(&self, other: &ControlHandle) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<TrackBar> for ControlHandle

fn eq(&self, other: &TrackBar) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<TrackBar> for TrackBar

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.