Struct native_windows_gui::Bitmap

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

A wrapper over a bitmap file (*.bmp)

Note that Bitmap object are only used as display resources (ie: it's impossible to read pixels or resized it). If those features are needed, see the image-decoder feature.

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

By default, bitmap resources do not support transparency BUT if image-decoder is enabled, bitmaps can be loaded from any file type supported by NWG (JPEG, PNG, BMP, ICO, DDS, TIFF).

Bitmaps can be converted to icons using the "copy_as_icon" function.

Builder parameters:

• source_file: The source of the bitmap if it is a file.
• source_bin: The source of the bitmap if it is a binary blob. For example using include_bytes!("my_icon.bmp").
• source_system: The source of the bitmap if it is a system resource (see OemBitmap)
• source_embed: The source of the bitmap 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_bitmap() -> nwg::Bitmap {
    let mut bitmap = nwg::Bitmap::default();

    nwg::Bitmap::builder()
        .source_file(Some("Hello.bmp"))
        .strict(true)
        .build(&mut bitmap);

    bitmap
}

Fields

handle: HANDLE

Implementations

impl Bitmap

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

pub fn copy_as_icon(&self) -> Icon

Creates a new icon from the bitmap data. The bitmap must have been initialized

Trait Implementations

impl Default for Bitmap

fn default() -> Bitmap

Returns the "default value" for a type.

impl Drop for Bitmap

fn drop(&mut self)

Executes the destructor for this type.

impl PartialEq<Bitmap> for Bitmap

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.