lecui 1.0.0-alpha.20
lecui C++ user interface library
Classes | Public Member Functions | Static Public Member Functions | List of all members
liblec::lecui::widgets::table_view Class Reference

Table view widget. To instantiate and add to a container use the add static method. More...

#include <table_view.h>

Inheritance diagram for liblec::lecui::widgets::table_view:
liblec::lecui::widgets::widget

Classes

struct  table_view_events
 Events specific to this widget. More...
 

Public Member Functions

 table_view ()
 Constructor.
 
table_view_eventsevents ()
 Get or set table view events. More...
 
bool operator== (const table_view &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 table_view &param)
 Check whether widget specs are NOT equal. Only those properties that require the widget resources to be re-created are considered. More...
 
table_viewoperator= (const table_view &param)
 Copy table view specs. Only essential properties are copied. More...
 
 table_view (const table_view &param)
 Copy constructor. More...
 
std::string & text () override
 Get or set the widget text. More...
 
table_viewtext (const std::string &text)
 Set the widget's text. More...
 
std::string & tooltip () override
 Get or set the widget's tooltip text. More...
 
table_viewtooltip (const std::string &tooltip)
 Set the tooltip text. More...
 
lecui::rectrect () override
 Get or set the position and dimensions of the widget. More...
 
table_viewrect (const lecui::rect &rect)
 Set the position and dimensions of the widget. More...
 
resize_paramson_resize () override
 Get or set the behaviour of the widget when its container is resized. More...
 
table_viewon_resize (const resize_params &on_resize)
 Set the behaviour of the widget when its container is resized. More...
 
cursor_typecursor () override
 Get or set the mouse cursor to use then over the widget. More...
 
table_viewcursor (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...
 
table_viewfont (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...
 
table_viewfont_size (const float &font_size)
 Set the widget's font size. More...
 
colorcolor_text () override
 Get or set the color of the widget's text. More...
 
table_viewcolor_text (const color &color_text)
 Set the color of the widget's text. More...
 
colorcolor_fill () override
 Get or set the fill color of the widget. More...
 
table_viewcolor_fill (const color &color_fill)
 Set the fill color of the widget. More...
 
colorcolor_hot () override
 Get or set the widget's color when the mouse is hovered over it. More...
 
table_viewcolor_hot (const color &color_hot)
 Set the widget's color when the mouse is hovered over it. More...
 
colorcolor_selected () override
 Get or set the widget's color when selected. More...
 
table_viewcolor_selected (const color &color_selected)
 Set the widget's color when selected. More...
 
colorcolor_disabled () override
 Get or set the widget's color when it is disabled. More...
 
table_viewcolor_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...
 
table_viewborder (const float &border)
 Set the thickness of the border. More...
 
float & grid_line ()
 Get or set the thickness of the grid-lines. More...
 
table_viewgrid_line (const float &grid_line)
 Set the thickness of the grid-line. More...
 
colorcolor_border ()
 Get or set the color of the border. More...
 
table_viewcolor_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...
 
table_viewcorner_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...
 
table_viewcorner_radius_y (const float &corner_radius_y)
 Set the vertical radius of the corners. More...
 
colorcolor_text_selected ()
 Get or set the color of the text in a selected row. More...
 
table_viewcolor_text_selected (const color &color_text_selected)
 Set the color of the text in a selected row. More...
 
colorcolor_grid ()
 Get or set the color of the grid lines. More...
 
table_viewcolor_grid (const color &color_grid)
 Set the color of the grid lines. More...
 
colorcolor_text_header ()
 Get or set the color of the header text. More...
 
table_viewcolor_text_header (const color &color_text_header)
 Set the color of the header text. More...
 
colorcolor_text_header_hot ()
 Get or set the color of the header text when the mouse is over it (if user sorting is allowed). More...
 
table_viewcolor_text_header_hot (const color &color_text_header_hot)
 Set the color of the header text when the mouse is over it (if user sorting is allowed). More...
 
colorcolor_fill_header ()
 Get or set the table header's fill color. More...
 
table_viewcolor_fill_header (const color &color_fill_header)
 Set the table header's fill color. More...
 
colorcolor_fill_alternate ()
 Get or set the table's alternate row color (used for the background of even rows). More...
 
table_viewcolor_fill_alternate (const color &color_fill_alternate)
 Set the table's alternate row color (used for the background of even rows). More...
 
colorcolor_row_hot ()
 Get or set the background color of a row when the mouse is over it. More...
 
table_viewcolor_row_hot (const color &color_row_hot)
 Set the background color of a row when the mouse is over it. More...
 
colorcolor_row_selected ()
 Get or set the background color of a selected row. More...
 
table_viewcolor_row_selected (const color &color_row_selected)
 Set the background color of a selected row. More...
 
std::vector< table_column > & columns ()
 Get or set the table view columns. More...
 
table_viewcolumns (const std::vector< table_column > &columns)
 Set the table view columns. More...
 
std::vector< table_row > & data ()
 Get or set the table's data. Each entry of the vector (a map) is a row and should mirror the column structure. The key is the column name and the value is the contents of the cell. Therefore the map size should be equivalent to the number of columns, while the size of the vector will determine the number of rows. More...
 
table_viewdata (const std::vector< table_row > &data)
 Set the table's data. Each entry of the vector (a map) is a row and should mirror the column structure. The key is the column name and the value is the contents of the cell. Therefore the map size should be equivalent to the number of columns, while the size of the vector will determine the number of rows. More...
 
std::vector< long > & selected ()
 Get or set the rows to select by default, numbered from 0. More...
 
table_viewselected (const std::vector< long > &selected)
 Set the rows to select by default, numbered from 0. More...
 
bool & user_sort ()
 Get or set whether to allow sorting by clicking columns. More...
 
table_viewuser_sort (const bool &user_sort)
 Set whether to allow sorting by clicking columns. More...
 
bool & fixed_number_column ()
 Get or set whether to add a fixed number column. More...
 
table_viewfixed_number_column (const bool &fixed_number_column)
 Set whether to add a fixed number column. More...
 
std::string & fixed_number_column_name ()
 Get or set the name of the fixed number column. More...
 
table_viewfixed_number_column_name (const std::string &fixed_number_column_name)
 Set the name of the fixed number column. More...
 
void scroll_vertically (const float &amount)
 Programmatically scroll the table vertically. More...
 
void scroll_horizontally (const float &amount)
 Programmatically scroll the table horizontally. 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::rectrect ()=0
 Get or set the position and dimensions of the widget. More...
 
virtual resize_paramson_resize ()=0
 Get or set the behaviour of the widget when its container is resized. More...
 
virtual cursor_typecursor ()=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 colorcolor_text ()=0
 Get or set the color of the widget's text. More...
 
virtual colorcolor_fill ()=0
 Get or set the fill color of the widget. More...
 
virtual colorcolor_hot ()=0
 Get or set the widget's color when the mouse is hovered over it. More...
 
virtual colorcolor_selected ()=0
 Get or set the widget's color when selected. More...
 
virtual colorcolor_disabled ()=0
 Get or set the widget's color when it's disabled. More...
 
basic_eventsevents ()
 Widget events. More...
 
const std::string & alias ()
 The widget's alias, either user defined or automatically generated by the library. More...
 

Static Public Member Functions

static table_viewadd (containers::page &page, const std::string &alias=std::string())
 Add a table_view to a container. More...
 
static table_viewget (form &fm, const std::string &path)
 Get the specifications of a table_view. More...
 

Additional Inherited Members

- Public Types inherited from liblec::lecui::widgets::widget
enum class  cursor_type { arrow , hand , caret }
 Mouse cursor type. 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

Table view widget. To instantiate and add to a container use the add static method.

Default size is 200x200px.

Constructor & Destructor Documentation

◆ table_view()

liblec::lecui::widgets::table_view::table_view ( const table_view param)

Copy constructor.

Parameters
paramThe table view specs to copy.

Member Function Documentation

◆ add()

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

Add a table_view to a container.

Parameters
pageThe container to place the widget in.
aliasThe in-page unique alias, e.g. "debtors".
Returns
A reference to the widget specifications.

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

◆ border() [1/2]

float & liblec::lecui::widgets::table_view::border ( )

Get or set the thickness of the border.

Returns
A reference to the border thickness, in pixels.

◆ border() [2/2]

table_view & liblec::lecui::widgets::table_view::border ( const float &  border)

Set the thickness of the border.

Parameters
borderThe border thickness, in pixels.
Returns
A reference to the modified object.

◆ color_border() [1/2]

color & liblec::lecui::widgets::table_view::color_border ( )

Get or set the color of the border.

Returns
A reference to the border color, as defined in color.

◆ color_border() [2/2]

table_view & liblec::lecui::widgets::table_view::color_border ( const color color_border)

Set the color of the border.

Parameters
color_borderThe border color, as defined in color.
Returns
A reference to the modified object.

◆ color_disabled() [1/2]

color & liblec::lecui::widgets::table_view::color_disabled ( )
overridevirtual

Get or set the widget's color when it is disabled.

Returns
a reference to the property.

Implements liblec::lecui::widgets::widget.

◆ color_disabled() [2/2]

table_view & liblec::lecui::widgets::table_view::color_disabled ( const color color_disabled)

Set the widget's color when it is disabled.

Parameters
color_disabledThe color of the widget when it is disabled, as defined in color.
Returns
A reference to the modified object.

◆ color_fill() [1/2]

color & liblec::lecui::widgets::table_view::color_fill ( )
overridevirtual

Get or set the fill color of the widget.

Returns
A reference to the widget's fill color.

Implements liblec::lecui::widgets::widget.

◆ color_fill() [2/2]

table_view & liblec::lecui::widgets::table_view::color_fill ( const color color_fill)

Set the fill color of the widget.

Parameters
color_fillThe fill color.
Returns
A reference to the modified object.

◆ color_fill_alternate() [1/2]

color & liblec::lecui::widgets::table_view::color_fill_alternate ( )

Get or set the table's alternate row color (used for the background of even rows).

Returns
A reference to the color.

◆ color_fill_alternate() [2/2]

table_view & liblec::lecui::widgets::table_view::color_fill_alternate ( const color color_fill_alternate)

Set the table's alternate row color (used for the background of even rows).

Parameters
color_fill_alternate
Returns
A reference to the modified object.

◆ color_fill_header() [1/2]

color & liblec::lecui::widgets::table_view::color_fill_header ( )

Get or set the table header's fill color.

Returns
A reference to the color.

◆ color_fill_header() [2/2]

table_view & liblec::lecui::widgets::table_view::color_fill_header ( const color color_fill_header)

Set the table header's fill color.

Parameters
color_fill_headerThe color.
Returns
A reference to the modified object.

◆ color_grid() [1/2]

color & liblec::lecui::widgets::table_view::color_grid ( )

Get or set the color of the grid lines.

Returns
A reference to the color.

◆ color_grid() [2/2]

table_view & liblec::lecui::widgets::table_view::color_grid ( const color color_grid)

Set the color of the grid lines.

Parameters
color_gridThe color.
Returns
A reference to the modified object.

◆ color_hot() [1/2]

color & liblec::lecui::widgets::table_view::color_hot ( )
overridevirtual

Get or set the widget's color when the mouse is hovered over it.

Returns
A reference to the widget's hover color.

Implements liblec::lecui::widgets::widget.

◆ color_hot() [2/2]

table_view & liblec::lecui::widgets::table_view::color_hot ( const color color_hot)

Set the widget's color when the mouse is hovered over it.

Parameters
color_hotThe color.
Returns
A reference to the modified object.

◆ color_row_hot() [1/2]

color & liblec::lecui::widgets::table_view::color_row_hot ( )

Get or set the background color of a row when the mouse is over it.

Returns
A reference to the color.

◆ color_row_hot() [2/2]

table_view & liblec::lecui::widgets::table_view::color_row_hot ( const color color_row_hot)

Set the background color of a row when the mouse is over it.

Parameters
color_row_hotThe color.
Returns
A reference to the modified object.

◆ color_row_selected() [1/2]

color & liblec::lecui::widgets::table_view::color_row_selected ( )

Get or set the background color of a selected row.

Returns
A reference to the color.

◆ color_row_selected() [2/2]

table_view & liblec::lecui::widgets::table_view::color_row_selected ( const color color_row_selected)

Set the background color of a selected row.

Parameters
color_row_selectedThe color.
Returns
A reference to the modified object.

◆ color_selected() [1/2]

color & liblec::lecui::widgets::table_view::color_selected ( )
overridevirtual

Get or set the widget's color when selected.

Returns
A reference to the widget's color when selected.

Implements liblec::lecui::widgets::widget.

◆ color_selected() [2/2]

table_view & liblec::lecui::widgets::table_view::color_selected ( const color color_selected)

Set the widget's color when selected.

Parameters
color_selectedThe widget's color when selected.
Returns
A reference to the modified object.

◆ color_text() [1/2]

color & liblec::lecui::widgets::table_view::color_text ( )
overridevirtual

Get or set the color of the widget's text.

Returns
A reference to the widget's text color.

Implements liblec::lecui::widgets::widget.

◆ color_text() [2/2]

table_view & liblec::lecui::widgets::table_view::color_text ( const color color_text)

Set the color of the widget's text.

Parameters
color_textThe color of the widget's text.
Returns
A reference to the modified object.

◆ color_text_header() [1/2]

color & liblec::lecui::widgets::table_view::color_text_header ( )

Get or set the color of the header text.

Returns
A reference to the color.

◆ color_text_header() [2/2]

table_view & liblec::lecui::widgets::table_view::color_text_header ( const color color_text_header)

Set the color of the header text.

Parameters
color_text_headerThe color.
Returns
A reference to the modified object.

◆ color_text_header_hot() [1/2]

color & liblec::lecui::widgets::table_view::color_text_header_hot ( )

Get or set the color of the header text when the mouse is over it (if user sorting is allowed).

Returns
A reference to the color.

◆ color_text_header_hot() [2/2]

table_view & liblec::lecui::widgets::table_view::color_text_header_hot ( const color color_text_header_hot)

Set the color of the header text when the mouse is over it (if user sorting is allowed).

Parameters
color_text_header_hotThe color.
Returns
A reference to the modified object.

◆ color_text_selected() [1/2]

color & liblec::lecui::widgets::table_view::color_text_selected ( )

Get or set the color of the text in a selected row.

Returns
A reference to the color.

◆ color_text_selected() [2/2]

table_view & liblec::lecui::widgets::table_view::color_text_selected ( const color color_text_selected)

Set the color of the text in a selected row.

Parameters
color_text_selectedThe color.
Returns
A reference to the modified object.

◆ columns() [1/2]

std::vector< table_column > & liblec::lecui::widgets::table_view::columns ( )

Get or set the table view columns.

Returns
A reference to the list of the table view's columns.

Two columns can be defined as follows: columns = { { "Name", 130 }, { "Surname", 210 } };

◆ columns() [2/2]

table_view & liblec::lecui::widgets::table_view::columns ( const std::vector< table_column > &  columns)

Set the table view columns.

Parameters
columnsThe list of columns.
Returns
A reference to the modified object.

Two columns can be defined as follows: columns = { { "Name", 130 }, { "Surname", 210 } };

◆ corner_radius_x() [1/2]

float & liblec::lecui::widgets::table_view::corner_radius_x ( )

Get or set the horizontal radius of the corners.

Returns
A reference to the radius, in pixels.

◆ corner_radius_x() [2/2]

table_view & liblec::lecui::widgets::table_view::corner_radius_x ( const float &  corner_radius_x)

Set the horizontal radius of the corners.

Parameters
corner_radius_xThe horizontal radius of the corner, in pixels.
Returns
A reference to the modified object.

◆ corner_radius_y() [1/2]

float & liblec::lecui::widgets::table_view::corner_radius_y ( )

Get or set the vertical radius of the corners.

Returns
A reference to the radius, in pixels.

◆ corner_radius_y() [2/2]

table_view & liblec::lecui::widgets::table_view::corner_radius_y ( const float &  corner_radius_y)

Set the vertical radius of the corners.

Parameters
corner_radius_yThe horizontal radius of the corner, in pixels.
Returns
A reference to the modified object.

◆ cursor() [1/2]

cursor_type & liblec::lecui::widgets::table_view::cursor ( )
overridevirtual

Get or set the mouse cursor to use then over the widget.

Returns
A reference to the cursor type as defined in cursor_type.

Implements liblec::lecui::widgets::widget.

◆ cursor() [2/2]

table_view & liblec::lecui::widgets::table_view::cursor ( const cursor_type  cursor)

Set the mouse cursor to use when over the widget.

Parameters
cursorThe cursor type as defined in cursor_type.
Returns
A reference to the modified object.

◆ data() [1/2]

std::vector< table_row > & liblec::lecui::widgets::table_view::data ( )

Get or set the table's data. Each entry of the vector (a map) is a row and should mirror the column structure. The key is the column name and the value is the contents of the cell. Therefore the map size should be equivalent to the number of columns, while the size of the vector will determine the number of rows.

Returns
A reference to the table's data.

A table with two columns 'Name' and 'Surname' can be populated as follows to a total of three rows: data = { { {"Name", "Emily Yolanda"}, { "Surname", "Moyo" } }, { {"Name", "Tanaka"}, {"Surname", "Sibanda"} }, { {"Name", "Precious"}, {"Surname", "Ncube"} }

◆ data() [2/2]

table_view & liblec::lecui::widgets::table_view::data ( const std::vector< table_row > &  data)

Set the table's data. Each entry of the vector (a map) is a row and should mirror the column structure. The key is the column name and the value is the contents of the cell. Therefore the map size should be equivalent to the number of columns, while the size of the vector will determine the number of rows.

Parameters
dataThe table's data.
Returns
A reference to the modified object.

A table with two columns 'Name' and 'Surname' can be populated as follows to a total of three rows: data = { { {"Name", "Emily Yolanda"}, { "Surname", "Moyo" } }, { {"Name", "Tanaka"}, {"Surname", "Sibanda"} }, { {"Name", "Precious"}, {"Surname", "Ncube"} }

◆ events()

table_view_events & liblec::lecui::widgets::table_view::events ( )
inline

Get or set table view events.

Returns
A reference to the table view events.

◆ fixed_number_column() [1/2]

bool & liblec::lecui::widgets::table_view::fixed_number_column ( )

Get or set whether to add a fixed number column.

Returns
A reference to the property.

Counts from 1 and is not sorted when the table's columns are user sorted.

◆ fixed_number_column() [2/2]

table_view & liblec::lecui::widgets::table_view::fixed_number_column ( const bool &  fixed_number_column)

Set whether to add a fixed number column.

Parameters
fixed_number_columnThe property.
Returns
A reference to the modified object.

Counts from 1 and is not sorted when the table's columns are user sorted.

◆ fixed_number_column_name() [1/2]

std::string & liblec::lecui::widgets::table_view::fixed_number_column_name ( )

Get or set the name of the fixed number column.

Returns
A reference to the property.

◆ fixed_number_column_name() [2/2]

table_view & liblec::lecui::widgets::table_view::fixed_number_column_name ( const std::string &  fixed_number_column_name)

Set the name of the fixed number column.

Parameters
fixed_number_column_nameThe property.
Returns
A reference to the modified object.

◆ font() [1/2]

std::string & liblec::lecui::widgets::table_view::font ( )
overridevirtual

Get or set the default widget font, e.g. "Georgia".

Returns
A reference to the widget's font name.

Implements liblec::lecui::widgets::widget.

◆ font() [2/2]

table_view & liblec::lecui::widgets::table_view::font ( const std::string &  font)

Set the default widget font.

Parameters
fontThe font's name, e.g. "Georgia".
Returns
A reference to the modified object.

◆ font_size() [1/2]

float & liblec::lecui::widgets::table_view::font_size ( )
overridevirtual

Get or set the default widget font size in points, e.g. 9.0f.

Returns
A reference to the widget's font size.

Implements liblec::lecui::widgets::widget.

◆ font_size() [2/2]

table_view & liblec::lecui::widgets::table_view::font_size ( const float &  font_size)

Set the widget's font size.

Parameters
font_sizeThe font size in points, e.g. 9.0f.
Returns
A reference to the modified object.

◆ get()

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

Get the specifications of a table_view.

Parameters
fmA reference to the form.
pathThe full path to the widget, e.g. "sample_page/sample_pane/debtors".
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.

◆ grid_line() [1/2]

float & liblec::lecui::widgets::table_view::grid_line ( )

Get or set the thickness of the grid-lines.

Returns
A reference to the line thickness, in pixels.

◆ grid_line() [2/2]

table_view & liblec::lecui::widgets::table_view::grid_line ( const float &  grid_line)

Set the thickness of the grid-line.

Parameters
grid_lineThe line thickness, in pixels.
Returns
A reference to the modified object.

◆ on_resize() [1/2]

resize_params & liblec::lecui::widgets::table_view::on_resize ( )
overridevirtual

Get or set the behaviour of the widget when its container is resized.

Returns
A reference to the resize parameters as defined in resize_params.

Implements liblec::lecui::widgets::widget.

◆ on_resize() [2/2]

table_view & liblec::lecui::widgets::table_view::on_resize ( const resize_params on_resize)

Set the behaviour of the widget when its container is resized.

Parameters
on_resizeThe resize parameters as defined in resize_params.
Returns
A reference to the modified object.

◆ operator!=()

bool liblec::lecui::widgets::table_view::operator!= ( const table_view param)

Check whether widget specs are NOT equal. Only those properties that require the widget resources to be re-created are considered.

Parameters
paramThe specs to compare to.
Returns
Returns true if the specs are NOT equal, else false.

◆ operator=()

table_view & liblec::lecui::widgets::table_view::operator= ( const table_view param)

Copy table view specs. Only essential properties are copied.

Parameters
paramThe table view specs to copy.
Returns
Returns a reference to the copy.

◆ operator==()

bool liblec::lecui::widgets::table_view::operator== ( const table_view param)

Check whether widget specs are equal. Only those properties that require the widget resources to be re-created are considered.

Parameters
paramThe specs to compare to.
Returns
Returns true if the specs are equal, else false.

◆ rect() [1/2]

lecui::rect & liblec::lecui::widgets::table_view::rect ( )
overridevirtual

Get or set the position and dimensions of the widget.

Returns
A reference to the widget rectangle.

The position is in reference to the widget's container.

Implements liblec::lecui::widgets::widget.

◆ rect() [2/2]

table_view & liblec::lecui::widgets::table_view::rect ( const lecui::rect rect)

Set the position and dimensions of the widget.

Parameters
rectThe widget's rectangle.
Returns
A reference to the modified object.

◆ scroll_horizontally()

void liblec::lecui::widgets::table_view::scroll_horizontally ( const float &  amount)

Programmatically scroll the table horizontally.

Parameters
amountThe amount of pixels to scroll the table by.

A negative value moves the table to the left; it's equivalent to sliding the horizontal scroll bar towards the right, and vice-versa. If the table has no horizontal scroll bar this method has no effect.

◆ scroll_vertically()

void liblec::lecui::widgets::table_view::scroll_vertically ( const float &  amount)

Programmatically scroll the table vertically.

Parameters
amountThe amount of pixels to scroll the table by.

A negative value moves the table upwards; it's equivalent to sliding the vertical scroll bar downwards, and vice-versa. If the table has no vertical scroll bar this method has no effect.

◆ selected() [1/2]

std::vector< long > & liblec::lecui::widgets::table_view::selected ( )

Get or set the rows to select by default, numbered from 0.

Returns
A reference to the selected rows.

◆ selected() [2/2]

table_view & liblec::lecui::widgets::table_view::selected ( const std::vector< long > &  selected)

Set the rows to select by default, numbered from 0.

Parameters
selectedThe selected rows.
Returns
A reference to the modified object.

◆ text() [1/2]

std::string & liblec::lecui::widgets::table_view::text ( )
overridevirtual

Get or set the widget text.

Returns
A reference to the widget text.

This property is not used.

Implements liblec::lecui::widgets::widget.

◆ text() [2/2]

table_view & liblec::lecui::widgets::table_view::text ( const std::string &  text)

Set the widget's text.

Parameters
textThe text.
Returns
A reference to the modified object.

This property is not used.

◆ tooltip() [1/2]

std::string & liblec::lecui::widgets::table_view::tooltip ( )
overridevirtual

Get or set the widget's tooltip text.

Returns
A reference to the tooltip text.

This property is not used.

Implements liblec::lecui::widgets::widget.

◆ tooltip() [2/2]

table_view & liblec::lecui::widgets::table_view::tooltip ( const std::string &  tooltip)

Set the tooltip text.

Parameters
tooltipThe tooltip text.
Returns
A reference to the modified object.

This property is not used.

◆ user_sort() [1/2]

bool & liblec::lecui::widgets::table_view::user_sort ( )

Get or set whether to allow sorting by clicking columns.

Returns
A reference to the property.

◆ user_sort() [2/2]

table_view & liblec::lecui::widgets::table_view::user_sort ( const bool &  user_sort)

Set whether to allow sorting by clicking columns.

Parameters
user_sortThe property.
Returns
A reference to the modified object.

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