Struct InputTextMultiline

pub struct InputTextMultiline<'ui, 'p, L, T = PassthroughCallback> { /* private fields */ }

Implementations

impl<'ui, 'p, L> InputTextMultiline<'ui, 'p, L>

where L: AsRef<str>,

pub fn new( ui: &'ui Ui, label: L, buf: &'p mut String, size: impl Into<Vector2<f32>>, ) -> InputTextMultiline<'ui, 'p, L>

Creates a new input text widget to edit the given string.

String Editing

Please note, ImGui requires this string to be null-terminated. We accomplish this by appending and then removing a null terminator (\0) from the String you pass in. This has several consequences:

1. The string’s backing buffer may be resized and relocated even without edits as result of this pushed char.
2. The string will appear truncated if the string contains \0 inside it. This will not cause memory unsafety, but it will limit your usage. If that’s the case, please pre-process your string.
3. Truncations by ImGui appear to be done primarily by insertions of \0 to the truncation point. We will handle this for you and edit the string “properly” too, but this might show up in callbacks.

impl<'ui, 'p, T, L> InputTextMultiline<'ui, 'p, L, T>

where T: InputTextCallbackHandler, L: AsRef<str>,

pub fn flags(self, flags: InputTextFlags) -> InputTextMultiline<'ui, 'p, L, T>

pub fn chars_decimal(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn chars_hexadecimal(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn chars_uppercase(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn chars_noblank(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn auto_select_all(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn enter_returns_true( self, value: bool, ) -> InputTextMultiline<'ui, 'p, L, T>

pub fn allow_tab_input(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn no_horizontal_scroll( self, value: bool, ) -> InputTextMultiline<'ui, 'p, L, T>

pub fn always_insert_mode( self, value: bool, ) -> InputTextMultiline<'ui, 'p, L, T>

Note: this is equivalent to always_overwrite

pub fn always_overwrite(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn read_only(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn password(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn no_undo_redo(self, value: bool) -> InputTextMultiline<'ui, 'p, L, T>

pub fn callback<T2>( self, callbacks: InputTextMultilineCallback, callback_handler: T2, ) -> InputTextMultiline<'ui, 'p, L, T2>

where T2: InputTextCallbackHandler,

pub fn build(self) -> bool

Builds the string editor, performing string editing operations.

String Editing

Please note, ImGui requires this string to be null-terminated. We accomplish this by appending and then removing a null terminator (\0) from the String you pass in. This has several consequences:

1. The string’s backing buffer may be resized and relocated even without edits as result of this pushed char.
2. The string will appear truncated if the string contains \0 inside it. This will not cause memory unsafety, but it will limit your usage. If that’s the case, please pre-process your string.
3. Truncations by ImGui appear to be done primarily by insertions of \0 to the truncation point. We will handle this for you and edit the string “properly” too, but this might show up in callbacks.