Skip to main content

Window

Struct Window 

Source
pub struct Window { /* private fields */ }
Available on crate feature winio only.
Expand description

A simple window.

§Platform specific

  • Qt: The desctruct order of Qt requires the window to be dropped last, and you should better put it at the end of the struct.

Implementations§

Source§

impl Window

Source

pub fn client_size(&self) -> Result<Size2D<f64, LogicalSpace>, Error>

The inner client size.

Source

pub fn set_icon_by_id(&mut self, id: u16) -> Result<(), Error>

Available on Windows only.

Set window icon by resource ID.

Source

pub fn style(&self) -> Result<u32, Error>

Available on win32 only.

Get window style.

Source

pub fn set_style(&mut self, s: u32) -> Result<(), Error>

Available on win32 only.

Set window style.

Source

pub fn ex_style(&self) -> Result<u32, Error>

Available on win32 only.

Get window extended style.

Source

pub fn set_ex_style(&mut self, s: u32) -> Result<(), Error>

Available on win32 only.

Set window extended style.

Source

pub fn backdrop(&self) -> Result<Backdrop, Error>

Available on Windows only.

Get the backdrop effect of the window.

Returns an error if the platform does not support it.

§Platform specific
  • Win32: Supported on Windows 11 22H2 and later; some controls might look weird.
  • WinUI: Supported on 1.3 and later; the color of the title bar might be different from the client area.
Source

pub fn set_backdrop(&mut self, backdrop: Backdrop) -> Result<(), Error>

Available on Windows only.

Set the backdrop effect of the window.

Trait Implementations§

Source§

impl AsContainer for Window

Source§

fn as_container(&self) -> BorrowedContainer<'_>

Get the container handle.
Source§

impl AsWindow for Window

Source§

fn as_window(&self) -> BorrowedWindow<'_>

Get the window handle.
Source§

impl Component for Window

Source§

type Error = Error

The error type.
Source§

type Event = WindowEvent

The output event type to the parent.
Source§

type Init<'a> = ()

Initial parameter type.
Source§

type Message = WindowMessage

The input message type to update.
Source§

async fn init( _init: <Window as Component>::Init<'_>, _sender: &ComponentSender<Window>, ) -> Result<Window, Error>

Create the initial component.
Source§

async fn start(&mut self, sender: &ComponentSender<Window>) -> !

Start the event listening.
Source§

async fn update( &mut self, message: Self::Message, sender: &ComponentSender<Self>, ) -> Result<bool, Self::Error>

Respond to the message. Return true if need render.
Source§

fn render(&mut self, sender: &ComponentSender<Self>) -> Result<(), Self::Error>

Render the widgets.
Source§

async fn update_children(&mut self) -> Result<bool, Self::Error>

Update the children components. Return true if any child needs render.
Source§

fn render_children(&mut self) -> Result<(), Self::Error>

Render the children components. It will be called if any child or self needs render.
Source§

impl Debug for Window

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Failable for Window

Source§

type Error = Error

The error type associated.
Source§

impl Layoutable for Window

Source§

fn loc(&self) -> Result<Point2D<f64, LogicalSpace>, Error>

The left top location.
Source§

fn set_loc(&mut self, p: Point2D<f64, LogicalSpace>) -> Result<(), Error>

Move the location.
Source§

fn size(&self) -> Result<Size2D<f64, LogicalSpace>, Error>

The size.
Source§

fn set_size(&mut self, v: Size2D<f64, LogicalSpace>) -> Result<(), Error>

Resize.
Source§

fn rect(&self) -> Result<Rect<f64, LogicalSpace>, Self::Error>

The bounding rectangle.
Source§

fn set_rect(&mut self, r: Rect<f64, LogicalSpace>) -> Result<(), Self::Error>

Set the location and size.
Source§

fn preferred_size(&self) -> Result<Size2D<f64, LogicalSpace>, Self::Error>

The preferred size.
Source§

fn min_size(&self) -> Result<Size2D<f64, LogicalSpace>, Self::Error>

Min acceptable size.
Source§

impl TextWidget for Window

Source§

fn text(&self) -> Result<String, Error>

Get the text of the widget.
Source§

fn set_text(&mut self, s: impl AsRef<str>) -> Result<(), Error>

Set the text of the widget. Read more
Source§

impl Visible for Window

Source§

fn is_visible(&self) -> Result<bool, Error>

If the widget is visible.
Source§

fn set_visible(&mut self, v: bool) -> Result<(), Error>

Set the visibility.
Source§

fn show(&mut self) -> Result<(), Self::Error>

Show the widget.
Source§

fn hide(&mut self) -> Result<(), Self::Error>

Hide the widget.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<Src, Dest> IntoTuple<Dest> for Src
where Dest: FromTuple<Src>,

Source§

fn into_tuple(self) -> Dest

Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more