Modules | |
| Progress bar widget options | |
| These options can be ORed together to specify the behaviour of a progress bar widget when creating it with wtk_progress_bar_create. | |
Data Structures | |
| struct | wtk_progress_bar |
| Progress bar control struct. More... | |
Functions | |
| struct win_window * | wtk_progress_bar_as_child (struct wtk_progress_bar *bar) |
| Get pointer to progress bar window. More... | |
| struct wtk_progress_bar * | wtk_progress_bar_create (struct win_window *parent, struct win_area const *area, uint8_t maximum, uint8_t value, gfx_color_t fill_color, gfx_color_t background_color, uint8_t option) |
| Create a new progress bar widget. More... | |
| uint8_t | wtk_progress_bar_get_value (struct wtk_progress_bar *bar) |
| Get progress bar value. More... | |
| void | wtk_progress_bar_set_colors (struct wtk_progress_bar *bar, gfx_color_t color1, gfx_color_t color2) |
| Set new progress bar colors. More... | |
| bool | wtk_progress_bar_set_value (struct wtk_progress_bar *bar, uint8_t value) |
| Set new progress bar value. More... | |
| #define | WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
| Color of the progress bar's frame border. More... | |
| #define | WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
| Color of the progress bar's frame border. More... | |
| #define | WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
| Color of the progress bar's frame border. More... | |
| #define | WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
| Color of the progress bar's frame border. More... | |
| #define | WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
| Color of the progress bar's frame border. More... | |
| static bool | wtk_progress_bar_handler (struct win_window *win, enum win_event_type type, void const *data) |
| Progress bar event handler. More... | |
| #define WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
Color of the progress bar's frame border.
Referenced by wtk_progress_bar_handler().
| #define WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
Color of the progress bar's frame border.
| #define WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
Color of the progress bar's frame border.
| #define WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
Color of the progress bar's frame border.
| #define WTK_PROGRESS_BAR_BORDER_COLOR GFX_COLOR_BLACK |
Color of the progress bar's frame border.
| struct win_window* wtk_progress_bar_as_child | ( | struct wtk_progress_bar * | bar | ) |
Get pointer to progress bar window.
Returns a reference to the window that should be used when managing the widget, such as destroying, moving or reparenting it.
| bar | Pointer to wtk_progress_bar struct to manage. |
References Assert, and wtk_progress_bar::container.
Referenced by app_widget_launch(), and app_widget_update_colors().
| struct wtk_progress_bar* wtk_progress_bar_create | ( | struct win_window * | parent, |
| struct win_area const * | area, | ||
| uint8_t | maximum, | ||
| uint8_t | value, | ||
| gfx_color_t | fill_color, | ||
| gfx_color_t | background_color, | ||
| uint8_t | option | ||
| ) |
Create a new progress bar widget.
Allocates the necessary memory and intializes the window and data for progress bar widgets. If there is not enough memory, the function returns NULL.
To destroy a progress bar widget and all its contents, and free its memory, call win_destroy() on the progress bar's child reference, given by wtk_progress_bar_as_child(), like this: "win_destroy(wtk_progress_bar_as_child(my_progress_bar_ptr));".
Progress bar widgets divide their window area in two non-overlapping rectangles: one with a fill color, and one with a background color. The ratio between the two rectangles' sizes is given by the progress bar's value relative to its maximum: a higher value gives a larger fill.
By default, a vertically oriented progress bar fills from the top, while a horizontal one fills from the left. The progress bar's orientation and fill direction can both be configured at the time of creation. The fill and background colors can be changed at runtime.
Refer to <gfx/wtk.h> for available configuration options.
| parent | Pointer to parent win_window struct. |
| area | Pointer to win_area struct with position and size of the progress bar. Minimum size in both x and y direction is 3 pixels. |
| maximum | Maximum value of the progress bar. |
| value | Initial value of the progress bar. |
| fill_color | Color for filled area. |
| background_color | Color for background area. |
| option | Configuration options for progress bar. |
References win_attributes::area, Assert, win_attributes::background, wtk_progress_bar::background_color, win_attributes::behavior, wtk_progress_bar::container, win_attributes::custom, win_attributes::event_handler, wtk_progress_bar::fill_color, wtk_progress_bar::maximum, membag_alloc(), membag_free(), NULL, wtk_progress_bar::option, wtk_progress_bar::position, win_area::size, wtk_progress_bar::value, win_create(), wtk_progress_bar_handler(), WTK_PROGRESS_BAR_INVERT, WTK_PROGRESS_BAR_VERTICAL, wtk_rescale_value(), win_point::x, and win_point::y.
Referenced by app_widget_launch().
| uint8_t wtk_progress_bar_get_value | ( | struct wtk_progress_bar * | bar | ) |
Get progress bar value.
| bar | Pointer to wtk_progress_bar struct to get value from. |
References Assert, and wtk_progress_bar::value.
|
static |
Progress bar event handler.
This is the window event handler for progress bar widgets. It handles the two relevant event types sent to a progress bar's container window, i.e., drawing, and destroy events.
| win | Window receiving the event. |
| type | The event type. |
| data | Custom data, depending on event type. |
References Assert, wtk_progress_bar::background_color, wtk_progress_bar::container, wtk_progress_bar::fill_color, gfx_draw_filled_rect, gfx_draw_rect, membag_free(), wtk_progress_bar::option, win_clip_region::origin, wtk_progress_bar::position, win_area::size, WIN_EVENT_DESTROY, WIN_EVENT_DRAW, win_get_area(), win_get_custom_data(), WTK_PROGRESS_BAR_BORDER_COLOR, WTK_PROGRESS_BAR_VERTICAL, win_point::x, and win_point::y.
Referenced by wtk_progress_bar_create().
| void wtk_progress_bar_set_colors | ( | struct wtk_progress_bar * | bar, |
| gfx_color_t | fill_color, | ||
| gfx_color_t | background_color | ||
| ) |
Set new progress bar colors.
This sets new fill and background colors for the progress bar. If the bar is inverted, the two colors are switched.
| bar | Pointer to wtk_progress_bar struct to set colors for. |
| fill_color | Fill color to set for progress bar. |
| background_color | Background color to set for progress bar. |
References Assert, wtk_progress_bar::background_color, wtk_progress_bar::fill_color, wtk_progress_bar::option, and WTK_PROGRESS_BAR_INVERT.
Referenced by app_widget_update_colors().
| bool wtk_progress_bar_set_value | ( | struct wtk_progress_bar * | bar, |
| uint8_t | value | ||
| ) |
Set new progress bar value.
Updates the current value and issues a redrawing of the progress bar if its value was indeed changed. In this case, a new end position for the progress bar's fill area is also computed.
| bar | Pointer to wtk_progress_bar struct to set new value for. |
| value | New value for the progress bar. |
References Assert, wtk_progress_bar::container, wtk_progress_bar::maximum, wtk_progress_bar::option, wtk_progress_bar::position, win_area::size, wtk_progress_bar::value, win_get_area(), win_redraw(), WTK_PROGRESS_BAR_INVERT, WTK_PROGRESS_BAR_VERTICAL, wtk_rescale_value(), win_point::x, and win_point::y.
Referenced by widget_frame_command_handler().
1.8.5