EJIO.ctk_extender.widget package

Subpackages

• EJIO.ctk_extender.widget.components package
  • Submodules
  • EJIO.ctk_extender.widget.components.button module
    • Button
      • Button.build()
  • EJIO.ctk_extender.widget.components.label module
    • Label
      • Label.build()
  • EJIO.ctk_extender.widget.components.progress module
    • ProgressBar
      • ProgressBar.build()
  • EJIO.ctk_extender.widget.components.scrollable module
    • ScrollableFrame
      • ScrollableFrame.build()
  • EJIO.ctk_extender.widget.components.tabview module
    • Tabview
      • Tabview.add_widget_to_tab()
      • Tabview.build()
  • Module contents
    • Button
      • Button.build()
    • Label
      • Label.build()
    • ProgressBar
      • ProgressBar.build()
    • ScrollableFrame
      • ScrollableFrame.build()
    • Tabview
      • Tabview.add_widget_to_tab()
      • Tabview.build()
• EJIO.ctk_extender.widget.form package
  • Subpackages
    • EJIO.ctk_extender.widget.form.fields package
      • Submodules
      • EJIO.ctk_extender.widget.form.fields.base module
      • EJIO.ctk_extender.widget.form.fields.checkbox module
      • EJIO.ctk_extender.widget.form.fields.combobox module
      • EJIO.ctk_extender.widget.form.fields.directory module
      • EJIO.ctk_extender.widget.form.fields.file module
      • EJIO.ctk_extender.widget.form.fields.option_menu module
      • EJIO.ctk_extender.widget.form.fields.radio module
      • EJIO.ctk_extender.widget.form.fields.segmented module
      • EJIO.ctk_extender.widget.form.fields.slider module
      • EJIO.ctk_extender.widget.form.fields.switch module
      • EJIO.ctk_extender.widget.form.fields.text module
      • EJIO.ctk_extender.widget.form.fields.textbox module
      • Module contents
  • Submodules
  • EJIO.ctk_extender.widget.form.base module
    • Form
      • Form.add_widget()
      • Form.clear()
      • Form.destroy()
      • Form.focus_field()
      • Form.get_data()
      • Form.remove_widget()
      • Form.set_data()
      • Form.submit()
  • EJIO.ctk_extender.widget.form.events module
    • FormReadyEvent
      • FormReadyEvent.target_form
    • FormSubmittedEvent
      • FormSubmittedEvent.data
    • FormValidationErrorEvent
      • FormValidationErrorEvent.errors
  • Module contents
    • Form
      • Form.add_widget()
      • Form.clear()
      • Form.destroy()
      • Form.focus_field()
      • Form.get_data()
      • Form.remove_widget()
      • Form.set_data()
      • Form.submit()
    • FormCheckBox
      • FormCheckBox.build()
      • FormCheckBox.clear()
      • FormCheckBox.get_value()
      • FormCheckBox.name
      • FormCheckBox.set_value()
    • FormComboBox
      • FormComboBox.build()
      • FormComboBox.clear()
      • FormComboBox.get_value()
      • FormComboBox.name
      • FormComboBox.set_value()
    • FormDirectoryField
      • FormDirectoryField.build()
      • FormDirectoryField.clear()
      • FormDirectoryField.get_value()
      • FormDirectoryField.name
      • FormDirectoryField.set_value()
      • FormDirectoryField.validate()
    • FormFileField
      • FormFileField.build()
      • FormFileField.clear()
      • FormFileField.get_value()
      • FormFileField.name
      • FormFileField.set_value()
      • FormFileField.validate()
    • FormOptionMenuField
      • FormOptionMenuField.build()
      • FormOptionMenuField.clear()
      • FormOptionMenuField.destroy()
      • FormOptionMenuField.get_value()
      • FormOptionMenuField.name
      • FormOptionMenuField.set_value()
      • FormOptionMenuField.validate()
    • FormRadioButtonGroup
      • FormRadioButtonGroup.build()
      • FormRadioButtonGroup.clear()
      • FormRadioButtonGroup.destroy()
      • FormRadioButtonGroup.get_value()
      • FormRadioButtonGroup.name
      • FormRadioButtonGroup.set_value()
    • FormReadyEvent
      • FormReadyEvent.target_form
    • FormSegmentedButton
      • FormSegmentedButton.build()
      • FormSegmentedButton.clear()
      • FormSegmentedButton.get_value()
      • FormSegmentedButton.name
      • FormSegmentedButton.set_value()
    • FormSlider
      • FormSlider.build()
      • FormSlider.clear()
      • FormSlider.get_value()
      • FormSlider.name
      • FormSlider.set_value()
    • FormSubmittedEvent
      • FormSubmittedEvent.data
    • FormSwitch
      • FormSwitch.build()
      • FormSwitch.clear()
      • FormSwitch.get_value()
      • FormSwitch.name
      • FormSwitch.set_value()
    • FormTextBox
      • FormTextBox.build()
      • FormTextBox.clear()
      • FormTextBox.get_value()
      • FormTextBox.name
      • FormTextBox.set_value()
      • FormTextBox.validate()
    • FormTextField
      • FormTextField.build()
      • FormTextField.clear()
      • FormTextField.get_value()
      • FormTextField.name
      • FormTextField.set_value()
      • FormTextField.validate()
    • FormValidationErrorEvent
      • FormValidationErrorEvent.errors
    • InputField
      • InputField.clear()
      • InputField.get_value()
      • InputField.name
      • InputField.set_value()
      • InputField.validate()
• EJIO.ctk_extender.widget.geometry package
  • Submodules
  • EJIO.ctk_extender.widget.geometry.base module
    • GeometryStrategy
      • GeometryStrategy.mount()
      • GeometryStrategy.unmount()
  • EJIO.ctk_extender.widget.geometry.implementations module
    • GridStrategy
      • GridStrategy.mount()
      • GridStrategy.unmount()
    • PackStrategy
      • PackStrategy.mount()
      • PackStrategy.unmount()
    • PlaceStrategy
      • PlaceStrategy.mount()
      • PlaceStrategy.unmount()
  • Module contents
    • GeometryStrategy
      • GeometryStrategy.mount()
      • GeometryStrategy.unmount()
    • GridStrategy
      • GridStrategy.mount()
      • GridStrategy.unmount()
    • PackStrategy
      • PackStrategy.mount()
      • PackStrategy.unmount()
    • PlaceStrategy
      • PlaceStrategy.mount()
      • PlaceStrategy.unmount()

Submodules

EJIO.ctk_extender.widget.base module

class EJIO.ctk_extender.widget.base.Widget(parent: <MagicMock name = 'mock.CTk.__or__().__or__().__or__()' id='140416956849216'>, geometry: GeometryStrategy | None = None, **kwargs: Any)

Базовые классы: ABC

Базовый абстрактный класс для всех элементов интерфейса ctk_extender. Автоматически управляет жизненным циклом, геометрией и декларативными подписками на события.

abstractmethod build() → <MagicMock name='mock.CTkBaseClass' id='140416957414240'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

property ctk_instance: <MagicMock name='mock.CTkBaseClass' id='140416957414240'>

Возвращает ссылку на реальный объект customtkinter.

Исключение:

WidgetNotInitializedError – Если инстанс не инициализирован.

destroy() → None

Полностью уничтожает виджет, очищая память и удаляя его глобальные подписки.

focus() → None

Переводит фокус ввода операционной системы на данный виджет.

mount() → Self

Размещает виджет на родительском контейнере в соответствии с заданным методом геометрии.

property parent: Any

Возвращает родительский контейнер виджета.

set_geometry(geometry: GeometryStrategy) → Self

Позволяет динамически на лету переключить менеджер разметки виджета (например, перекинуть его из pack в grid без пересоздания объекта).

Параметры:

geometry – Объект стратегии геометрии.

unmount() → Self

Скрывает виджет с экрана, извлекая его из менеджера геометрии, но сохраняя состояние объекта в памяти.

EJIO.ctk_extender.widget.container module

class EJIO.ctk_extender.widget.container.WidgetContainer(parent: <MagicMock name = 'mock.CTk.__or__().__or__().__or__()' id='140416956849216'>, geometry: GeometryStrategy | None = None)

Базовые классы: Widget

Компонент-контейнер, объединяющий несколько виджетов внутри единого фрейма (CTkFrame). Автоматически каскадно управляет жизненным циклом и уничтожением всех дочерних элементов.

add_widget(widget_cls: type[W], *args: Any, **kwargs: Any) → W

Фабричный метод для динамического создания и добавления виджета внутрь контейнера. Автоматически передает ctk_instance текущего контейнера в качестве родителя.

Параметры:

• widget_cls – Класс создаваемого виджета (наследник Widget).

• args – Позиционные аргументы для конструктора виджета.

• kwargs – Именованные аргументы для конструктора виджета.

Результат:

Созданный экземпляр виджета.

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>

Строит базовый контейнерный фрейм. Может быть переопределен в дочерних классах (например, для настройки бордеров или цвета).

property children: List[Widget]

Возвращает список всех дочерних виджетов в контейнере.

destroy() → None

Каскадно уничтожает сам контейнер и все вложенные в него дочерние виджеты, полностью очищая оперативную память.

remove_widget(widget: W) → Self

Удаляет виджет из контейнера и уничтожает его ресурсы.

Параметры:

widget – Экземпляр уничтожаемого виджета.

EJIO.ctk_extender.widget.err module

exception EJIO.ctk_extender.widget.err.CtkExtenderWidgetContainerError(message: str)

Базовые классы: CtkExtenderWidgetError

Базовое исключение связанное с ошибками в WidgetContainer.

exception EJIO.ctk_extender.widget.err.CtkExtenderWidgetError(message: str)

Базовые классы: CtkExtenderBaseError

Базовое исключение пакента widget пакета ctk_extender.

exception EJIO.ctk_extender.widget.err.WidgetContainerExtensionError(message: str)

Базовые классы: CtkExtenderWidgetContainerError

Исключение связанное с ошибкой добавления виджета в WidgetContainer.

exception EJIO.ctk_extender.widget.err.WidgetMountError(message: str)

Базовые классы: CtkExtenderWidgetError

Исключение связанное с ошибками монтирования виджета.

exception EJIO.ctk_extender.widget.err.WidgetNotInitializedError(message: str)

Базовые классы: CtkExtenderWidgetError

Исключение связанное с ошибками инициализации виджета.

Module contents

class EJIO.ctk_extender.widget.Button(parent: Any, text: str = 'Button', command: Callable[[], None] | None = None, geometry: GeometryStrategy | None = None, **kwargs: Any)

Базовые классы: Widget

Компонент интерактивной кнопки (на базе ctk.CTkButton).

build() → <MagicMock name='mock.CTkButton' id='140416955843792'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

class EJIO.ctk_extender.widget.Form(parent: <MagicMock name = 'mock.CTk.__or__().__or__()' id='140416957553632'>, geometry: Any = None)

Базовые классы: WidgetContainer

Специализированный контейнер для группировки элементов ввода. Автоматически собирает данные, проводит сквозную валидацию и очистку полей.

add_widget(widget_cls: type[W], *args: Any, **kwargs: Any) → W

Переопределенный метод добавления виджета. Если добавляемый виджет является полем ввода, регистрирует его в форме.

Параметры:

• widget_cls – Класс создаваемого виджета (наследник Widget).

• args – Позиционные аргументы для конструктора виджета.

• kwargs – Именованные аргументы для конструктора виджета.

Результат:

Созданный экземпляр виджета.

clear() → Self

Сбрасывает значения всех полей формы.

destroy() → None

Очищает реестр полей ввода и каскадно уничтожает контейнер.

focus_field(name: str) → None

Переводит фокус ввода на указанное поле формы по его имени. Безопасно извлекает внутренний инпут и запрашивает фокус у ОС.

Параметры:

name – Имя поля на которое нужно переключиться.

get_data() → dict[str, Any]

Собирает текущие данные со всех зарегистрированных полей ввода.

Результат:

Словарь, содержащий данные всех полей ввода в формате имя поля -> значение.

remove_widget(widget: W) → Self

Удаляет виджет из формы, синхронно вычищая его из реестра полей ввода и каскадно уничтожая его ресурсы.

Параметры:

widget – Экземпляр уничтожаемого виджета.

set_data(data: dict[str, Any]) → Self

Заполняет поля формы переданным словарем данных.

submit() → bool

Запускает процесс валидации и отправки формы. Генерирует FormSubmittedEvent при успехе или FormValidationErrorEvent при ошибке.

Результат:

True, если валидация успешна, иначе False.

class EJIO.ctk_extender.widget.FormCheckBox(parent: Any, name: str, text: str = '', geometry: GeometryStrategy | None = None)

Базовые классы: Widget, InputField

Флажок (чекбокс) для формы (на базе ctk.CTkCheckBox).

build() → <MagicMock name='mock.CTkCheckBox' id='140416955675040'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

clear() → None

Сброс значения поля в дефолтное состояние.

get_value() → bool

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

class EJIO.ctk_extender.widget.FormComboBox(parent: Any, name: str, values: list[str], geometry: GeometryStrategy | None = None)

Базовые классы: Widget, InputField

Выпадающий список (комбобокс) для формы (на базе ctk.CTkComboBox).

build() → <MagicMock name='mock.CTkComboBox' id='140416955713872'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

clear() → None

Сброс значения поля в дефолтное состояние.

get_value() → str

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

class EJIO.ctk_extender.widget.FormDirectoryField(parent: Any, name: str, label_text: str, required: bool = False, geometry: Any = None, **kwargs: Any)

Базовые классы: WidgetContainer, InputField

Поле формы для выбора директорий с поддержкой валидации и ограничений.

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>

Строит базовый контейнерный фрейм. Может быть переопределен в дочерних классах (например, для настройки бордеров или цвета).

clear() → None

Сброс значения поля в дефолтное состояние.

get_value() → str | list[str]

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

validate() → str | None

Проводит внутреннюю валидацию поля. :return: Строка с ошибкой, если она есть, иначе None.

class EJIO.ctk_extender.widget.FormFileField(parent: Any, name: str, label_text: str, file_types: list[tuple[str, str]] | None = None, multiple: bool = False, required: bool = False, geometry: Any = None, **kwargs: Any)

Базовые классы: WidgetContainer, InputField

Поле формы для выбора файлов с поддержкой валидации и ограничений.

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>

Строит базовый контейнерный фрейм. Может быть переопределен в дочерних классах (например, для настройки бордеров или цвета).

clear() → None

Сброс значения поля в дефолтное состояние.

get_value() → str | list[str]

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

validate() → str | None

Проводит внутреннюю валидацию поля. :return: Строка с ошибкой, если она есть, иначе None.

class EJIO.ctk_extender.widget.FormOptionMenuField(parent: Any, name: str, label_text: str, values: list[str], default_value: str | None = None, layout: Literal['row', 'column'] = 'row', required: bool = False, geometry: GeometryStrategy | None = None, **kwargs: Any)

Базовые классы: WidgetContainer, InputField

Высокоуровневое поле формы на базе выпадающего списка ctk.CTkOptionMenu. Интегрировано в подсистему валидации форм.

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>

Строит каркас поля формы с поддержкой сеточного позиционирования.

clear() → None

Сброс значения поля в дефолтное состояние.

destroy() → None

Каскадно уничтожает сам контейнер и все вложенные в него дочерние виджеты, полностью очищая оперативную память.

get_value() → str

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

validate() → str | None

Проверяет, выбрано ли значение, если поле обязательно.

class EJIO.ctk_extender.widget.FormRadioButtonGroup(parent: Any, name: str, options: list[str], geometry: GeometryStrategy | None = None)

Базовые классы: Widget, InputField

Группа радио-кнопок для выбора одного значения из нескольких опций.

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>

Собирает невидимый фрейм-контейнер, внутри которого автоматически упаковывает радио-кнопки по вертикали.

clear() → None

Сброс значения поля в дефолтное состояние.

destroy() → None

Полностью уничтожает виджет, очищая память и удаляя его глобальные подписки.

get_value() → str

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

class EJIO.ctk_extender.widget.FormReadyEvent(target_form: Any)

Базовые классы: Event

Событие-ответ, сообщающее форме, что её обработка завершена и она может принимать новые клики.

property target_form: Any

class EJIO.ctk_extender.widget.FormSegmentedButton(parent: Any, name: str, values: list[str], geometry: GeometryStrategy | None = None)

Базовые классы: Widget, InputField

Сегментированная кнопка выбора для формы (на базе ctk.CTkSegmentedButton).

build() → <MagicMock name='mock.CTkSegmentedButton' id='140416955763120'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

clear() → None

Сброс значения поля в дефолтное состояние.

get_value() → str

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

class EJIO.ctk_extender.widget.FormSlider(parent: Any, name: str, from_value: float = 0.0, to_value: float = 100.0, default_value: float = 0.0, geometry: GeometryStrategy | None = None)

Базовые классы: Widget, InputField

Компонент ползунка для формы (на базе ctk.CTkSlider).

build() → <MagicMock name='mock.CTkSlider' id='140416955719344'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

clear() → None

Сброс значения поля в дефолтное состояние.

get_value() → float

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

class EJIO.ctk_extender.widget.FormSubmittedEvent(sender: Any, data: dict[str, Any])

Базовые классы: Event

Событие, возникающее при успешной валидации и отправке формы.

property data: dict[str, Any]

class EJIO.ctk_extender.widget.FormSwitch(parent: Any, name: str, text: str = '', geometry: GeometryStrategy | None = None)

Базовые классы: Widget, InputField

Компонент тумблера/переключателя для формы (на базе ctk.CTkSwitch).

build() → <MagicMock name='mock.CTkSwitch' id='140416955725632'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

clear() → None

Сброс значения поля в дефолтное состояние.

get_value() → bool

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

class EJIO.ctk_extender.widget.FormTextBox(parent: Any, name: str, required: bool = False, geometry: GeometryStrategy | None = None)

Базовые классы: Widget, InputField

Многострочное текстовое поле ввода для формы (на базе ctk.CTkTextbox).

build() → <MagicMock name='mock.CTkTextbox' id='140416955767824'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

clear() → None

Сброс значения поля в дефолтное состояние.

get_value() → str

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

validate() → str | None

Проводит внутреннюю валидацию поля. :return: Строка с ошибкой, если она есть, иначе None.

class EJIO.ctk_extender.widget.FormTextField(parent: Any, name: str, placeholder: str = '', required: bool = False, geometry: GeometryStrategy | None = None, **kwargs: Any)

Базовые классы: Widget, InputField

Текстовое поле ввода для формы (на базе ctk.CTkEntry).

build() → <MagicMock name='mock.CTkEntry' id='140416955669664'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

clear() → None

Сброс значения поля в дефолтное состояние.

get_value() → str

Возвращает текущее значение, введенное пользователем.

property name: str

Уникальное имя поля для формирования итогового словаря данных.

set_value(value: Any) → None

Программная установка значения в поле.

validate() → str | None

Проводит внутреннюю валидацию поля. :return: Строка с ошибкой, если она есть, иначе None.

class EJIO.ctk_extender.widget.FormValidationErrorEvent(sender: Any, errors: dict[str, str])

Базовые классы: Event

Событие, возникающее, если форма не прошла валидацию.

property errors: dict[str, str]

class EJIO.ctk_extender.widget.GeometryStrategy(**kwargs: Any)

Базовые классы: ABC

Абстрактный базовый класс для стратегий позиционирования (менеджеров геометрии). Инкапсулирует параметры разметки и управляет монтированием виджета.

abstractmethod mount(instance: <MagicMock name = 'mock.CTkBaseClass' id='140416957414240'>) → None

Отрисовывает (монтирует) переданный виджет на родителе.

abstractmethod unmount(instance: <MagicMock name = 'mock.CTkBaseClass' id='140416957414240'>) → None

Скрывает (размонтирует) переданный виджет, убирая его с экрана.

class EJIO.ctk_extender.widget.GridStrategy(**kwargs: Any)

Базовые классы: GeometryStrategy

Стратегия позиционирования виджета через метод grid().

mount(instance: <MagicMock name = 'mock.CTkBaseClass' id='140416957414240'>) → None

Отрисовывает (монтирует) переданный виджет на родителе.

unmount(instance: <MagicMock name = 'mock.CTkBaseClass' id='140416957414240'>) → None

Скрывает (размонтирует) переданный виджет, убирая его с экрана.

class EJIO.ctk_extender.widget.InputField(*args, **kwargs)

Базовые классы: Protocol

Протокол, описывающий требования к элементам ввода внутри Form. Разрешен для рантайм-проверок через isinstance().

abstractmethod clear() → None

Сброс значения поля в дефолтное состояние.

abstractmethod get_value() → Any

Возвращает текущее значение, введенное пользователем.

abstract property name: str

Уникальное имя поля для формирования итогового словаря данных.

abstractmethod set_value(value: Any) → None

Программная установка значения в поле.

validate() → str | None

Проводит внутреннюю валидацию поля. :return: Строка с ошибкой, если она есть, иначе None.

class EJIO.ctk_extender.widget.Label(parent: Any, text: str = '', geometry: GeometryStrategy | None = None, **kwargs: Any)

Базовые классы: Widget

Компонент вывода статичного текста или изображений (на базе ctk.CTkLabel).

build() → <MagicMock name='mock.CTkLabel' id='140416955848496'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

class EJIO.ctk_extender.widget.PackStrategy(**kwargs: Any)

Базовые классы: GeometryStrategy

Стратегия позиционирования виджета через метод pack().

mount(instance: <MagicMock name = 'mock.CTkBaseClass' id='140416957414240'>) → None

Отрисовывает (монтирует) переданный виджет на родителе.

unmount(instance: <MagicMock name = 'mock.CTkBaseClass' id='140416957414240'>) → None

Скрывает (размонтирует) переданный виджет, убирая его с экрана.

class EJIO.ctk_extender.widget.PlaceStrategy(**kwargs: Any)

Базовые классы: GeometryStrategy

Стратегия позиционирования виджета через метод place().

mount(instance: <MagicMock name = 'mock.CTkBaseClass' id='140416957414240'>) → None

Отрисовывает (монтирует) переданный виджет на родителе.

unmount(instance: <MagicMock name = 'mock.CTkBaseClass' id='140416957414240'>) → None

Скрывает (размонтирует) переданный виджет, убирая его с экрана.

class EJIO.ctk_extender.widget.ProgressBar(parent: Any, geometry: GeometryStrategy | None = None, **kwargs: Any)

Базовые классы: Widget

Компонент индикатора выполнения процессов (на базе ctk.CTkProgressBar).

build() → <MagicMock name='mock.CTkProgressBar' id='140416955851616'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

class EJIO.ctk_extender.widget.ScrollableFrame(parent: Any, title: str = '', geometry: GeometryStrategy | None = None, **kwargs: Any)

Базовые классы: WidgetContainer

Скроллируемый контейнер-фрейм для больших списков виджетов (на базе ctk.CTkScrollableFrame).

build() → <MagicMock name='mock.CTkScrollableFrame' id='140416955856944'>

Строит базовый контейнерный фрейм. Может быть переопределен в дочерних классах (например, для настройки бордеров или цвета).

class EJIO.ctk_extender.widget.Tabview(parent: Any, tabs: list[str], geometry: GeometryStrategy | None = None, **kwargs: Any)

Базовые классы: WidgetContainer

Компонент многовкладочного интерфейса (на базе ctk.CTkTabview).

add_widget_to_tab(tab_name: str, widget_cls: type[W], *args: Any, **kwargs: Any) → W

Фабричный метод для добавления виджета на конкретную вкладку компонента Tabview.

Параметры:

• tab_name – Имя вкладки.

• widget_cls – Виджет для добавления.

• args – Аргументы для инициализации виджета.

• kwargs – Ключевые аргументы для инициализации виджета.

build() → <MagicMock name='mock.CTkTabview' id='140416957562224'>

Строит базовый контейнерный фрейм. Может быть переопределен в дочерних классах (например, для настройки бордеров или цвета).

class EJIO.ctk_extender.widget.Widget(parent: <MagicMock name = 'mock.CTk.__or__().__or__().__or__()' id='140416956849216'>, geometry: GeometryStrategy | None = None, **kwargs: Any)

Базовые классы: ABC

Базовый абстрактный класс для всех элементов интерфейса ctk_extender. Автоматически управляет жизненным циклом, геометрией и декларативными подписками на события.

abstractmethod build() → <MagicMock name='mock.CTkBaseClass' id='140416957414240'>

Абстрактный метод сборки компонента. Должен быть переопределен в наследниках. Внутри него создаются и конфигурируются реальные ctk-объекты.

Результат:

Экземпляр реального ctk-виджета (например, ctk.CTkButton).

Исключение:

NotImplementedError – Должен быть определен в подклассе.

property ctk_instance: <MagicMock name='mock.CTkBaseClass' id='140416957414240'>

Возвращает ссылку на реальный объект customtkinter.

Исключение:

WidgetNotInitializedError – Если инстанс не инициализирован.

destroy() → None

Полностью уничтожает виджет, очищая память и удаляя его глобальные подписки.

focus() → None

Переводит фокус ввода операционной системы на данный виджет.

mount() → Self

Размещает виджет на родительском контейнере в соответствии с заданным методом геометрии.

property parent: Any

Возвращает родительский контейнер виджета.

set_geometry(geometry: GeometryStrategy) → Self

Позволяет динамически на лету переключить менеджер разметки виджета (например, перекинуть его из pack в grid без пересоздания объекта).

Параметры:

geometry – Объект стратегии геометрии.

unmount() → Self

Скрывает виджет с экрана, извлекая его из менеджера геометрии, но сохраняя состояние объекта в памяти.

class EJIO.ctk_extender.widget.WidgetContainer(parent: <MagicMock name = 'mock.CTk.__or__().__or__().__or__()' id='140416956849216'>, geometry: GeometryStrategy | None = None)

Базовые классы: Widget

Компонент-контейнер, объединяющий несколько виджетов внутри единого фрейма (CTkFrame). Автоматически каскадно управляет жизненным циклом и уничтожением всех дочерних элементов.

add_widget(widget_cls: type[W], *args: Any, **kwargs: Any) → W

Фабричный метод для динамического создания и добавления виджета внутрь контейнера. Автоматически передает ctk_instance текущего контейнера в качестве родителя.

Параметры:

• widget_cls – Класс создаваемого виджета (наследник Widget).

• args – Позиционные аргументы для конструктора виджета.

• kwargs – Именованные аргументы для конструктора виджета.

Результат:

Созданный экземпляр виджета.

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>

Строит базовый контейнерный фрейм. Может быть переопределен в дочерних классах (например, для настройки бордеров или цвета).

property children: List[Widget]

Возвращает список всех дочерних виджетов в контейнере.

destroy() → None

Каскадно уничтожает сам контейнер и все вложенные в него дочерние виджеты, полностью очищая оперативную память.

remove_widget(widget: W) → Self

Удаляет виджет из контейнера и уничтожает его ресурсы.

Параметры:

widget – Экземпляр уничтожаемого виджета.