Password field widget. To instantiate and add to a container use the add static method. More...

#include <password_field.h>

Inheritance diagram for liblec::lecui::widgets::password_field:

Static Public Member Functions
static text_field &	add (containers::page &page, const std::string &alias=std::string())
	Add a password field to a container. More...

static text_field &	get (form &fm, const std::string &path)
	Get the specifications of a password field. More...

Static Public Member Functions inherited from liblec::lecui::widgets::text_field
static text_field &	add (containers::page &page, const std::string &alias=std::string())
	Add a text field to a container. More...

static text_field &	get (form &fm, const std::string &path)
	Get the specifications of a text field. More...

Additional Inherited Members
Public Types inherited from liblec::lecui::widgets::widget
enum class	cursor_type { arrow , hand , caret }
	Mouse cursor type. More...

Public Member Functions inherited from liblec::lecui::widgets::text_field
	text_field ()
	Constructor.

text_field_events &	events ()
	Text field events. More...

bool	operator== (const text_field &param)
	Check whether widget specs are equal. Only those properties that require the widget resources to be re-created are considered. More...

bool	operator!= (const text_field &param)
	Check whether widget specs are NOT equal. Only those properties that require the widget resources to be re-created are considered. More...

std::string &	text () override
	Get or set the widget text. More...

text_field &	text (const std::string &text)
	Set the widget's text. More...

std::string &	tooltip () override
	Get or set the widget's tooltip text. More...

text_field &	tooltip (const std::string &tooltip)
	Set the tooltip text. More...

lecui::rect &	rect () override
	Get or set the position and dimensions of the widget. More...

text_field &	rect (const lecui::rect &rect)
	Set the position and dimensions of the widget. More...

resize_params &	on_resize () override
	Get or set the behaviour of the widget when its container is resized. More...

text_field &	on_resize (const resize_params &on_resize)
	Set the behaviour of the widget when its container is resized. More...

cursor_type &	cursor () override
	Get or set the mouse cursor to use then over the widget. More...

text_field &	cursor (const cursor_type cursor)
	Set the mouse cursor to use when over the widget. More...

std::string &	font () override
	Get or set the default widget font, e.g. "Georgia". More...

text_field &	font (const std::string &font)
	Set the default widget font. More...

float &	font_size () override
	Get or set the default widget font size in points, e.g. 9.0f. More...

text_field &	font_size (const float &font_size)
	Set the widget's font size. More...

color &	color_text () override
	Get or set the color of the widget's text. More...

text_field &	color_text (const color &color_text)
	Set the color of the widget's text. More...

color &	color_fill () override
	Get or set the fill color of the widget. More...

text_field &	color_fill (const color &color_fill)
	Set the fill color of the widget. More...

color &	color_hot () override
	Get or set the widget's color when the mouse is hovered over it. More...

text_field &	color_hot (const color &color_hot)
	Set the widget's color when the mouse is hovered over it. More...

color &	color_selected () override
	Get or set the widget's color when selected. More...

text_field &	color_selected (const color &color_selected)
	Set the widget's color when selected. More...

color &	color_disabled () override
	Get or set the widget's color when it is disabled. More...

text_field &	color_disabled (const color &color_disabled)
	Set the widget's color when it is disabled. More...

float &	border ()
	Get or set the thickness of the border. More...

text_field &	border (const float &border)
	Set the thickness of the border. More...

color &	color_border ()
	Get or set the color of the border. More...

text_field &	color_border (const color &color_border)
	Set the color of the border. More...

float &	corner_radius_x ()
	Get or set the horizontal radius of the corners. More...

text_field &	corner_radius_x (const float &corner_radius_x)
	Set the horizontal radius of the corners. More...

float &	corner_radius_y ()
	Get or set the vertical radius of the corners. More...

text_field &	corner_radius_y (const float &corner_radius_y)
	Set the vertical radius of the corners. More...

std::string &	prompt ()
	Get or set the text to be displayed when the widget is empty. More...

text_field &	prompt (const std::string &prompt)
	Set the text to be displayed when the widget is empty. More...

color &	color_prompt ()
	Get or set the color of the prompt text. More...

text_field &	color_prompt (const color &color_prompt)
	Set the color of the prompt text. More...

color &	color_caret ()
	Get or set the color of the caret. More...

text_field &	color_caret (const color &color_caret)
	Set the color of the caret. More...

color &	color_input_error ()
	Get or set the color to show that there has been an input error. More...

text_field &	color_input_error (const color &color_input_error)
	Set the color to show that there has been an input error. More...

std::set< char > &	allowed_characters ()
	Get or set the character set to limit input to. More...

text_field &	allowed_characters (const std::set< char > &allowed_characters)
	Set the character set to limit input to. More...

std::set< char > &	forbidden_characters ()
	Get or set the set of characters to prevent from being typed in. More...

text_field &	forbidden_characters (const std::set< char > &forbidden_characters)
	Set the set of characters to prevent from being typed in. More...

int &	maximum_length ()
	Get or set the maximum length of the input string. 0 means unlimited length. More...

text_field &	maximum_length (const int &maximum_length)
	Set the maximum length of the input string. More...

Public Member Functions inherited from liblec::lecui::widgets::widget
	widget ()
	Widget constructor.

virtual	~widget ()
	Widget descructor.

bool	operator== (const widget &param)
	Check whether widget's basic specifications are equal. Only those properties that require the widget's basic resources to be re-created are considered. More...

bool	operator!= (const widget &param)
	Check whether widget's basic specifications are NOT equal. Only those properties that require the widget's basic resources to be re-created are considered. More...

virtual std::string &	text ()=0
	Get or set the widget text. More...

virtual std::string &	tooltip ()=0
	Get or set the widget's tooltip text. More...

virtual lecui::rect &	rect ()=0
	Get or set the position and dimensions of the widget. More...

virtual resize_params &	on_resize ()=0
	Get or set the behaviour of the widget when its container is resized. More...

virtual cursor_type &	cursor ()=0
	Get or set the mouse cursor to use then over the widget. More...

virtual std::string &	font ()=0
	Get or set the default widget font, e.g. "Georgia". More...

virtual float &	font_size ()=0
	Get or set the default widget font size in points, e.g. 9.0f. More...

virtual color &	color_text ()=0
	Get or set the color of the widget's text. More...

virtual color &	color_fill ()=0
	Get or set the fill color of the widget. More...

virtual color &	color_hot ()=0
	Get or set the widget's color when the mouse is hovered over it. More...

virtual color &	color_selected ()=0
	Get or set the widget's color when selected. More...

virtual color &	color_disabled ()=0
	Get or set the widget's color when it's disabled. More...

basic_events &	events ()
	Widget events. More...

const std::string &	alias ()
	The widget's alias, either user defined or automatically generated by the library. More...

Protected Attributes inherited from liblec::lecui::widgets::widget
std::string	_text
	The widget's text.

std::string	_tooltip
	The widget's tooltip text.

lecui::rect	_rect
	The widget's rectangle.

resize_params	_on_resize = { 0.f, 0.f, 0.f, 0.f }
	The widget's behaviour when container is resized.

cursor_type	_cursor = cursor_type::arrow
	The widget's cursor.

std::string	_font = "Segoe UI"
	The widget's font.

float	_font_size = 9.f
	The widget's font size.

color	_color_text = { 0, 0, 0, 255 }
	The color of the widget's text.

color	_color_fill = { 0, 120, 170, 255 }
	The fill color of the widget.

color	_color_hot = { 0, 120, 170, 255 }
	The color to indicate when the mouse hovers over the widget.

color	_color_selected = { 0, 120, 170, 30 }
	The color to indicate when the widget is selected.

color	_color_disabled = { 180, 180, 180, 255 }
	The color to indicate when the widget is disabled.

Detailed Description

Password field widget. To instantiate and add to a container use the add static method.

Member Function Documentation

◆ add()

static text_field & liblec::lecui::widgets::password_field::add	(	containers::page &	page,
		const std::string &	alias = `std::string()`
	)

static

Add a password field to a container.

Parameters

page	The container to place the widget in.
alias	The in-page unique alias, e.g. "password".

Returns: A reference to the widget specifications.

If an empty alias is given an internally generated random alias will be assigned.

◆ get()

static text_field & liblec::lecui::widgets::password_field::get	(	form &	fm,
		const std::string &	path
	)

static

Get the specifications of a password field.

Parameters

fm	A reference to the form.
path	The full path to the widget, e.g. "login_page/credentials_pane/password".

Returns: A reference to the widget specifications.

Throws on failure. For faster coding and more readable code consider calling this static method through the helper macro provided.

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

widgets/password_field.h

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ add()

◆ get()