Struct native_windows_gui::Icon

pub struct Icon {
    pub handle: HANDLE,
    // some fields omitted
}

A wrapper over a icon file (*.ico)

Windows icons are a legacy thing and should only be used when winapi forces you to use them (ex: when setting a window icon). The Bitmap object of NWG not only supports transparency if "image-decoder" is enabled but it can also be create from multiple different sources (including ".ico" files).

To display a icon in an application, see the ImageFrame control.

Note: Loading an icon from binary source (source_bin) REQUIRES the "image-decoder" feature.

Builder parameters:

• source_file: The source of the icon if it is a file.
• source_bin: The source of the icon if it is a binary blob. For example using include_bytes!("my_icon.ico").
• source_system: The source of the icon if it is a system resource (see OemIcon)
• source_embed: The source of the icon if it is stored in an embedded file
• source_embed_id: The number identifier of the icon in the embedded file
• source_embed_str: The string identifier of the icon in the embedded file
• size: Optional. Resize the image to this size.
• strict: Use a system placeholder instead of panicking if the image source do no exists.

Example:

use native_windows_gui as nwg;

fn load_icon() -> nwg::Icon {
    let mut icon = nwg::Icon::default();

    nwg::Icon::builder()
        .source_file(Some("hello.ico"))
        .strict(true)
        .build(&mut icon);

    icon
}

Fields

handle: HANDLE

Implementations

impl Icon

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

pub fn from_system(cursor: OemIcon) -> Icon

Trait Implementations

impl Default for Icon

pub fn default() -> Icon

Returns the "default value" for a type.

impl PartialEq<Icon> for Icon

pub 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 !=.