Struct newt::widgets::Entry

pub struct Entry { /* fields omitted */ }

A field for reading text input from the user.

An EntryFilter can be use to filter characters as the user enters them into the Entry.

Example

extern crate newt;
use newt::callbacks::EntryFilter;
use newt::prelude::*;

pub fn main() {
    newt::init().unwrap();
    newt::cls();
    newt::centered_window(22, 5, None).unwrap();

    // last character entered
    let mut g_ch: char = '\0';
    // last cursor position
    let mut g_cursor: i32 = 0;
    // user data from last Entry modified
    let mut g_data: i32 = 0;

    // Create closure to be used to filter the Entry field.
    let mut f = |_e: &Entry, data: Option<&i32>, ch: char, cursor: i32| {
        g_data = *data.unwrap(); // set user data
        g_ch = ch;               // set character entered
        g_cursor = cursor;       // set cursor position

        // The returned character gets added to the entry.
        // If for example you want to fill an entry with asterisks despite
        // what the user entered, then return '*' here.
        return ch; // Return the entered character.
    };

    let l1 = Label::new(1, 1, "Entry 1:");
    let l2 = Label::new(1, 2, "Entry 2:");
    let e1 = Entry::new(10, 1, None, 10, 0);
    let e2 = Entry::new(10, 2, None, 10, 0);
    let ok = CompactButton::new(7, 4, "Ok");
    let components: &[&dyn Component] = &[&l1, &l2, &e1, &e2, &ok];

    let mut form = Form::new(None, 0);
    form.add_components(components).unwrap();

    // Filter the first Entry, passing user data `5`.
    let mut filter = EntryFilter::new(&e1, &mut f, Some(5));
    // Filter the second Entry, passing user data `10`.
    filter.add_entry(&e2, Some(10));

    form.run().unwrap();
    newt::finished();

    println!("Entry 1: {}", e1.get_text());
    println!("Entry 2: {}", e2.get_text());

    // Display the last values set by the filter.
    println!("ch = {}", g_ch);
    println!("cursor = {}", g_cursor);
    println!("data = {}", g_data);
}

Implementations

impl Entry

pub fn new(
    left: i32,
    top: i32,
    initial_value: Option<&str>,
    width: i32,
    flags: i32
) -> Entry

pub fn get_text(&self) -> String

pub fn set_text(&self, text: &str, cursor_at_end: bool)

pub fn set_flags(&self, flags: i32, sense: FlagsSense)

pub fn set_colors(&self, normal: i32, disabled: i32)

pub fn get_cursor_position(&self) -> i32

pub fn set_cursor_position(&self, position: i32)

Trait Implementations

impl Component for Entry

fn co(&self) -> newtComponent

Return newtComponent pointer.

impl Drop for Entry

fn drop(&mut self)

Executes the destructor for this type.

impl PartialEq<Box<dyn Component + 'static>> for Entry

fn eq(&self, other: &Box<dyn Component>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<ExitReason> for Entry

fn eq(&self, other: &ExitReason) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<Rhs: Component> PartialEq<Rhs> for Entry

fn eq(&self, other: &Rhs) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl WidgetFns for Entry

fn takes_focus(&self, value: bool)

Allow the Widget to be focused when its parent [Form][form] is run.

fn get_position(&self) -> (i32, i32)

Get the position of the Widget's top left corner.

fn get_size(&self) -> (i32, i32)

Get the Widget's width and height.