Struct native_windows_gui::ExternCanvas [−][src]
pub struct ExternCanvas { pub handle: ControlHandle, }
Expand description
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 child, 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.
As a top level window, the extern canvas has the same features as the window control. As a children control, resize and move events cannot be triggered and window parameters are not visible.
Builder parameters:
flags
: The window flags. SeeExternCanvasFlags
ex_flags
: A combination of win32 window extended flags. Unlikeflags
, ex_flags must be used straight from winapititle
: The text in the window title barsize
: The default size of the windowposition
: The default position of the window in the desktopicon
: The window iconparent
: Logical parent of the window, unlike children controls, this is NOT required.
Control events:
OnInit
: The window was createdMousePress(_)
: Generic mouse press events on the buttonOnMouseMove
: Generic mouse mouse eventOnMouseWheel
: Generic mouse wheel eventOnPaint
: Generic on paint eventOnKeyPress
: Generic key pressOnKeyRelease
: Generic ket releaseOnResize
: When the window is resizedOnResizeBegin
: Just before the window begins being resized by the userOnResizeEnd
: Just after the user stops resizing the windowOnWindowMaximize
: When the window is maximizedOnWindowMinimize
: When the window is minimizedOnMove
: When the window is moved by the userOnMinMaxInfo
: When the size or position of the window is about to change and the size of the windows must be restricted
Fields
handle: ControlHandle
Implementations
Invalidate the whole drawing region. For canvas that are children control, this should be called in the paint event.
Set the icon in the window
- icon: The new icon. If None, the icon is removed
Return true if the control user can interact with the control, return false otherwise
Enable or disable the control
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))
Show or hide the control to the user
Return the physical size of canvas in pixels considering the dpi scale
Set the position of the button in the parent window
Winapi class name used during control creation
Winapi flags required by the control
Trait Implementations
Auto Trait Implementations
impl RefUnwindSafe for ExternCanvas
impl !Send for ExternCanvas
impl !Sync for ExternCanvas
impl Unpin for ExternCanvas
impl UnwindSafe for ExternCanvas