Struct WindowRequest 

#[non_exhaustive]
pub struct WindowRequest {

    pub id: WindowId,
    pub title: Txt,
    pub state: WindowStateAll,
    pub kiosk: bool,
    pub default_position: bool,
    pub video_mode: VideoMode,
    pub visible: bool,
    pub taskbar_visible: bool,
    pub always_on_top: bool,
    pub movable: bool,
    pub resizable: bool,
    pub icon: Option<ImageId>,
    pub cursor: Option<CursorIcon>,
    pub cursor_image: Option<(ImageId, PxPoint)>,
    pub transparent: bool,
    pub capture_mode: bool,
    pub render_mode: RenderMode,
    pub focus_indicator: Option<FocusIndicator>,
    pub focus: bool,
    pub ime_area: Option<DipRect>,
    pub enabled_buttons: WindowButton,
    pub system_shutdown_warn: Txt,
    pub extensions: Vec<(ApiExtensionId, ApiExtensionPayload)>,
}

Configuration of a new window.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: WindowId

ID that will identify the new window.

title: Txt

Title text.

state: WindowStateAll

Window state, position, size and restore rectangle.

kiosk: bool

Lock-in kiosk mode.

If true the app-process will only set fullscreen states, never hide or minimize the window, never make the window chrome visible and only request an opaque window. The view-process implementer is expected to also never exit the fullscreen state, even temporally.

The app-process does not expect the view-process to configure the operating system to run in kiosk mode, but if possible to detect the view-process can assert that it is running in kiosk mode, logging an error if the assert fails.

default_position: bool

If the initial position should be provided the operating system, if this is not possible the state.restore_rect.origin is used.

video_mode: VideoMode

Video mode used when the window is in exclusive state.

visible: bool

Window visibility.

taskbar_visible: bool

Window taskbar icon visibility.

always_on_top: bool

If the window is “top-most”.

movable: bool

If the user can move the window.

resizable: bool

If the user can resize the window.

icon: Option<ImageId>

Window icon.

cursor: Option<CursorIcon>

Window cursor icon and visibility.

cursor_image: Option<(ImageId, PxPoint)>

Window custom cursor with hotspot.

transparent: bool

If the window is see-through in pixels that are not fully opaque.

capture_mode: bool

If all or most frames will be screen captured.

If false all resources for capturing frame images are discarded after each screenshot request.

render_mode: RenderMode

Render mode preference for this window.

focus_indicator: Option<FocusIndicator>

Focus request indicator on init.

focus: bool

Ensures the window is focused after open, if not set the initial focus is decided by the windows manager, usually focusing the new window only if the process that causes the window has focus.

ime_area: Option<DipRect>

IME cursor area, if IME is enabled.

enabled_buttons: WindowButton

Enabled window chrome buttons.

system_shutdown_warn: Txt

System shutdown warning associated with the window.

extensions: Vec<(ApiExtensionId, ApiExtensionPayload)>

Initial payload for API extensions.

The zng-view crate implements this by calling WindowExtension::configure and RendererExtension::configure with the payload.

Implementations

impl WindowRequest

pub fn new( id: WindowId, title: Txt, state: WindowStateAll, kiosk: bool, default_position: bool, video_mode: VideoMode, visible: bool, taskbar_visible: bool, always_on_top: bool, movable: bool, resizable: bool, icon: Option<ImageId>, cursor: Option<CursorIcon>, cursor_image: Option<(ImageId, PxPoint)>, transparent: bool, capture_mode: bool, render_mode: RenderMode, focus_indicator: Option<FocusIndicator>, focus: bool, ime_area: Option<DipRect>, enabled_buttons: WindowButton, system_shutdown_warn: Txt, extensions: Vec<(ApiExtensionId, ApiExtensionPayload)>, ) -> Self

New request.

pub fn enforce_kiosk(&mut self)

Corrects invalid values if kiosk is true.

An error is logged for each invalid value.

Trait Implementations

impl Clone for WindowRequest

fn clone(&self) -> WindowRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WindowRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WindowRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WindowRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.