This is a single line textbox or input box allowing you to enter and edit text. Based on the Lobject class. Here are the attributes that are created specifically for the textbox object:

• :display_char - This is only supported by the textbox object. When set,

   this character is displayed instead of the characters typed in.  This is
   useful for password prompts.
  

• :auto_select - When true entering an object this attribute will automatically select (highlight) the text in the textbox. Use false to disable the auto-select feature. The default is true (:auto_select is enabled) for Ltextbox, Lcombobox, and Ldatebox objects and false for the Leditbox object. Not supported for other classes.
• :max_size - The maximum number of characters you can type into a combobox, textbox, password, or editbox object. Use this to limit the number of characters that should be entered into the object. An error is raised when the number of characters typed into the object exceeds this value.
• :insert_mode - true or false and determines whether typing inserts or replaces characters.
• :only_digits - when true, only digits can be inserted into the textbox.

This class supports highlighting text using the keyboard or mouse and copying text to and from the clipboard.

Supports the :text, :display_char, :max_size, :auto_select, :insert_mode attributes.

Returns :sys_textbox_bg.

Returns :ibeam.

Returns :sunken.

Textbox and editbox objects don’t inherit the background color from the parent object.

Returns False because the textbox does not inherit color from it’s parent.

Returns true because the textbox does not pull attributes from the :object attribute of any style.

Set up several instance variables and create a timer for blinking the cursor.

Clears the selection or highlight and resets the cursor position. Raises LocanaDigitRequired when :allow_digits is true and new_text is not a Fixnum.

Retruns the text from the textbox. If :display_char is set, the :display_char is returned in place of the true value. When :display_char is set use self[:value] instead of self.value To get the real value.

Return the current state of insert_mode. The default is true.

Sets the insert mode on or off.

• new_value - true to turn insert mode on or false/nil to turn it off.

Returns the character to display in place of the actual characters. Lpassword uses this to mask the actual characters. The default is nil.

This sets the character used to display in place of the actual characters. Lpassword automatically set this to ’*’ to mask the actual characters.

Returns the only_digits attribute.

Sets the only_digits attribute. When new_value = true, only digits can be entered into the textbox.

Return true if :auto_select is on and nil or false if :auto_select is off. The default is true.

Set the :auto_select attribute.

• new_value - true turns on auto_select mode, false turns off auto_select mode, nil returns back to the default setting.

Returns the :max_size attribute. The default is nil which means there is no max size.

Sets the :max_size attribute.

• new_value - an integer specifying the maximum number of characters the textbox will accept,

Selects or highlights the text between start_index and end_index. Use (0, -1) to select all text. Use (0, 0) to clear the selection.

• start_index - the index or position to start highlighting.
• end_index - the index or position to end highlighting, use -1 to highlight to the end.

Returns the index of the character closest to lx.

• lx - the screen relative mouse position from levent[:x].

Returns the index of the character in :value where the cursor is positioned at.

Relocates the cursor and makes sure it is always visible.

• new_value - the index of the new cursor position.

Returns the index of the first visible character. The textbox will scroll horizontally when you type in more characters that you can see. Returns 0 if all characters are visible.

Sets the index of the first visible character. The textbox will scroll horizontally when you type in more characters than you can see.

• new_value - the index of the first visible character.

Sets the new cursor_position, sets self.value = levent[:value], and clears any highlighted text. The Lcombobox object relies on all of this the being set up properly.

Un-select or de-highlights any text.

Inserts the content of the clipboard into the textbox at the current cursor_position.

• levent[:value] contains the text that will be pasted into the textbox.

Cuts the highlighted text from the textbox and places it in the clipboard.

• levent[:value] contains the highlighted portion of the text to be cut out of the textbox.

Copies the highlighted text from the textbox to the clipboard.

• levent[:value] contains the highlighted portion of the text.

Eliminates any highlighted text and the character before the cursor.

If there is any highlighted or selected text, it is removed from the textbox. Otherwise the character after the cursor is deleted.

Toggles insert mode on/off.

Inserts the pressed character into the textbox and triggers the on_change event. Raises LocanaDigitRequired when :allow_digits is true and you attempt to type a non digit character in the text box.

Moves the cursor to the first character in the textbox.

Moves the cursor to the last character in the textbox.

Called whenever the user presses a ctrl-right_key to move to the next word. Holding the shift key will highlight the next word.

Called whenever the user does a ctrl-left_key to move to the previous word. Holding the shift key will highlight the previous word.

Moves the cursor one character to the left. Holding the ctrl key will forward this to on_prev_word. Holding the shift key will highlight the previous character.

Moves the cursor one character to the right. Holding the ctrl key will forward this to on_next_word. Holding the shift key will highlight the next character.

Moves the keyboard focus to the next object (calls on_next_object).

Repositions the cursor and clears any highlight. This also prepares for dragging the highlight as the mouse is moved.

Clears any preparations for dragging the highlight as the mouse is moved.

Drags or expands the highlight when left mouse button is pressed.

Paints the text in the textbox and takes into consideration any highlighted or selected text.

Returns true if the character at idx is highlighted. Otherwise returns false.

This draws the cursor (focus indicator), removes the cursor, and causes the cursor to blink. Ltextbox::CURSOR_BLINK_TIME determines the rate of blinking.

This adds anything needed to the object to show that it has the focus. This calls cursor_blinking() to draw the cursor, remove the cursor, and blink the cursor.

This should undo or remove the focus painted by paint_focus. This calls cursor_blinking() to draw the cursor, remove the cursor, and blink the cursor.

Returns the pixel width of the text in the object. This should take into consideration the font, size, and style of the object and it’s parents. This is used to calculate width of the object when needed.

Returns the pixel height of the text in the object. This should take into consideration the font, size, and style of the object and it’s parents. This is used to calculate height of the object when needed.

The default is 3 so the text does not hug the left and right border.

The default is 1 so the text does not hug the top and bottom border.