Functions
struct win_window *	wtk_check_box_as_child (struct wtk_check_box *check_box)
	This function returns a reference to the window that should be used when managing the widget, such as move, resize, destroy and reparenting. More...

struct wtk_check_box *	wtk_check_box_create (struct win_window parent, struct win_area const area, char const *caption, bool selected, win_command_t command_data)
	This function creates a new check box widget. More...

win_command_t	wtk_check_box_get_command (struct wtk_check_box *check_box)
	This function returns the window command of the specified check box, as set when the widget was created. More...

bool	wtk_check_box_is_selected (struct wtk_check_box const *check_box)
	This function returns true if the check box is selected. More...

void	wtk_check_box_set (struct wtk_check_box *check_box, bool selected)
	This function sets the value of the check box according to the "selected" parameter. More...

void	wtk_check_box_size_hint (struct win_point size, const char caption)
	Get minimum widget size. More...

void	wtk_check_box_toggle (struct wtk_check_box *check_box)
	This function toggles the value of a check box. More...

enum	wtk_check_box_state { WTK_CHECKBOX_NORMAL, WTK_CHECKBOX_PRESSED }
	Valid states for check box, relevant to pointer and keyboard operations. More...

static bool	wtk_check_box_handler (struct win_window win, enum win_event_type type, void const data)
	This function is the window event handler for check box widgets. More...

enum wtk_check_box_state

Valid states for check box, relevant to pointer and keyboard operations.

Enumerator
WTK_CHECKBOX_NORMAL	Normal state, no highlight or press.
WTK_CHECKBOX_PRESSED	Widget pressed, action occurs when released.

struct win_window* wtk_check_box_as_child ( struct wtk_check_box * check_box )

This function returns a reference to the window that should be used when managing the widget, such as move, resize, destroy and reparenting.

Parameters

check_box Check box widget to manage.

Returns: Window to be used for managing the check box.

References Assert, and wtk_check_box::container.

struct wtk_check_box* wtk_check_box_create	(	struct win_window *	parent,
		struct win_area const *	area,
		char const *	caption,
		bool	selected,
		win_command_t	command
	)

This function creates a new check box widget.

It allocates required memory and intializes necessary windows to create the widget. If there is not enough memory, the function returns NULL.

To destroy the widget and all its contents, and free its memory, call win_destroy() on the check box' child reference, given by wtk_check_box_as_child(), like this: "win_destroy(wtk_check_box_as_child(my_check_box_ptr));". Usually it will be destroyed automatically when it's parent is destroyed.

Parameters

parent	Parent window, possibly wtk_frame_as_parent(my_frame_ptr).
area	Area of the internal contents.
caption	Pointer to caption string. Will be copied into widget.
selected	Initial state of check box, true if checked/selected.
command	Command to send to parent window. Must be non-zero to be enabled.

Returns: Pointer to check box, or NULL if failed.

References win_attributes::area, Assert, win_attributes::background, win_attributes::behavior, wtk_check_box::caption, wtk_check_box::command, wtk_check_box::container, win_attributes::custom, win_attributes::event_handler, membag_alloc(), membag_free(), NULL, wtk_check_box::selected, wtk_check_box::state, WIN_BEHAVIOR_REDRAW_PARENT, win_create(), wtk_check_box_handler(), WTK_CHECKBOX_NORMAL, and wtk_copy_string().

win_command_t wtk_check_box_get_command ( struct wtk_check_box * check_box )

This function returns the window command of the specified check box, as set when the widget was created.

Parameters

check_box Check box widget to manage.

Returns: Associated window command of the check box widget.

References Assert, and wtk_check_box::command.

static bool wtk_check_box_handler	(	struct win_window *	win,
		enum win_event_type	type,
		void const *	data
	)

static

This function is the window event handler for check box widgets.

It handles all events sent to the windows composing the widget.

Parameters

win	Window receiving the event.
type	The event type.
data	Custom data, depending on event type.

Returns: True if the event was recognized and accepted.

References Assert, wtk_check_box::caption, wtk_check_box::command, wtk_check_box::container, win_command_event::data, GFX_COLOR_TRANSPARENT, gfx_draw_filled_rect, gfx_draw_rect, gfx_draw_string(), membag_free(), NULL, win_clip_region::origin, win_command_event::recipient, wtk_check_box::selected, win_command_event::sender, wtk_check_box::state, sysfont, WIN_EVENT_DESTROY, WIN_EVENT_DRAW, WIN_EVENT_POINTER, win_get_custom_data(), win_grab_pointer(), win_is_inside_window(), WIN_POINTER_PRESS, WIN_POINTER_RELEASE, win_queue_command_event(), win_redraw(), wtk_check_box_toggle(), WTK_CHECKBOX_NORMAL, WTK_CHECKBOX_PRESSED, win_point::x, and win_point::y.

Referenced by wtk_check_box_create().

bool wtk_check_box_is_selected ( struct wtk_check_box const * check_box )

This function returns true if the check box is selected.

Returns: True if check box is selected.

References Assert, and wtk_check_box::selected.

void wtk_check_box_set	(	struct wtk_check_box *	check_box,
		bool	selected
	)

This function sets the value of the check box according to the "selected" parameter.

The graphics will be updated if the box is visible.

Parameters

check_box	Check box to update.
selected	Value to set for checkbox. True if check box is selected, false otherwise

References Assert, wtk_check_box::container, wtk_check_box::selected, and win_redraw().

void wtk_check_box_size_hint	(	struct win_point *	size,
		const char *	caption
	)

Get minimum widget size.

This function returns the minimum size that is required for showing the full widget and the caption.

Return values

size	Suggested size for the widget

Parameters

caption Pointer to caption string to use for widget.

References Assert, gfx_get_string_bounding_box(), sysfont, win_point::x, and win_point::y.

void wtk_check_box_toggle ( struct wtk_check_box * check_box )

This function toggles the value of a check box.

If it is not selected, it will be set to a selected/checked state, and vice versa. The graphics will be updated if the box is visible.

Parameters

check_box Check box to toggle.

References Assert, wtk_check_box::container, wtk_check_box::selected, and win_redraw().

Referenced by wtk_check_box_handler().

Microchip® Advanced Software Framework

Functions