====== Input GUI Widgets III ======

----

===== Text GUI Class =====

----

[[https://github.com/LibreCAD/LibreCAD_3/blob/master/lcUI/widgets/guiAPI/textgui.h|Github Link]]
<code cpp-qt> namespace lc::ui::api </code>

The Text GUI widget allows the user to enter data in a text format.

----

==== Constructor ====

----

=== Description ===

Constructs an Text GUI widget.

=== Examples ===

  * <code lua> local text1 = gui.Text("Text1") </code>

----

==== Get and Set Values ====

----

=== Description ===

Used to get and set the desired value for the text widget. Data of type //string// is returned.

=== Examples ===

  * <code lua> local textval = text1:value() </code>
  * <code lua> text1:setValue("SomeText") </code>

----

==== Add Finish Callback ====

----

=== Description ===

Add a finish callback which is called when the user presses enter after entering the text or clicks somewhere else and the input gui loses focus. This is different from the dialog widget finish callback.

=== Examples ===

  * <code lua> text1:addFinishCallback(function() message("Finished entering text") end) </code>

----

==== Add On Change Callback ====

----

=== Description ===

Add an on change callback which is called when the user types anything i.e. on any change to the text input.

=== Examples ===

  * <code lua> text1:addOnChangeCallback(function(newtext) message(tostring(newtext)) end) </code>

----

===== Color Picker GUI Class =====

----

[[https://github.com/LibreCAD/LibreCAD_3/blob/master/lcUI/widgets/guiAPI/colorgui.h|Github Link]]
<code cpp-qt> namespace lc::ui::api </code>

The Color Picker GUI widget allows the user to enter color data by choosing it visually.
----

==== Constructor ====

----

=== Description ===

Constructs a Color GUI widget.

=== Examples ===

  * <code lua> local color1 = gui.Color("Color1") </code>

----

==== Get and Set Values ====

----

=== Description ===

Used to get and set the desired value for the color widget. Data of type //lc::Color// is returned. setValue expects a //lc::Color// as parameter.

=== Examples ===

  * <code lua> local col = color1:value() </code>
  * <code lua> color1:setValue(lc.Color(1,1,1)) </code>

----

==== Add Callback ====

----

=== Description ===

Adds a callback which is called whenever a color is selected in the color gui widget.

=== Examples ===

  * <code lua> color1:addCallback(function(col) message("Color picked") end) </code>

----

===== Horizontal Group GUI Class =====

----

[[https://github.com/LibreCAD/LibreCAD_3/blob/master/lcUI/widgets/guiAPI/horizontalgroupgui.h|Github Link]]
<code cpp-qt> namespace lc::ui::api </code>

The Horizontal Group GUI widget allows the user to store the input gui widgets in a horizontal layout.
----

==== Constructor ====

----

=== Description ===

Constructs a Horizontal Group GUi widget. The input gui widgets in the group are added to the final value table but not the horizontal group.

=== Examples ===

  * <code lua> local horiz1 = gui.HorizontalGroup("Horizontal1") </code>

----

==== Add Input GUI Widget ====

----

=== Description ===

Add an Input GUI widget to the horizontal group. Expects a key and gui widget as parameters.

=== Examples ===

  * <code lua> local angle1 = gui.Angle("Angle1") 
 horiz1:addWidget("angle1", angle1) </code>

----

===== RadioButton Group GUI Class =====

----

[[https://github.com/LibreCAD/LibreCAD_3/blob/master/lcUI/widgets/guiAPI/radiogroupgui.h|Github Link]]
<code cpp-qt> namespace lc::ui::api </code>

The RadioButton Group GUI widget allows the user to store the radio buttons in a group so that only one radio button can be selected in the group.
----

==== Constructor ====

----

=== Description ===

Constructs a RadioButton Group GUI class.

=== Examples ===

  * <code lua> local radiogroup1 = gui.RadioGroup("RadioGroup1") </code>

----

==== Add Radio Button ====

----

=== Description ===

Add an RadioButton GUI widget to the radio group. Expects a key and radiobutton as parameters.

=== Examples ===

  * <code lua> local radio1 = gui.RadioButton("Radio1") 
 radiogroup1:addButton("radio1", radio1) </code>

----