Struct WindowHandle 

pub struct WindowHandle { /* private fields */ }

A thread-safe reference to a generational Incular window. Methods only enqueue data for the UI/event-loop turn; they never touch native state.

Implementations

impl WindowHandle

pub const fn id(&self) -> WindowId

pub fn capabilities(&self) -> PlatformCapabilities

pub fn file_dialogs(&self) -> FileDialogService

Native file/folder dialog service associated with this window. The service retains only the Incular window identity; native parent handles remain inside the desktop adapter.

pub fn observed_state(&self) -> WindowObservedState

pub fn transient_presentations(&self) -> Vec<TransientPresentationResolution>

Resolved native-vs-overlay presentation for visible retained transients in this window. The native adapter updates this after host negotiation; an empty list means no visible semantic transient is currently present.

pub fn displays(&self) -> Vec<DisplaySnapshot>

Immutable snapshots for displays currently published by the native backend. Removed displays disappear immediately; a later display using the same registry slot carries a different generation.

pub fn display(&self, id: DisplayId) -> Option<DisplaySnapshot>

pub fn primary_display(&self) -> Option<DisplaySnapshot>

pub fn current_display(&self) -> Option<DisplaySnapshot>

pub fn set_title( &self, title: impl Into<String>, ) -> Result<(), WindowCommandEnqueueError>

pub fn set_visible( &self, visible: bool, ) -> Result<(), WindowCommandEnqueueError>

pub fn request_logical_size( &self, size: Size, ) -> Result<(), WindowCommandEnqueueError>

pub fn set_outer_position( &self, position: PhysicalScreenPosition, ) -> Result<(), WindowCommandEnqueueError>

pub fn center_on_display( &self, display: &DisplaySnapshot, area: DisplayPlacementArea, ) -> Result<PhysicalScreenPosition, WindowPlacementError>

Centers this window using already-observed native outer size and one immutable display snapshot. Work-area centering never falls back to full monitor bounds: callers must choose that policy explicitly.

pub fn move_relative_to_display( &self, display: &DisplaySnapshot, position: PhysicalDisplayPosition, ) -> Result<PhysicalScreenPosition, WindowPlacementError>

Moves the window to a physical point relative to one known display. This is intentionally unavailable when the display snapshot has no desktop-global origin (for example a Wayland top-level display).

pub fn begin_move_drag( &self, ) -> Result<NativeOperationRequest, WindowCommandEnqueueError>

Begins a compositor/window-manager-owned interactive move. The native backend may require this call to follow a real primary-button press.

pub fn begin_resize_drag( &self, direction: WindowResizeDirection, ) -> Result<NativeOperationRequest, WindowCommandEnqueueError>

Begins a compositor/window-manager-owned interactive resize from one edge/corner. Incular never emulates this by changing global coordinates.

pub fn set_minimized( &self, minimized: bool, ) -> Result<(), WindowCommandEnqueueError>

pub fn set_maximized( &self, maximized: bool, ) -> Result<(), WindowCommandEnqueueError>

pub fn set_fullscreen( &self, fullscreen: Option<Fullscreen>, ) -> Result<(), WindowCommandEnqueueError>

pub fn set_resizable( &self, resizable: bool, ) -> Result<(), WindowCommandEnqueueError>

pub fn set_decorations( &self, decorations: bool, ) -> Result<(), WindowCommandEnqueueError>

pub fn set_logical_size_limits( &self, limits: LogicalSizeLimits, ) -> Result<(), WindowCommandEnqueueError>

pub fn set_window_level( &self, level: WindowLevel, ) -> Result<(), WindowCommandEnqueueError>

pub fn set_window_icon( &self, icon: Option<WindowIcon>, ) -> Result<(), WindowCommandEnqueueError>

pub fn request_user_attention( &self, attention: UserAttentionType, ) -> Result<(), WindowCommandEnqueueError>

pub fn cancel_user_attention(&self) -> Result<(), WindowCommandEnqueueError>

pub fn set_cursor_grab( &self, mode: CursorGrabMode, ) -> Result<NativeOperationRequest, WindowCommandEnqueueError>

Requests native cursor confinement/locking. The returned request completes with a typed platform result; the runtime does not claim a grab succeeded merely because the command was enqueued.

pub fn set_cursor_visible( &self, visible: bool, ) -> Result<NativeOperationRequest, WindowCommandEnqueueError>

Shows or hides the native cursor for this window.

pub fn set_cursor_position( &self, position: LogicalWindowPosition, ) -> Result<NativeOperationRequest, WindowCommandEnqueueError>

Warps the native cursor to a validated logical client-area position.

pub fn set_content_sensitivity( &self, sensitivity: ContentSensitivity, ) -> Result<NativeOperationRequest, WindowCommandEnqueueError>

Requests the window’s normalized content-capture policy. The command is applied by the native adapter on its event-loop thread. Unsupported adapters resolve the returned request with a typed platform error.

pub fn request_focus(&self) -> Result<(), WindowCommandEnqueueError>

pub fn request_redraw(&self) -> Result<(), WindowCommandEnqueueError>

pub fn close(&self) -> Result<(), WindowCommandEnqueueError>

Trait Implementations

impl Clone for WindowHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WindowHandle

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

Formats the value using the given formatter.