libt3widget
|
A widget displaying a text. More...
Public Types | |
enum | align_t { ALIGN_LEFT, ALIGN_RIGHT, ALIGN_LEFT_UNDERFLOW, ALIGN_RIGHT_UNDERFLOW, ALIGN_CENTER } |
Constants defining alignments. More... |
Public Member Functions | |
virtual bool | accepts_focus (void) |
Query whether this widget accepts focus. | |
int | get_text_width (void) const |
Retrieve the natural width of the text. | |
label_t (const char *_text) | |
Create a new label_t. | |
virtual bool | process_key (key_t key) |
void | set_accepts_focus (bool _can_focus) |
Set whether this label_t accepts the input focus. | |
void | set_align (align_t _align) |
Set the alignment. | |
virtual void | set_focus (focus_t _focus) |
virtual bool | set_size (optint height, optint width) |
void | set_text (const char *_text) |
Set the text. | |
virtual void | update_contents (void) |
![]() | |
virtual void | force_redraw (void) |
virtual void | hide (void) |
virtual bool | is_enabled (void) |
Query the enabled status of this widget. | |
virtual bool | is_hotkey (key_t key) |
Query whether key is a hotkey for this widget. | |
virtual bool | is_shown (void) |
Query the visibility status of this widget. | |
virtual bool | process_mouse_event (mouse_event_t event) |
Process a mouse event. | |
virtual void | set_anchor (window_component_t *anchor, int relation) |
Set this widget's anchor. | |
virtual void | set_enabled (bool enable) |
Set the enabled status of this widget. | |
virtual void | set_position (optint top, optint left) |
virtual void | show (void) |
![]() | |
virtual void | force_redraw (void)=0 |
Request that this window_component_t be completely redrawn. | |
virtual t3_window_t * | get_base_window (void) |
Retrieve the t3_window_t for this window_component_t. | |
virtual void | hide (void)=0 |
Hide the window_component_t. | |
virtual bool | process_key (key_t key)=0 |
Handle a key press by the user. | |
virtual void | set_focus (focus_t focus)=0 |
Set whether this window_component_t has the input focus. | |
virtual void | set_position (optint top, optint left)=0 |
Move the window_component_t to a specified position. | |
virtual bool | set_size (optint height, optint width)=0 |
Set the size of this window_component_t. | |
virtual void | show (void)=0 |
Display the window_component_t. | |
virtual void | update_contents (void)=0 |
Update the contents of the window. | |
window_component_t (void) | |
Base constructor. | |
virtual | ~window_component_t (void) |
Base destructor. | |
![]() | |
void | grab_mouse (void) |
Grab all future mouse events. | |
void | register_mouse_target (t3_window_t *target) |
Register a window to receive mouse events. | |
void | release_mouse_grab (void) |
Release a previous mouse grab. | |
void | unregister_mouse_target (t3_window_t *target) |
Unregister a window to receive mouse events. |
Additional Inherited Members | |
![]() | |
static bool | handle_mouse_event (mouse_event_t event) |
![]() | |
void | init_unbacked_window (int height, int width, bool register_as_mouse_target=false) |
Initialize the window with an unbacked t3_window_t with height and width . | |
void | init_window (int height, int width, bool register_as_mouse_target=true) |
Initialize the window with a t3_window_t with height and width . | |
widget_t (int height, int width, bool register_as_mouse_target=true) | |
Constructor which creates a default t3_window_t with height and width . | |
widget_t (void) | |
Constructor which does not create a default t3_window_t. | |
![]() | |
bool | enabled |
Widget is enabled. | |
bool | redraw |
Widget requires redrawing on next update_contents call. | |
bool | shown |
Widget is shown. |
A widget displaying a text.
This widget can display a text. An alignment can be specified. For displaying labels for checkboxes and text fields, see smart_label_t.
Constants defining alignments.
ALIGN_LEFT |
Align text to the left of the allocated space. |
ALIGN_RIGHT |
Align text to the right of the allocated space. |
ALIGN_LEFT_UNDERFLOW |
Align text to the left of the allocated space, with underflow indicator. Similar to ALIGN_LEFT, but if the allocated space is too small, the text is cut off on the left instead of the right and the first two visible characters of text are replaced by "..". |
ALIGN_RIGHT_UNDERFLOW |
Align text to the right of the allocated space, with underflow indicator. Similar to ALIGN_RIGHT, but if the allocated space is too small, the first two visible characters of text are replaced by "..". |
ALIGN_CENTER |
Center text in the allocated space. |
t3_widget::label_t::label_t | ( | const char * | _text | ) |
Create a new label_t.
|
virtual |
Query whether this widget accepts focus.
Reimplemented from t3_widget::widget_t.
int t3_widget::label_t::get_text_width | ( | void | ) | const |
Retrieve the natural width of the text.
void t3_widget::label_t::set_accepts_focus | ( | bool | _can_focus | ) |
Set whether this label_t accepts the input focus.
void t3_widget::label_t::set_align | ( | label_t::align_t | _align | ) |
Set the alignment.
void t3_widget::label_t::set_text | ( | const char * | _text | ) |
Set the text.