Textbox Control for us in the vxGUI System. More...

Inheritance diagram for VerticesEngine.UI.Controls.vxTextbox:

Public Member Functions
virtual SpriteFont	GetDefaultFont ()
	Gets the default font.

	vxTextbox (string text, Vector2 position, string TextboxTitle="Title", string TextboxDescription="Description")
	Initializes a new instance of the T:VerticesEngine.UI.Controls.vxTextbox class.

	vxTextbox (string text, Vector2 position, string TextboxTitle, string TextboxDescription, int width)
	Initializes a new instance of the T:VerticesEngine.UI.Controls.vxTextbox class.

override void	Select ()
	When the GUIItem is Selected.

override void	NotHover ()
	When the Mouse is NOT over the GUIItem.

void	ShowInputDialog (string title, string text, string initialText, Action< string > callback)

override void	Draw ()
	Draws the GUI Item.

override void	OnLayoutInvalidated ()
	This is called whenever the layout is changed, content changed, or any method has been called which requires the control to be re-layedout.

override void	OnTextChanged ()
	Fired whenerer the text changed (or a key is pressed).

void	ProcessKeyInputs (float dt)
	Hand keyboard input.

Public Member Functions inherited from VerticesEngine.UI.vxUIControl
virtual Type	GetBaseGuiType ()
	A string that is set in the base class of many items.

int	GetScaledSize (float i)
	Scales an Integer by the Screen Scaler Size. This is used to keep GUI and Item Sizes consistent across different Screen Sizes and Resolutions.

virtual void	OnLocalizationChanged ()

void	SetLocalisedText (string key, string postface="")

virtual string	FilterTextInput (string input)

virtual void	OnFontSet ()

virtual void	OnShadowStatusChange ()
	Called when ever the DoShadow Property is changed. Override to change values for child elements.

virtual void	OnItemPositionChange ()

virtual void	ResetLayout ()

	vxUIControl ()
	Initializes a new instance of the VerticesEngine.UI.vxUIControl class.

	vxUIControl (Vector2 position)
	Initializes a new instance of the VerticesEngine.UI.vxUIControl class.

void	Dispose ()
	Call this to dispose the UI control. This should only be called by the vxUIManager or the vxCanvas

virtual void	Hover ()
	When the Mouse is over the GUIItem.

virtual void	OnGUIManagerAdded (vxUIManager UIManager)

virtual void	PlaySound (SoundEffect SoundEffect, float Volume=1, float Pitch=0)
	Plays the speciefied Sound Effect. Note this is to encapsulate the Sound Playing in one place around a try-catch block. Although this is not the ideal way of doing it, it allows for better cross-platform support since different platforms, namely mobile, have different maximums of letting sound effects play at the same time.

void	UpdateUI ()

Color	GetStateColour (vxColourTheme theme)

virtual void	DrawText ()
	Draws the GUI Items text. This is kept seperate for effiecency when using Sprite Sheets.

void	SetToolTip (string ToolTipText)

virtual void	DrawToolTip ()
	If Possible, will draw the Tool Tip.

virtual void	DrawBorder ()

Vector2	GetCenteredTextPosition (SpriteFont font, string text)
	Gets the centered text position.

void	DrawDebugPoint (Vector2 Pos)
	Draws the debug point.

void	DrawDebugPoint (Vector2 Pos, Color color)
	Draws the debug point.

bool	TryConvertKeyboardInput (KeyboardState keyboard, KeyboardState oldKeyboard, out char key)
	Tries to convert keyboard input to characters and prevents repeatedly returning the same character if a key was pressed last frame, but not yet unpressed this frame.

Public Attributes
vxTextboxArtProvider	artProvider
	Gets or sets the art provider.

float	CaretAlpha = 0
	Caret Alpha.

Vector2	CaretPosition
	The Cursor Position.

int	CaretIndex = 0
	The Index the cursor is in in the string.

string	TextboxTitle = ""

string	TextboxDescription = ""

bool	IsBackgroundTransparent = false

string[]	Lines
	The lines of text.

int	CurrentLineIndex = 0
	The index of the current line.

Vector2	TextPositionOffset = new Vector2()
	The text position offset.

bool	IsMultiLine = false

Public Attributes inherited from VerticesEngine.UI.vxUIControl
float	PositionDifference = 0

object	UserData
	Object variable which allows arbitary data too be passed between methods.

vxUIManager	UIManager
	The owning GUI Manger.

vxUIControlTheme	Theme = vxUIControlTheme.GetDefault()
	The item theme.

bool	IsVisible = true
	Gets or sets a value indicating whether this instance is visible.

string	Name = "<name>"
	Name Of GUI Item to help Identify it, not to be confused with Text.

string	LocalisationKey

string	PreviousText = ""

Vector2	TextSize = new Vector2()

float	Opacity = 1
	Gets or sets the opacity of the current GUI Item.

float	TransitionAlpha = 1
	A transition Alpha which can be controled by an owning control such as a Dialog or Message Box.

bool	DoSelectionBorder = true
	Do selection border.

bool	DoBorder = false
	Gets or sets the opacity of the current GUI Item.

int	BorderSize = 1
	The size of the border.

Vector2	ShadowOffset = new Vector2(5, 5)
	The shadow offset.

float	ShadowTransparency = 0.5f
	The shadow transparency.

Color	ShadowColour = Color.Black
	The shadow colour.

bool	ToggleState
	Toggle State of the GUI Item. Note: IsTogglable must be set too true.

float	Alpha = 1
	Gets or sets the alpha of the GUI Item.

float	HoverAlpha = 0
	Gets or sets the hover alpha.

float	HoverAlphaReq = 0
	Gets or sets the requested hover alpha for smoothing.

float	HoverAlphaMax = 1
	Gets or sets the hover alpha max.

float	HoverAlphaMin = 0
	Gets or sets the hover alpha minimum.

float	HoverAlphaDeltaSpeed = 4
	Gets or sets the hover alpha delta speed of smoothing.

Vector2	OriginalPosition = Vector2.Zero
	Position Of GUI Item.

Vector2	Padding = new Vector2(5)
	Padding Of GUI Item.

bool	IsFullWidth = false

bool	IsFullHeight = false

Rectangle	BorderBounds = Rectangle.Empty
	The border bounds of the gui item.

Color	BorderColour = Color.Black
	The border colour.

Vector4	BoundingRectangleMargins = new Vector4(0)

int	Index = 0
	Element Index.

int	GUIIndex = 0
	The index in the gui system.

ScreenState	ScreenState = ScreenState.TransitionOn

bool	DisableTouchSelectOnScroll = false
	This bool holds a value of whether or not Select should be disabled if the item is moved a certain distance in between 'TouchLocationState.Pressed' and 'TouchLocationState.Released'. The threshold distance is 'DisableScrollThreshold'.

float	DisableScrollThreshold = 5
	The disable scroll threshold. This is only used if 'DisableTouchSelectOnScroll' is true.

vxEnumClickType	ClickType = vxEnumClickType.OnPress

bool	IsUpdateable = true
	Is this item Updatable.

string	ToolTipText = ""

bool	IsToolTipEnabled = false
	Are Tooltips Enabled for this GUI Item.

int	ToolTipeCount = 0

int	ToolTipMax = 15
	The amount of update calls with this item recieving focus before it'll show the Tool Tip if it's Enabled.

float	ToolTipAlpha = 0

Protected Member Functions
void	HandleCursorPosition ()

void	HandleCursorMultilinePosition ()

Protected Member Functions inherited from VerticesEngine.UI.vxUIControl
void	Click ()
	Forces a click event.

virtual void	OnEnableStateChanged ()
	Called when the elabled state changes.

virtual void	OnDisposed ()
	Called when this UI control is disposed.

Properties
int	DisplayTextStart `[get, set]`

string	DisplayText `[get]`

Properties inherited from VerticesEngine.UI.vxUIControl
GraphicsDevice	GraphicsDevice `[get]`

Viewport	Viewport `[get]`

float	GetScalerAvg `[get]`

vxEnumGUIElementState	State `[get]`
	Gets the state.

vxSpriteBatch	SpriteBatch `[get]`
	Gets the sprite batch.

Texture2D	DefaultTexture `[get]`
	Gets the default texture.

string	Text `[get, set]`
	Text Of GUI Item.

SpriteFont	Font `[get, set]`
	Text Of GUI Item.

bool	IsShadowVisible `[get, set]`
	Should the image draw a shadow.

bool	HasFocus `[get, set]`
	Gets or sets a value indicating whether this instance has focus.

bool	CaptureInput `[get, set]`
	Gets or sets a value indicating whether this instance has focus.

bool	IsTogglable `[get, set]`
	Is the Item a Toggleable?

bool	IsSelected `[get, set]`
	Returns Whether or not the item is Selected.

bool	IsEnabled `[get, set]`
	Returns Whether or not the item is Enabled.

Vector2	Position `[get, set]`
	Position Of GUI Item.

int	Width `[get, set]`
	Width Of GUI Item.

int	Height `[get, set]`
	Width Of GUI Item.

Rectangle	Bounds `[get, set]`
	Bounding Rectangle Of GUI Item.

vxUIItemOrientation	ItemOrientation `[get, set]`
	GUI Item Orientation.

bool	IsOrientationHorizontal `[get]`

MouseState	PreviousMouseState `[get]`
	Previous Mouse State.

bool	HasMouseBeenUpYet `[get, set]`
	Gets a value indicating whether the mouse left button been up yet.

Events
EventHandler< EventArgs >	TextChanged
	Occurs when enabled state changed.

Events inherited from VerticesEngine.UI.vxUIControl
EventHandler< vxUIControlClickEventArgs >	Clicked
	Event Raised when the item is clicked.

EventHandler< vxUIControlClickEventArgs >	DoubleClicked
	Occurs when double clicked.

EventHandler< vxUIManagerItemAddEventArgs >	AddedToGUIManager
	Event Raised when this item is added to a GUI Manager.

EventHandler< EventArgs >	OnInitialHover
	Event Raised when the Mouse First Begins too Hover over this item.

EventHandler< EventArgs >	EnabledStateChanged
	Occurs when enabled state changed.

EventHandler< EventArgs >	PositionChanged
	Event raised when Item Position is Changed.

EventHandler< EventArgs >	ItemOreintationChanged
	Event Raised when Item Orientation is Changed.

Detailed Description

Textbox Control for us in the vxGUI System.

Constructor & Destructor Documentation

◆ vxTextbox() [1/2]

VerticesEngine.UI.Controls.vxTextbox.vxTextbox	(	string	text,
		Vector2	position,
		string	TextboxTitle = "Title",
		string	TextboxDescription = "Description" )

Initializes a new instance of the T:VerticesEngine.UI.Controls.vxTextbox class.

Parameters

text	This GUI Items Text.
position	This Items Start Position. Note that the 'OriginalPosition' variable will be set to this value as well.
TextboxTitle	Textbox title.
TextboxDescription	Textbox description.

◆ vxTextbox() [2/2]

VerticesEngine.UI.Controls.vxTextbox.vxTextbox	(	string	text,
		Vector2	position,
		string	TextboxTitle,
		string	TextboxDescription,
		int	width )

Initializes a new instance of the T:VerticesEngine.UI.Controls.vxTextbox class.

Parameters

text	This GUI Items Text.
position	This Items Start Position. Note that the 'OriginalPosition' variable will be set to this value as well.
TextboxTitle	Textbox title.
TextboxDescription	Textbox description.
length	Length.

Member Function Documentation

◆ Draw()

override void VerticesEngine.UI.Controls.vxTextbox.Draw ( )

virtual

Draws the GUI Item.

Reimplemented from VerticesEngine.UI.vxUIControl.

◆ GetDefaultFont()

virtual SpriteFont VerticesEngine.UI.Controls.vxTextbox.GetDefaultFont ( )

virtual

Gets the default font.

Returns: The font.

Reimplemented in VerticesEngine.UI.Controls.vxPropertyControlTextbox, and VerticesEngine.UI.Controls.vxPropertyControlGameObject.

◆ NotHover()

override void VerticesEngine.UI.Controls.vxTextbox.NotHover ( )

virtual

When the Mouse is NOT over the GUIItem.

Reimplemented from VerticesEngine.UI.vxUIControl.

◆ OnLayoutInvalidated()

override void VerticesEngine.UI.Controls.vxTextbox.OnLayoutInvalidated ( )

virtual

This is called whenever the layout is changed, content changed, or any method has been called which requires the control to be re-layedout.

Reimplemented from VerticesEngine.UI.vxUIControl.

◆ OnTextChanged()

override void VerticesEngine.UI.Controls.vxTextbox.OnTextChanged ( )

virtual

Fired whenerer the text changed (or a key is pressed).

Reimplemented from VerticesEngine.UI.vxUIControl.

◆ ProcessKeyInputs()

void VerticesEngine.UI.Controls.vxTextbox.ProcessKeyInputs ( float dt )

Hand keyboard input.

Parameters

dt

◆ Select()

override void VerticesEngine.UI.Controls.vxTextbox.Select ( )

virtual

When the GUIItem is Selected.

Reimplemented from VerticesEngine.UI.vxUIControl.

Member Data Documentation

◆ artProvider

vxTextboxArtProvider VerticesEngine.UI.Controls.vxTextbox.artProvider

Gets or sets the art provider.

The art provider.

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

/github/workspace/src/VerticesEngine/src.shared/UI/Controls/vxTextbox.cs

Public Member Functions

Public Attributes

Protected Member Functions

Properties

Events

Detailed Description

Constructor & Destructor Documentation

◆ vxTextbox() [1/2]

◆ vxTextbox() [2/2]

Member Function Documentation

◆ Draw()

◆ GetDefaultFont()

◆ NotHover()

◆ OnLayoutInvalidated()

◆ OnTextChanged()

◆ ProcessKeyInputs()

◆ Select()

Member Data Documentation

◆ artProvider