Struct Area 

pub struct Area { /* private fields */ }

A type erased RawUi::Area

This struct is accessed by calling RwArea::read or RwData::write.

Implementations

impl Area

pub fn set_width(&mut self, width: f32) -> Result<(), Text>

Sets the width of the RawArea

pub fn set_height(&mut self, height: f32) -> Result<(), Text>

Sets the height of the RawArea

pub fn hide(&mut self) -> Result<(), Text>

Hides the RawArea

pub fn reveal(&mut self) -> Result<(), Text>

Reveals the RawArea

pub fn set_as_active(&mut self)

Tells the RawUi that this RawArea is the one that is currently focused.

Should make self the active RawArea while deactivating any other active RawArea.

pub fn width_of_text(&self, opts: PrintOpts, text: &Text) -> Result<f32, Text>

What width the given Text would occupy, if unwrapped

pub fn print(&self, text: &Text, opts: PrintOpts, painter: Painter)

Prints the Text via an Iterator

pub fn print_with<'a>( &self, text: &Text, opts: PrintOpts, painter: Painter, f: impl FnMut(&Caret, &Item) + 'a, )

Prints the Text with a callback function

pub fn get_print_info(&self) -> PrintInfo

The current printing information of the area

pub fn set_print_info(&mut self, info: PrintInfo)

Sets a previously acquired PrintInfo to the area

pub fn print_iter<'a>( &self, text: &'a Text, points: TwoPoints, opts: PrintOpts, ) -> Box<dyn Iterator<Item = (Caret, Item)> + 'a>

Returns a printing iterator

Given an iterator of text::Items, returns an iterator which assigns to each of them a Caret. This struct essentially represents where horizontally would this character be printed.

If you want a reverse iterator, see Area::rev_print_iter.

pub fn rev_print_iter<'a>( &self, text: &'a Text, points: TwoPoints, opts: PrintOpts, ) -> Box<dyn Iterator<Item = (Caret, Item)> + 'a>

Returns a reversed printing iterator

Given an iterator of text::Items, returns a reversed iterator which assigns to each of them a Caret. This struct essentially represents where horizontally each character would be printed.

If you want a forwards iterator, see Area::print_iter.

pub fn scroll_ver(&mut self, text: &Text, dist: i32, opts: PrintOpts)

Scrolls the Text veritcally by an amount

If scroll_beyond is set, then the Text will be allowed to scroll beyond the last line, up until reaching the scrolloff.y value.

pub fn scroll_around_points( &mut self, text: &Text, points: TwoPoints, opts: PrintOpts, )

Scrolls the Text on all four directions until the given TwoPoints is within the ScrollOff range

There are two other scrolling methods for Area: scroll_ver and scroll_to_points. The difference between this and scroll_to_points is that this method doesn’t do anything if the TwoPoints is already on screen.

pub fn scroll_to_points( &mut self, text: &Text, points: TwoPoints, opts: PrintOpts, )

Scrolls the Text to the visual line of a TwoPoints

This method takes line wrapping into account, so it’s not the same as setting the starting points to the Text::visual_line_start of these TwoPoints.

If scroll_beyond is set, then the Text will be allowed to scroll beyond the last line, up until reaching the scrolloff.y value.

pub fn start_points(&self, text: &Text, opts: PrintOpts) -> TwoPoints

Scrolls the Area to the given TwoPoints

pub fn end_points(&self, text: &Text, opts: PrintOpts) -> TwoPoints

Scrolls the Area to the given TwoPoints

pub fn has_changed(&self) -> bool

Wether this Area has changed since last being printed

pub fn is_master_of(&self, other: &Self) -> bool

Whether or not this Area is the “master” of another

pub fn store_cache(&mut self, path: &str) -> Result<(), Text>

Stores the cache of the Area, given a path to associate with this cache

pub fn top_left(&self) -> Coord

The top left Coord of this Area

pub fn bottom_right(&self) -> Coord

The bottom right Coord of this Area

pub fn width(&self) -> f32

Gets the width of the area

pub fn height(&self) -> f32

Gets the height of the area

pub fn coord_at_points( &self, text: &Text, points: TwoPoints, opts: PrintOpts, ) -> Option<Coord>

The Coord where the given TwoPoints would be printed

Returns None if the TwoPoints are not part of the Text

pub fn points_at_coord( &self, text: &Text, coord: Coord, opts: PrintOpts, ) -> Option<TwoPointsPlace>

The TwoPoints where a Coord is found

Returns None if either the RawArea does not contain the given Coord, or if the Coord is in a position where Text is not printed.

pub fn is_active(&self) -> bool

Returns true if this is the currently active Area

Only one Area should be active at any given moment.

pub fn area_is_eq(&self, other: &Area) -> bool

Wether this Area is the same as another