Struct native_windows_gui::ExternCanvas

pub struct ExternCanvas {
    pub handle: ControlHandle,
}

An ExternCanvas is a window/children control that is painted to by an external API (such as OpenGL, Vulkan or DirectX).

When building a ExternCanvas, leaving the parent field empty will create a window-like canvas. If a parent is set, the canvas will be a children control (like a button).

When used as a chidren, ExternCanvas can be used as a way to add highly dynamic controls to a NWG application (ex: a video player).

Requires the extern-canvas feature.

Fields

handle: ControlHandle

Implementations

impl ExternCanvas

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

pub fn invalidate(&self)

Invalidate the whole drawing region. For canvas that are children control, this should be called in the paint event.

pub fn icon(&self) -> Option<Icon>

Return the icon of the window

pub fn set_icon(&self, icon: Option<&Icon>)

Set the icon in the window

• icon: The new icon. If None, the icon is removed

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

pub fn physical_size(&self) -> (u32, u32)

Return the physical size of canvas in pixels considering the dpi scale

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

Set the size of the button in the parent window

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

Return the position of the button in the parent window

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

Set the position of the button in the parent window

pub fn text(&self) -> String

Return window title

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

Set the window title

pub fn class_name(&self) -> &'static str

Winapi class name used during control creation

pub fn flags(&self) -> u32

pub fn forced_flags(&self) -> u32

Winapi flags required by the control

Trait Implementations

impl Default for ExternCanvas

fn default() -> ExternCanvas

Returns the "default value" for a type.

impl Drop for ExternCanvas

fn drop(&mut self)

Executes the destructor for this type.

impl<'_> From<&'_ ExternCanvas> for ControlHandle

fn from(control: &ExternCanvas) -> Self

Performs the conversion.

impl PartialEq<ControlHandle> for ExternCanvas

fn eq(&self, other: &ControlHandle) -> 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 !=.

impl PartialEq<ExternCanvas> for ControlHandle

fn eq(&self, other: &ExternCanvas) -> 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 !=.