Struct native_windows_gui::Font

pub struct Font {
    pub handle: HFONT,
}

Represent a system font.

Can be used with any controls that draws text. Due to the very limited way win32 can draw text, only family, size and weight can be configured.

Example:

use native_windows_gui as nwg;

fn build_font() -> nwg::Font {
    let mut font = nwg::Font::default();

    nwg::Font::builder()
        .size(16)
        .family("Arial")
        .weight(1000)
        .build(&mut font);

    font
}

Fields

handle: HFONT

Implementations

impl Font

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

pub fn set_global_default(font: Option<Font>) -> Option<Font>

Set the default (application global!) font that will be used when creating controls and return the old one

pub fn set_global_family(family: &str) -> Result<Option<Font>, NwgError>

Set the default (application global!) font that will be used when creating controls This is a shortcut over Font::set_global_default

pub fn global_default() -> Option<Font>

Return the default font that was previously set using Font::set_default

pub fn add_font(path: &str) -> bool

Add a font to the system font table. Don’t forget to call Font::remove_font(path) once your done. Returns false if the font could not be added. Windows won’t tell you why though.

Other info:

• The value of path can be a ttf or a otf font.
• Adding the same font multiple time increase the internal refcount
• Use Font::families() to return the available system font families

pub fn remove_font(path: &str)

Remove a font that was previously added by Font::add_font

pub fn add_memory_font(bin: &mut [u8]) -> Result<MemFont, ()>

Add a font resource from a binary source. Returns a memory font handle if the font was loaded succesfully. Send the handle to remove_memory_font at the end of your program to free the font from memory.

pub fn remove_memory_font(font: MemFont)

Remove a font that was previously added by Font::add_memory_font

pub fn families() -> Vec<String>

Returns all the font families loaded on the OS. Probably pretty slow, so cache the value if possible

Trait Implementations

impl Debug for Font

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Font

fn default() -> Font

Returns the “default value” for a type.

impl Eq for Font

impl PartialEq<Font> for Font

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

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

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

This method tests for !=.

impl Send for Font

impl StructuralEq for Font

impl StructuralPartialEq for Font

impl Sync for Font