Dokumentace modulu ui_radiobuttons.py

Účel modulu

Modul obstarává:

• vytvoření 8 řádků radiobuttonů
• každý řádek má 4 volby (DisCharge, DisChrgSyn, Charge, Reset)
• zpracování událostí při jejich změně
• možnost předat callback funkci z hlavního programu
• barevné změny obdélníků podle zvoleného režimu
• globální ukládání hodnot radiobuttonů

Přehled funkcí

1) create_radio_buttons(root)

Vytvoří matici 8 řádků × 4 radiobuttonů. Každý radiobutton reprezentuje volbu režimu:

• 1 – DisCharge
• 2 – DisChrgSyn
• 3 – Charge
• 4 – Reset

Funkce vrací dvojici:

• radio_vars – seznam proměnných IntVar pro každý řádek
• radio_buttons – seznam vytvořených widgetů

Radiobuttony automaticky volají callback on_radio_change().

2) on_radio_change(row, value)

Funkce se spustí pokaždé, když uživatel změní radiobutton. Informuje hlavní aplikaci o změně volbou callbacku:

Hlavní aplikace pak provede logiku:

• změní barvu obdélníku pro daný řádek
• nastaví příznaky user_changed_radio / not_user_changed_radio
• aktivuje tlačítko Send

3) set_callback(func)

Umožní hlavní aplikaci předat svoji funkci, která bude volána při změně radiobuttonu. Velmi důležité pro propojení GUI s logikou a BLE komunikací.

4) get_radio_values()

Vrátí aktuální stav radiobuttonů jako seznam osmi hodnot (1–4).

5) select_fourth_in_all_rows()

Pomocná funkce nastaví ve všech osmi řádcích volbu Reset (4). Používá se při inicializaci GUI.

Spolupráce s modulem ui_rectangles

Po změně radiobuttonu se pomocí:

obarví příslušný obdélník do barvy odpovídající zvolenému režimu:

• DisCharge → žlutá
• DisChrgSyn → oranžová
• Charge → zelená
• Reset → světle šedá

Tím je vizuálně jasné, který kanál je v jakém stavu.

Příklad použití v hlavním programu

V hlavní aplikaci se modul inicializuje takto:

Po zavolání on_radio_change se zavolá funkce radio_event_handler() z main.py, která zajistí:

• úpravu barvy obdélníku
• aktivaci tlačítka Send
• nastavení uživatelských stavových flagů