Struct zng_view_api::window::WindowRequest

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>,
    pub transparent: bool,
    pub capture_mode: bool,
    pub render_mode: RenderMode,
    pub focus_indicator: Option<FocusIndicator>,
    pub focus: bool,
    pub extensions: Vec<(ApiExtensionId, ApiExtensionPayload)>,
    pub access_root: AccessNodeId,
    pub ime_area: Option<DipRect>,
}

Configuration of a new window.

Fields

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>

Window custom cursor.

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.

extensions: Vec<(ApiExtensionId, ApiExtensionPayload)>

Initial payload for API extensions.

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

access_root: AccessNodeId

Initial accessibility info tree root widget.

This is used to declare a placeholder node on the first request for accessibility info, the Event::AccessInit event is send to the window if any accessibility service requests the tree, the window must send the full info at that moment, after the init the window should assume that accessibility info is required for the lifetime of the window and updates must be send.

ime_area: Option<DipRect>

IME cursor area, if IME is enabled.

Implementations

impl WindowRequest

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 copy 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.