#include <textinput.hpp>

Inheritance diagram for gui::widget::TextInput:

Public Types
using	Ptr = std::unique_ptr< TextInput >

Public Types inherited from gui::widget::Widget
using	Ptr = std::unique_ptr< Widget >

Public Member Functions
	TextInput (glm::vec2 origin, const std::string &placeholder, gui::GUI *gui, std::shared_ptr< font::Loader > fonts, DynText::Options options)

void	render () override
	====================================================================================== More...

bool	hasHandle (Handle handle) const override
	====================================================================================== More...

Widget *	borrow (Handle handle) override
	Gives a pointer to the subwidget specified by the handle. More...

void	doClick (float x, float y) override
	Performs a click at the specified (x,y) position in the GUI coordinate frame. More...

void	doHover (float x, float y) override
	Performs a hover action at the specified (x,y) position in the GUI coordinate frame. More...

Public Member Functions inherited from gui::widget::Widget
	Widget (Type type, glm::vec2 origin)
	Sets the type and origin position of the widget, and assigns a new unique handle. More...

virtual	~Widget ()=default

void	setOrigin (glm::vec2 origin)
	Overrides the current origin position with the newly specified one. More...

virtual void	lock ()
	Function that is run after all of the widgets have been added to the screee but before any input handling has occurred. More...

CallbackHandle	addOnClick (Callback callback)
	====================================================================================== More...

CallbackHandle	addOnHover (Callback callback)
	Register a new onHover callback function for this widget. More...

void	removeOnClick (CallbackHandle handle)
	Removes the onClick callback function associated with the given handle. More...

void	removeOnHover (CallbackHandle handle)
	Removes the onHover callback function associated with the given handle. More...

virtual void	doClick (float x, float y)
	Performs a click at the specified (x,y) position in the GUI coordinate frame. More...

virtual void	doHover (float x, float y)
	Performs a hover action at the specified (x,y) position in the GUI coordinate frame. More...

virtual void	render ()=0
	====================================================================================== More...

Type	getType () const
	====================================================================================== More...

const glm::vec2 &	getOrigin () const
	Queries the origin position of the widget. More...

std::pair< std::size_t, std::size_t >	getSize () const
	Queries the size of the widget in pixels. More...

Handle	getHandle () const
	Queries the handle for this specific widget. More...

virtual bool	hasHandle (Handle handle) const
	====================================================================================== More...

virtual Widget *	borrow (Handle handle)
	Gives a pointer to the subwidget specified by the handle. More...

Static Public Member Functions
template<typename... Params>
static Ptr	make (Params &&... params)
	Constructs a TextInput unique ptr widget. More...

Additional Inherited Members
Protected Attributes inherited from gui::widget::Widget
Handle	handle
	====================================================================================== More...

Type	type
	Type of the widget. More...

glm::vec2	origin
	Origin position (bottom left) of the widget in GUI coordinates. More...

std::size_t	width {0}
	Width of the widget, in pixels. More...

std::size_t	height {0}
	Height of the widget, in pixels. More...

std::unordered_map< CallbackHandle, Callback >	on_clicks
	all of the onClick handlers, indexable by handle More...

std::unordered_map< CallbackHandle, Callback >	on_hovers
	all of the onHover handlers, indexable by handle More...

Static Protected Attributes inherited from gui::widget::Widget
static std::size_t	num_widgets = 0
	Static counter for the number of widgets that have been created, so a new identifier can be assigned to each widget as they are created. More...

Detailed Description

Widget to capture text input. NOTE: with the current implementation, there can only be one of these active in the GUI at one time. If there are multiple, they will both affect each other.

Member Typedef Documentation

◆ Ptr

using gui::widget::TextInput::Ptr = std::unique_ptr<TextInput>

Constructor & Destructor Documentation

◆ TextInput()

gui::widget::TextInput::TextInput	(	glm::vec2	origin,
		const std::string &	placeholder,
		gui::GUI *	gui,
		std::shared_ptr< font::Loader >	fonts,
		DynText::Options	options
	)

Member Function Documentation

◆ borrow()

Widget * gui::widget::TextInput::borrow ( Handle handle )

overridevirtual

Gives a pointer to the subwidget specified by the handle.

NOTE: if handle is not a valid handle for either (1) this widget or (2) any subwidgets, then this function will terminate the program and print out an error message.

Returns: a pointer to the widget specified by handle

Reimplemented from gui::widget::Widget.

◆ doClick()

void gui::widget::TextInput::doClick	(	float	x,
		float	y
	)

overridevirtual

Performs a click at the specified (x,y) position in the GUI coordinate frame.

NOTE: This function's main role is to determine if a click at the specified (x,y) coordinate should trigger the onClick handlers for this widget. The default implementation of this checks to see if the (x,y) coordinate is within the bounds specified by origin and width and height, and if so calls all of the onClick handlers.

NOTE: One reason for a derived class to override this function is if the widget itself contains other widgets, because in that case doClick will not be called on those "subwidgets" unless this function passes the call down the chain

Parameters

x	x coordinate of the click in GUI coordinates
y	y coordinate of the click in GUI coordinates

Reimplemented from gui::widget::Widget.

◆ doHover()

void gui::widget::TextInput::doHover	(	float	x,
		float	y
	)

overridevirtual

Performs a hover action at the specified (x,y) position in the GUI coordinate frame.

NOTE: see the documentation for doClick, as everything said there also applies here, but just for the hover actions.

Reimplemented from gui::widget::Widget.

◆ hasHandle()

bool gui::widget::TextInput::hasHandle ( Handle handle ) const

overridevirtual

======================================================================================

=<WIDGET BORROWING>===================================================================

The following functions are incredibly important for GUI manipulation, especially in event handlers. They essentially define how outside users can gain internal access to widgets that are inside of the GUI

hasHandle should always be called before calling borrow if you aren't sure whether or not the widget actually has the specified handle, because borrow will terminate the program if the specified widget does not have the handle.

By default hasHandle and borrow only check the widget itself to see if the handle matches. This means that if some derived Widget acts as a container for some set of internal subwidgets, then these functions should be overridden to provide access to those subwidgets.

Checks to see whether or not this widget "has" the specified handle, whether because the handle is this widgets handle, or because this widget internally contains some subwidget that has that handle.

Parameters

handle Handle of the widget for which you want to query

Returns: True if this widget is or contains the specified widget, false otherwise

Reimplemented from gui::widget::Widget.

◆ make()

template<typename... Params>

static Ptr gui::widget::TextInput::make ( Params &&... params )

inlinestatic

Constructs a TextInput unique ptr widget.

Parameters

Origin	bottom left (x,y) coordinate in GUI coordinates
placeholder	Text to display if no text has been inputted yet
gui	Pointer to the GUI class, so internally we can access keystroke information
fonts	Font loader
options	(Optional) Configurable options for the widget

◆ render()

void gui::widget::TextInput::render ( )

overridevirtual

======================================================================================

=<DISPLAY>============================================================================

Renders the widget to the screen

This is the only function that must be overridden by derived classes.

Implements gui::widget::Widget.

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

include/client/gui/widget/textinput.hpp
src/client/gui/widget/textinput.cpp

Public Types

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Ptr

Constructor & Destructor Documentation

◆ TextInput()

Member Function Documentation

◆ borrow()

◆ doClick()

◆ doHover()

◆ hasHandle()

◆ make()

◆ render()