Skip to content

CheckToggle

Bases: CheckButton

bootstack wrapper for ttk.Checkbutton that renders with a ToolButton style

__init__

__init__(master: Master = None, **kwargs)

Create a themed bootstack CheckToggle.

Parameters:

Name Type Description Default
master Master

Parent widget. If None, uses the default root window.

None

Other Parameters:

Name Type Description
text str

Text to display on the toggle.

textvariable Variable

Tk variable linked to the text.

textsignal Signal[str]

Reactive Signal linked to the text (auto-synced with textvariable).

command Callable

Callable invoked when the toggle changes state.

image PhotoImage

Image to display.

icon str | dict

Theme-aware icon spec handled by the style system.

icon_only bool

If True, removes the additional padding reserved for text.

compound str

Placement of the image relative to text.

variable Variable

Linked variable controlling the on/off state.

signal Signal

Reactive Signal controlling the on/off state (auto-synced with variable).

value Any

Initial state for the widget's associated variable (defaults to None when unset).

onvalue Any

Value set in variable when selected.

offvalue Any

Value set in variable when deselected.

padding int | tuple

Extra space around the content.

anchor str

Determines how the content is aligned in the container. Combination of 'n', 's', 'e', 'w', or 'center' (default).

density str

The vertical and horizontal compactness of widget content, e.g. 'default', 'compact'.

width int

Width of the control in characters.

underline int

Index of character to underline in text.

state str

Widget state ('normal', 'active', 'disabled', 'readonly').

takefocus bool

Whether the widget participates in focus traversal.

accent str

Accent token for styling, e.g. 'primary', 'success', 'danger'.

variant str

Style variant (coerced to 'toolbutton').

surface str

Optional surface token; otherwise inherited.

style_options dict

Optional dict forwarded to the style builder.

localize bool | Literal['auto']

Determines the widget's localization mode.