Struct winsafe::gui::WindowModeless

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

Available on crate feature gui only.

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

Implementations

impl WindowModeless

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

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

Panics

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

pub fn new_dlg(parent: &impl GuiParent, dialog_id: u16, position: POINT) -> Self

Instantiates a new WindowModeless 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 WindowModeless in an event closure.

Trait Implementations

impl Clone for WindowModeless

fn clone(&self) -> WindowModeless

Returns a copy of the value.

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

Performs copy-assignment from source.

impl GuiParent for WindowModeless

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 GuiParentPopup for WindowModeless

fn close(&self)

Closes the window by posting a WM_CLOSE message. This is the safest way to close any popup window, because you’re able to process the wm_close event, just like if the user clicked the window “X” button.

impl GuiWindow for WindowModeless

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 GuiWindowText for WindowModeless

fn set_text(&self, text: &str)

Sets the text by calling HWND::SetWindowText.

fn text(&self) -> String

Retrieves the text by calling HWND::GetWindowText.

impl Send for WindowModeless