Struct native_windows_gui::Label

pub struct Label {
    pub handle: ControlHandle,
    // some fields omitted
}

A label is a single line of static text. Use \r\n to split the text on multiple lines.

Label is not behind any features.

Builder parameters:

• parent: Required. The label parent container.
• text: The label text.
• size: The label size.
• position: The label position.
• enabled: If the label is enabled. A disabled label won’t trigger events
• flags: A combination of the LabelFlags values.
• ex_flags: A combination of win32 window extended flags. Unlike flags, ex_flags must be used straight from winapi
• font: The font used for the label text
• background_color: The background color of the label
• h_align: The horizontal aligment of the label

Control events:

• OnLabelClick: When the user click the label
• OnLabelDoubleClick: When the user double click a label
• MousePress(_): Generic mouse press events on the label
• OnMouseMove: Generic mouse mouse event
• OnMouseWheel: Generic mouse wheel event

** Example **

use native_windows_gui as nwg;
fn build_label(label: &mut nwg::Label, window: &nwg::Window, font: &nwg::Font) {
    nwg::Label::builder()
        .text("Hello")
        .font(Some(font))
        .parent(window)
        .build(label);
}

Fields

handle: ControlHandle

Implementations

impl Label

pub fn builder<'a>() -> LabelBuilder<'a>

pub fn font(&self) -> Option<Font>

Return the font of the control

pub fn set_font(&self, font: Option<&Font>)

Set the font of the control

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 button.

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 label in the parent window

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

Set the size of the label in the parent window

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

Return the position of the label in the parent window

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

Set the position of the label in the parent window

pub fn text(&self) -> String

Return the label text

pub fn set_text<'a>(&self, v: &'a str)

Set the label text

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 Label

fn default() -> Label

Returns the “default value” for a type.

impl Drop for Label

fn drop(&mut self)

Executes the destructor for this type.

impl From<&'_ Label> for ControlHandle

fn from(control: &Label) -> Self

Performs the conversion.

impl From<&'_ mut Label> for ControlHandle

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

Performs the conversion.

impl PartialEq<ControlHandle> for Label

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

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

#[must_use]

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

This method tests for !=.

impl PartialEq<Label> for Label

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

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

#[must_use]

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

This method tests for !=.

impl PartialEq<Label> for ControlHandle

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

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

#[must_use]

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

This method tests for !=.