JugiMap Framework
GuiTextInput Class Reference

The GuiTextField class provides a widget for text input. More...

#include <jmGuiTextWidgets.h>

Inherits GuiWidget.

Public Member Functions

 GuiTextInput (ComposedSprite *_rootSprite)
 Construct a new gui text input from the given *_rootSprite*. More...
 
void SetDisabled (bool _disabled) override
 Set the disabled state of this widget. More...
 
void SetVisible (bool _visible) override
 Set the visibility of this widget. More...
 
void Start ()
 Start the text editing. More...
 
void Start (const std::string &_text)
 Set the text and start editing. More...
 
void SetText (const std::string &_text)
 Set the text. More...
 
std::string GetText ()
 Returns the text. More...
 
void SetTextMaximumLength (int _maxLength)
 Set the maximum number of characters of the text. More...
 
void SetAllowEscToAbort (bool _allowEscToAbort)
 Set if the escape key aborts editing. More...
 
void SetAllowEmptyText (bool _allowEmptyText)
 Set if empty text is allowed. More...
 
void SetBannedChars (const std::string &_bannedChars)
 Set a string of characters which can not appear in the text. More...
 
void MakeCharsFileNameSafe ()
 Set a string of banned characters in file name. More...
 
void SetCursorFlashingSpeed (int _cursorFlashingMS)
 Set the flashing interval of the text cursor in milliseconds. More...
 
- Public Member Functions inherited from GuiWidget
bool IsCursorDown ()
 Returns true if the cursor is hold down over this widget; otherwise returns false. More...
 
bool IsCursorOver ()
 Returns true if the cursor is over this widget; otherwise returns false. More...
 
bool IsPressed ()
 Returns true if the cursor is pressed while over this widget; otherwise returns false. More...
 
bool IsValueChanged ()
 Returns true if this widget's value is changed; otherwise returns false. More...
 
bool IsDisabled ()
 Returns true if this widget is disabled; otherwise returns false. More...
 
bool IsVisible ()
 Returns true if this widget is visible; otherwise returns false. More...
 
void SetName (const std::string &_name)
 Set the name of this widget. More...
 
std::string GetName ()
 Returns the name of this widget. More...
 
void SetTag (int _tag)
 Set the tag of this widget. More...
 
int GetTag ()
 Returns the tag of this widget. More...
 
GuiWidgetKind GetKind ()
 Returns the kind of this widget. More...
 
std::string GetDesignKind ()
 Returns the design kind of this widget. More...
 
void AssignCustomObject (CustomObject *_customObject)
 Assign the given *_customObject* to this widget. More...
 
CustomObjectGetCustomObject ()
 Returns the custom object of this widget or nullptr if none. More...
 
void AssignCallback (GuiWidgetCallback *_callback)
 Assign the given *_callback* to this widget. More...
 
GuiWidgetCallbackGetCallback ()
 Returns the callback of this widget or nullptr if none. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from GuiWidget
static GuiWidgetGetInteracted ()
 Returns the interacted widget. More...
 
static GuiWidgetGetInteracted (const std::string &_name)
 Returns the interacted widget with the given *_name*. More...
 
static GuiWidgetGetInteracted (int _tag)
 Returns the interacted widget with the given *_tag*. More...
 
static GuiWidgetGetInteracted (CustomObject *_customObject)
 Returns the interacted widget which has assigned the given *_customObject*. More...
 
static GuiWidgetGetInteracted_Pressed ()
 Returns the interacted widget which is pressed. More...
 
static GuiWidgetGetInteracted_Pressed (const std::string &_name)
 Returns the interacted widget with the given *_name* which is pressed. More...
 
static GuiWidgetGetInteracted_Pressed (int _tag)
 Returns the interacted widget with the given *_tag* which is pressed. More...
 
static GuiWidgetGetInteracted_Pressed (CustomObject *_customObject)
 Returns the interacted widget with assigned *_customObject* which is pressed. More...
 
static GuiWidgetGetInteracted_ValueChanged ()
 Returns the interacted widget which has changed value. More...
 
static GuiWidgetGetInteracted_ValueChanged (const std::string &_name)
 Returns the interacted widget with the given *_name* which has changed value. More...
 
static GuiWidgetGetInteracted_ValueChanged (int _tag)
 Returns the interacted widget with the given *_tag* which has changed value. More...
 
static GuiWidgetGetInteracted_ValueChanged (CustomObject *_customObject)
 Returns the interacted widget with assigned *_customObject* which has changed value. More...
 
static GuiWidgetGetInteracted_CursorOver ()
 Returns the interacted widget which has the cursor over. More...
 
static GuiWidgetGetInteracted_CursorOver (const std::string &_name)
 Returns the interacted widget with the given *_name* which has the cursor over. More...
 
static GuiWidgetGetInteracted_CursorOver (int _tag)
 Returns the interacted widget with the given *_tag* which has the cursor over. More...
 
static GuiWidgetGetInteracted_CursorOver (CustomObject *_customObject)
 Returns the interacted widget with assigned *_customObject* which has the cursor over. More...
 
static GuiWidgetGetInteracted_cursorDown ()
 Returns the interacted widget which has the cursor hold down. More...
 
static GuiWidgetGetInteracted_CursorDown (const std::string &_name)
 Returns the interacted widget with the given *_name* which has the cursor hold down. More...
 
static GuiWidgetGetInteracted_CursorDown (int _tag)
 Returns the interacted widget with the given *_tag* which has the cursor hold down. More...
 
static GuiWidgetGetInteracted_CursorDown (CustomObject *_customObject)
 Returns the interacted widget with assigned *_customObject* which has the cursor hold down. More...
 

Detailed Description

The GuiTextField class provides a widget for text input.

The text editing is started with GuiTextInput::Start and completed by pressing the Enter key. This widget currently works only with the ASCII character set.

Constructor & Destructor Documentation

◆ GuiTextInput()

GuiTextInput ( ComposedSprite _rootSprite)

Construct a new gui text input from the given *_rootSprite*.

Member Function Documentation

◆ SetDisabled()

void SetDisabled ( bool  _disabled)
overridevirtual

Set the disabled state of this widget.

See also
IsDisabled

Reimplemented from GuiWidget.

◆ SetVisible()

void SetVisible ( bool  _visible)
overridevirtual

Set the visibility of this widget.

This function is not available for GuiTextField.

See also
IsVisible

Reimplemented from GuiWidget.

◆ Start() [1/2]

void Start ( )

Start the text editing.

◆ Start() [2/2]

void Start ( const std::string &  _text)

Set the text and start editing.

◆ SetText()

void SetText ( const std::string &  _text)

Set the text.

◆ GetText()

std::string GetText ( )
inline

Returns the text.

◆ SetTextMaximumLength()

void SetTextMaximumLength ( int  _maxLength)
inline

Set the maximum number of characters of the text.

◆ SetAllowEscToAbort()

void SetAllowEscToAbort ( bool  _allowEscToAbort)
inline

Set if the escape key aborts editing.

◆ SetAllowEmptyText()

void SetAllowEmptyText ( bool  _allowEmptyText)
inline

Set if empty text is allowed.

◆ SetBannedChars()

void SetBannedChars ( const std::string &  _bannedChars)
inline

Set a string of characters which can not appear in the text.

◆ MakeCharsFileNameSafe()

void MakeCharsFileNameSafe ( )

Set a string of banned characters in file name.

◆ SetCursorFlashingSpeed()

void SetCursorFlashingSpeed ( int  _cursorFlashingMS)

Set the flashing interval of the text cursor in milliseconds.


The documentation for this class was generated from the following files: