simvx.core.ui.tabs

TabContainer – tabbed panel container.

Each child Control is a tab page. The tab title is taken from child.name. Only the active tab’s child is drawn and receives layout.

Module Contents

Classes

TabContainer

Tabbed container where each child is a tab page.

Data

API

simvx.core.ui.tabs.log[source]

‘getLogger(…)’

simvx.core.ui.tabs.__all__

[‘TabContainer’]

class simvx.core.ui.tabs.TabContainer(**kwargs)[source]

Bases: simvx.core.ui.containers.Container

Tabbed container where each child is a tab page.

Tab titles are derived from each child’s name attribute. Clicking a tab header switches the visible page.

Example: tabs = TabContainer() page1 = Control(name=”Settings”) page2 = Control(name=”Debug”) tabs.add_child(page1) tabs.add_child(page2) tabs.tab_changed.connect(lambda idx: print(f”Tab {idx}”))

Initialization

current_tab

‘Property(…)’

tab_height

‘Property(…)’

tab_bg_colour

‘ThemeColour(…)’

tab_active_colour

‘ThemeColour(…)’

tab_hover_colour

‘ThemeColour(…)’

tab_text_colour

‘ThemeColour(…)’

tab_active_text_colour

‘ThemeColour(…)’

border_colour

‘ThemeColour(…)’

style_tab_normal

‘ThemeStyleBox(…)’

style_tab_active

‘ThemeStyleBox(…)’

style_tab_hover

‘ThemeStyleBox(…)’

set_tab_colour(index: int, colour: tuple | None)[source]

Set an override background colour for a specific tab (None to clear).

clear_tab_colour(index: int)[source]

Remove the override colour for a tab.

set_tab_text_colour(index: int, colour: tuple | None)[source]

Set an override text colour for a specific tab (None to clear).

clear_tab_text_colour(index: int)[source]

Remove the override text colour for a tab.

flash_tab(index: int, colour: tuple, duration: float = 1.0)[source]

Temporarily set a tab colour that auto-clears after duration seconds.

process(dt: float)[source]

Tick flash timers and update layout.

get_minimum_size() simvx.core.math.types.Vec2[source]
draw(renderer)[source]
separation

‘Property(…)’

ready()
add_child(node)
remove_child(node)
mark_layout_dirty()
size_x

‘Property(…)’

size_y

‘Property(…)’

property size: simvx.core.math.types.Vec2
touch_mode: str

‘mouse’

property theme: simvx.core.ui.types.Theme | None
property mouse_over: bool
property focused: bool
property disabled: bool
get_theme() simvx.core.ui.types.Theme
queue_redraw()
get_rect() tuple[float, float, float, float]
get_global_rect() tuple[float, float, float, float]
is_point_inside(point) bool
set_anchor_preset(preset: simvx.core.ui.enums.AnchorPreset)
set_focus()
grab_focus()
release_focus()
has_focus() bool
focus_next_control()
focus_previous_control()
grab_mouse()
release_mouse()
set_drag_preview(control: simvx.core.ui.core.Control)
draw_popup(renderer)
is_popup_point_inside(point) bool
popup_input(event)
dismiss_popup()
z_index

‘Property(…)’

z_as_relative

‘Property(…)’

render_layer

‘Property(…)’

set_render_layer(index: int, enabled: bool = True) None
is_on_render_layer(index: int) bool
property absolute_z_index: int
property position: simvx.core.math.types.Vec2
property rotation: float
property rotation_degrees: float
property scale: simvx.core.math.types.Vec2
property world_position: simvx.core.math.types.Vec2
property world_rotation: float
property world_scale: simvx.core.math.types.Vec2
property forward: simvx.core.math.types.Vec2
property right: simvx.core.math.types.Vec2
translate(offset: tuple[float, float] | numpy.ndarray)
rotate(radians: float)
rotate_deg(degrees: float)
look_at(target: tuple[float, float] | numpy.ndarray)
transform_points(points: list[simvx.core.math.types.Vec2]) list[simvx.core.math.types.Vec2]
draw_polygon(renderer, points: list[simvx.core.math.types.Vec2], closed=True, colour=None)
wrap_screen(margin: float = 20)
strict_errors: ClassVar[bool]

True

script_error_raised

‘Signal(…)’

classmethod __init_subclass__(**kwargs)
property name: str
property process_mode: simvx.core.descriptors.ProcessMode
reset_error() None
reparent(new_parent: simvx.core.node.Node)
get_node(path: str) simvx.core.node.Node
find_child(name: str, recursive: bool = False) simvx.core.node.Node | None
find(node_type: type, recursive: bool = True) simvx.core.node.Node | None
find_all(node_type: type, recursive: bool = True) list
property path: str
add_to_group(group: str)
remove_from_group(group: str)
is_in_group(group: str) bool
enter_tree() None
exit_tree() None
physics_process(dt: float) None
input_event(event: simvx.core.events.InputEvent) None
input(event: simvx.core.events.TreeInputEvent) None
unhandled_input(event: simvx.core.events.TreeInputEvent) None
start_coroutine(gen: simvx.core.descriptors.Coroutine) simvx.core.descriptors.CoroutineHandle
stop_coroutine(gen_or_handle)
clear_children()
destroy()
property app
property tree: simvx.core.scene_tree.SceneTree
get_tree() simvx.core.scene_tree.SceneTree
__getitem__(key: str)
classmethod get_properties() dict[str, simvx.core.descriptors.Property]
__repr__()