Struct native_windows_gui::Icon

pub struct Icon {
    pub handle: HANDLE,
    /* private fields */
}

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 {
    nwg::Icon::from_file("hello.ico", true).unwrap()
}

fn load_icon_builder() -> 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(sys_icon: OemIcon) -> Icon

Single line helper function over the icon builder api.

Use system resources.

pub fn from_file(path: &str, strict: bool) -> Result<Icon, NwgError>

Single line helper function over the icon builder api.

Use a file resource.

pub fn from_bin(bin: &[u8]) -> Result<Icon, NwgError>

Single line helper function over the icon builder api.

Use a binary resource.

pub fn from_embed(
    embed: &EmbedResource,
    embed_id: Option<usize>,
    embed_str: Option<&str>
) -> Result<Icon, NwgError>

Single line helper function over the icon builder api.

Use an embedded resource. Either embed_id or embed_str must be defined, not both.

Requires the embed-resource feature.

Trait Implementations

impl Default for Icon

fn default() -> Icon

Returns the “default value” for a type.

impl Drop for Icon

fn drop(&mut self)

Executes the destructor for this type.

impl PartialEq<Icon> for Icon

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.