ViewBuffer

Struct ViewBuffer 

Source
pub struct ViewBuffer<'a> { /* private fields */ }
Expand description

Render to the temp buffer.

  • It maps your widget area from layout coordinates to screen coordinates before rendering.
  • It helps with cleanup of the widget state if your widget is currently invisible.

Implementations§

Source§

impl<'a> ViewBuffer<'a>

Source

pub fn render_widget<W>(&mut self, widget: W, area: Rect) -> bool
where W: Widget,

Render a widget to the temp buffer.

Source

pub fn render<W, S>(&mut self, widget: W, area: Rect, state: &mut S) -> bool
where W: StatefulWidget<State = S>, S: RelocatableState,

Render a widget to the temp buffer. This expects that the state is a RelocatableState.

Source

pub fn render_popup<W, S>( &mut self, widget: W, area: Rect, state: &mut S, ) -> bool
where W: StatefulWidget<State = S>, S: RelocatableState,

Render an additional popup widget for the given main widget.

Doesn’t call relocate().

Source

pub fn layout(&self) -> Rect

Return the buffer layout.

Source

pub fn is_visible_area(&self, area: Rect) -> bool

Is this area inside the buffer area.

Source

pub fn shift(&self) -> (i16, i16)

👎Deprecated since 2.0.0: should not be public. use relocate2() instead.

Calculate the necessary shift from view to screen.

Source

pub fn locate_area(&self, area: Rect) -> Rect

👎Deprecated since 2.0.0: wrong api, use is_visible_area() or locate_area2()

Does nothing for view. Only exists to match Clipper.

Source

pub fn locate_area2(&self, area: Rect) -> Option<Rect>

Validates that this area is inside the buffer area.

Source

pub fn relocate<S>(&self, state: &mut S)

👎Deprecated since 2.0.0: wrong api, use relocate2() instead

After rendering the widget to the buffer it may have stored areas in its state. These will be in buffer coordinates instead of screen coordinates.

Call this function to correct this after rendering.

Source

pub fn relocate2<S>(&self, area: Rect, state: &mut S)

After rendering the widget to the buffer it may have stored areas in its state. These will be in buffer coordinates instead of screen coordinates.

Call this function to correct this after rendering.

Source

pub fn hidden<S>(&self, state: &mut S)

👎Deprecated since 2.0.0: bad api, use relocate2() instead

If a widget is not rendered because it is out of the buffer area, it may still have left over areas in its state.

This uses relocate_hidden to zero them out.

Source

pub fn buffer(&mut self) -> &mut Buffer

Access the temporary buffer.

Note Use of render_widget is preferred.

Source

pub fn into_widget(self) -> ViewWidget<'a>

👎Deprecated since 2.3.0: use finish() instead

Rendering the content is finished.

Convert to the output widget that can be rendered in the target area.

Source

pub fn finish(self, tgt_buf: &mut Buffer, state: &mut ViewState)

Render the buffer.

Trait Implementations§

Source§

impl<'a> Debug for ViewBuffer<'a>

Source§

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

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

impl<'a> Drop for ViewBuffer<'a>

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more

Auto Trait Implementations§

§

impl<'a> Freeze for ViewBuffer<'a>

§

impl<'a> RefUnwindSafe for ViewBuffer<'a>

§

impl<'a> Send for ViewBuffer<'a>

§

impl<'a> Sync for ViewBuffer<'a>

§

impl<'a> Unpin for ViewBuffer<'a>

§

impl<'a> UnwindSafe for ViewBuffer<'a>

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