Struct winsafe::gui::WindowControl

pub struct WindowControl(/* private fields */);

Available on crate feature gui only.

An user child window, which can handle events. Can be programmatically created or load a dialog resource from a .res file.

Implementations

impl WindowControl

pub fn new(parent: &impl GuiParent, opts: WindowControlOpts) -> Self

Instantiates a new WindowControl object, to be created internally with HWND::CreateWindowEx.

Panics

Panics if the parent window was already created – that is, you cannot dynamically create a WindowControl in an event closure.

pub fn new_dlg( parent: &impl GuiParent, dialog_id: u16, position: POINT, resize_behavior: (Horz, Vert), ctrl_id: Option<u16> ) -> Self

Instantiates a new WindowControl object, to be loaded from a dialog resource with HINSTANCE::CreateDialogParam.

If the parent window is a dialog, position is in Dialog Template Units; otherwise in pixels, which will be multiplied to match current system DPI.

Panics

Panics if the parent dialog was already created – that is, you cannot dynamically create a WindowControl in an event closure.

Trait Implementations

impl Clone for WindowControl

fn clone(&self) -> WindowControl

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl GuiChild for WindowControl

fn ctrl_id(&self) -> u16

Returns the control ID, which is defined at control creation.

impl GuiParent for WindowControl

fn on(&self) -> &WindowEvents

Exposes methods to handle the basic window messages, plus timer and native control notifications.

fn spawn_new_thread<F>(&self, func: F)

where F: FnOnce() -> AnyResult<()> + Send + 'static,

This method calls std::thread::spawn, but it allows the returning of an error value. This error value will be forwarded to the original UI thread, allowing it to be caught at WindowMain::run_main.

fn run_ui_thread<F>(&self, func: F)

where F: FnOnce() -> AnyResult<()> + Send + 'static,

Runs a closure synchronously in the window’s original UI thread, allowing UI updates without the risk of a deadlock.

impl GuiWindow for WindowControl

fn hwnd(&self) -> &HWND

Returns the underlying handle for this control.

fn as_any(&self) -> &dyn Any

Converts a reference to the Any trait. This is useful when storing a collection of polymorphic controls, because Any allows downcasting.

impl Send for WindowControl