Struct crossterm_winapi::Console

pub struct Console { /* private fields */ }

A wrapper around a screen buffer.

Implementations

impl Console

pub fn output() -> Result<Console>

Create new instance of Console.

This created instance will use the default output handle (STD_OUTPUT_HANDLE) as handle for the function call it wraps.

pub fn set_text_attribute(&self, value: u16) -> Result<()>

Sets the attributes of characters written to the console screen buffer by the WriteFile or WriteConsole functions, or echoed by the ReadFile or ReadConsole functions. This function affects text written after the function call.

The attributes is a bitmask of possible character attributes.

This wraps SetConsoleTextAttribute.

pub fn set_console_info( &self, absolute: bool, rect: WindowPositions ) -> Result<()>

Sets the current size and position of a console screen buffer’s window.

This wraps SetConsoleWindowInfo.

pub fn fill_whit_character( &self, start_location: Coord, cells_to_write: u32, filling_char: char ) -> Result<u32>

Writes a character to the console screen buffer a specified number of times, beginning at the specified coordinates. Returns the number of characters that have been written.

This wraps FillConsoleOutputCharacterA.

pub fn fill_whit_attribute( &self, start_location: Coord, cells_to_write: u32, dw_attribute: u16 ) -> Result<u32>

Sets the character attributes for a specified number of character cells, beginning at the specified coordinates in a screen buffer. Returns the number of cells that have been modified.

This wraps FillConsoleOutputAttribute.

pub fn largest_window_size(&self) -> Result<Coord>

Retrieves the size of the largest possible console window, based on the current text and the size of the display.

This wraps GetLargestConsoleWindowSize

pub fn write_char_buffer(&self, buf: &[u8]) -> Result<usize>

Writes a character string to a console screen buffer beginning at the current cursor location.

This wraps WriteConsoleW.

pub fn read_single_input_event(&self) -> Result<InputRecord>

Read one input event.

This wraps ReadConsoleInputW.

pub fn read_console_input(&self) -> Result<Vec<InputRecord>>

Read all available input events without blocking.

This wraps ReadConsoleInputW.

pub fn number_of_console_input_events(&self) -> Result<u32>

Get the number of available input events that can be read without blocking.

This wraps GetNumberOfConsoleInputEvents.

Trait Implementations

impl Clone for Console

fn clone(&self) -> Console

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Console

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

Formats the value using the given formatter.

impl From<Handle> for Console

fn from(handle: Handle) -> Self

Create a Console instance who’s functions will be executed on the the given Handle