EJIO.ctk_extender.widget.form.fields package

Submodules

EJIO.ctk_extender.widget.form.fields.base module

class EJIO.ctk_extender.widget.form.fields.base.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.

EJIO.ctk_extender.widget.form.fields.checkbox module

class EJIO.ctk_extender.widget.form.fields.checkbox.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

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

EJIO.ctk_extender.widget.form.fields.combobox module

class EJIO.ctk_extender.widget.form.fields.combobox.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

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

EJIO.ctk_extender.widget.form.fields.directory module

class EJIO.ctk_extender.widget.form.fields.directory.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.

EJIO.ctk_extender.widget.form.fields.file module

class EJIO.ctk_extender.widget.form.fields.file.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.

EJIO.ctk_extender.widget.form.fields.option_menu module

class EJIO.ctk_extender.widget.form.fields.option_menu.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

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

EJIO.ctk_extender.widget.form.fields.radio module

class EJIO.ctk_extender.widget.form.fields.radio.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

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

EJIO.ctk_extender.widget.form.fields.segmented module

class EJIO.ctk_extender.widget.form.fields.segmented.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

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

EJIO.ctk_extender.widget.form.fields.slider module

class EJIO.ctk_extender.widget.form.fields.slider.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

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

EJIO.ctk_extender.widget.form.fields.switch module

class EJIO.ctk_extender.widget.form.fields.switch.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

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

EJIO.ctk_extender.widget.form.fields.text module

class EJIO.ctk_extender.widget.form.fields.text.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.

EJIO.ctk_extender.widget.form.fields.textbox module

class EJIO.ctk_extender.widget.form.fields.textbox.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.

Module contents

class EJIO.ctk_extender.widget.form.fields.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.form.fields.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.form.fields.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.form.fields.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.form.fields.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.form.fields.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.form.fields.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.form.fields.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.form.fields.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.form.fields.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.form.fields.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.form.fields.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.