Interactive control widgets receive pointer and keyboard input during the native frame loop and expose one-shot consumable state accessors.
| Method | Description |
|---|
| objects.tuix_button_set_label(obj_ptr, label: str | bytes) -> int | Sets visible button label text. |
| objects.tuix_button_set_border(obj_ptr, visible: bool, r: int, g: int, b: int) -> int | Configures button outline border visibility and RGB color. |
| objects.tuix_button_set_colors(obj_ptr, label_r, label_g, label_b, bg_r, bg_g, bg_b) -> int | Sets label and background RGB colors. |
| objects.tuix_button_set_transparent_background(obj_ptr, transparent: bool) -> int | Toggles transparent background blending into parent container. |
| objects.tuix_button_take_pressed(obj_ptr) -> int | Reads and consumes press state (returns 1 if pressed, 0 otherwise). |
| objects.tuix_button_reset(obj_ptr) -> None | Manually resets pressed state flag. |
| Method | Description |
|---|
| objects.tuix_checkbox_set_label(obj_ptr, label) -> int | Sets checkbox label. |
| objects.tuix_checkbox_set_checked(obj_ptr, checked: bool) -> int | Sets toggle state explicitly. |
| objects.tuix_checkbox_get_checked(obj_ptr) -> int | Returns current checked state (1 for True, 0 for False). |
| objects.tuix_checkbox_toggle(obj_ptr) -> int | Inverts current checked state. |
| objects.tuix_checkbox_take_changed(obj_ptr) -> int | Reads and consumes state change event flag. |
| objects.tuix_checkbox_set_colors(obj_ptr, fg_r, fg_g, fg_b, bg_r, bg_g, bg_b) -> int | Sets foreground and background RGB colors. |
| Method | Description |
|---|
| objects.tuix_choice_set_options(obj_ptr, labels: list) -> int | Sets option labels for choice list. |
| objects.tuix_choice_set_selected(obj_ptr, index: int) -> int | Selects active option index programmatically. |
| objects.tuix_choice_is_confirmed(obj_ptr) -> int | Returns 1 when user confirms selection with Enter, 0 otherwise. |
| objects.tuix_choice_get_result(obj_ptr) -> int | Returns index of confirmed selection. |
| objects.tuix_choice_get_selected(obj_ptr) -> int | Returns currently highlighted option index. |
| objects.tuix_choice_reset(obj_ptr) -> None | Clears confirmed state flag. |
| Widget & Method | Description |
|---|
| objects.tuix_input_set_placeholder(obj, text: str) -> int | Sets placeholder text shown when input field is empty. |
| objects.tuix_input_set_text(obj, text: str | bytes) -> int | Sets live editable text string. |
| objects.tuix_input_set_colors(obj, tr, tg, tb, bgr, bgg, bgb, pr, pg, pb) -> int | Sets text, background, and placeholder RGB colors. |
| objects.tuix_input_is_submitted(obj) -> int | Returns 1 when user submits field with Enter key, 0 otherwise. |
| objects.tuix_input_get_result(obj) -> bytes | Returns submitted text as UTF-8 bytes, or None. |
| objects.tuix_input_clear_submitted(obj) -> None | Clears submission event flag. |
| objects.tuix_menu_set_title(obj, title: str) -> int | Sets header title of the menu container. |
| objects.tuix_menu_set_items(obj, items: list[str]) -> int | Sets array of menu item labels. |
| objects.tuix_menu_take_activated(obj) -> int | Reads and consumes activated item index (returns item index, or -1 if none). |