EJIO.ctk_extender.windows package¶

Subpackages¶

Module contents¶

class EJIO.ctk_extender.windows.BasePopup(title: str, width: int = 380, height: int = 160, modal: bool = True, master: Any = None, timeout: float | None = None)[исходный код]¶

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

Абстрактный базовый класс для всех модальных всплывающих окон (Popup). Инкапсулирует создание CTkToplevel, центрирование, фокус и каскадное уничтожение.

add_widget(widget_cls: type[W], *args: Any, **kwargs: Any) → W[исходный код]¶: Фабричный метод добавления виджетов внутрь попапа. Гарантирует жесткое удержание ссылки в памяти, исключая авто-удаление.

abstractmethod build_content() → None[исходный код]¶

Абстрактный метод сборки внутреннего наполнения диалога. Переопределяется в дочерних классах.

Raises:: NotImplementedError Переопределяется в подклассах.

property container: <MagicMock name='mock.CTkFrame' id='140416972239120'>¶: Возвращает безопасный фрейм-контейнер для упаковки дочерних виджетов.

property ctk_instance: <MagicMock name='mock.CTkToplevel' id='140416955880592'>¶

destroy() → None[исходный код]¶: Завершает работу диалога и освобождает модальный фокус.

class EJIO.ctk_extender.windows.BlankLayout(parent: <MagicMock name = 'mock.CTk.__or__().__or__()' id='140416957553632'>, geometry: GeometryStrategy | None = None)[исходный код]¶

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

Встроенный пустой макет фреймворка. Используется как заглушка по умолчанию, чтобы защитить геометрию окна.

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>[исходный код]¶: Строит базовый контейнерный фрейм. Может быть переопределен в дочерних классах (например, для настройки бордеров или цвета).

on_hide() → None[исходный код]¶: Хук жизненного цикла: макет скрыт (ушел вглубь стека или закрывается).

on_show() → None[исходный код]¶: Хук жизненного цикла: макет выведен на экран (стал активным).

class EJIO.ctk_extender.windows.ColorPickerPopup(title: str, initial_color: str | Color, master: Any = None)[исходный код]¶

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

Модальный диалог для интерактивного выбора цвета.

build_content() → None[исходный код]¶

Абстрактный метод сборки внутреннего наполнения диалога. Переопределяется в дочерних классах.

Raises:: NotImplementedError Переопределяется в подклассах.

chosen_color: Color¶

is_confirmed: bool¶

class EJIO.ctk_extender.windows.ConfirmPopup(title: str, message: str, on_callback: Callable[[bool], None], master: Any = None, timeout: float | None = None)[исходный код]¶

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

Модальное окно запроса подтверждения (Да/Нет) с возвратом результата в callback.

build_content() → None[исходный код]¶

Абстрактный метод сборки внутреннего наполнения диалога. Переопределяется в дочерних классах.

Raises:: NotImplementedError Переопределяется в подклассах.

destroy() → None[исходный код]¶: Переопределенный деструктор: если окно закрыли крестиком, возвращаем False.

class EJIO.ctk_extender.windows.DatePickerPopup(title: str, initial_date: date | None = None, master: Any = None)[исходный код]¶

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

Модальный диалог-календарь для выбора даты.

build_content() → None[исходный код]¶

Абстрактный метод сборки внутреннего наполнения диалога. Переопределяется в дочерних классах.

Raises:: NotImplementedError Переопределяется в подклассах.

is_confirmed: bool¶

selected_date: date¶

class EJIO.ctk_extender.windows.ErrorNotification(parent: Any, flags: StyleFlags = StyleFlags.DEFAULT, message: str | None = None, **kwargs: Any)[исходный код]¶

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

Встроенное критическое уведомление об ошибке (Красный стиль).

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>[исходный код]¶: Парсит побитовые флаги и собирает пустую оболочку фона.

class EJIO.ctk_extender.windows.ImagePopup(title: str, source: str | Path | bytes, master: Any = None, timeout: float | None = None)[исходный код]¶

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

Неблокирующее всплывающее окно для интерактивного просмотра изображений (строки, Path, bytes) с кнопками масштабирования и закрытия.

build_content() → None[исходный код]¶

Абстрактный метод сборки внутреннего наполнения диалога. Переопределяется в дочерних классах.

Raises:: NotImplementedError Переопределяется в подклассах.

destroy() → None[исходный код]¶: Очищает тяжелые Pillow графические буферы виджета при закрытии.

class EJIO.ctk_extender.windows.InfoNotification(parent: Any, flags: StyleFlags = StyleFlags.DEFAULT, message: str | None = None, **kwargs: Any)[исходный код]¶

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

Встроенное информационное уведомление (Синий стиль).

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>[исходный код]¶: Парсит побитовые флаги и собирает пустую оболочку фона.

class EJIO.ctk_extender.windows.InfoPopup(title: str, message: str, master: Any = None, timeout: float | None = None)[исходный код]¶

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

Модальное окно вывода информационных сообщений.

build_content() → None[исходный код]¶

Абстрактный метод сборки внутреннего наполнения диалога. Переопределяется в дочерних классах.

Raises:: NotImplementedError Переопределяется в подклассах.

class EJIO.ctk_extender.windows.LoginLayout(parent: <MagicMock name = 'mock.CTk.__or__().__or__()' id='140416957553632'>, geometry: GeometryStrategy | None = None)[исходный код]¶

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

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>[исходный код]¶: Строит базовый контейнерный фрейм. Может быть переопределен в дочерних классах (например, для настройки бордеров или цвета).

destroy() → None[исходный код]¶: Каскадно уничтожает сам контейнер и все вложенные в него дочерние виджеты, полностью очищая оперативную память.

on_show() → None[исходный код]¶: Хук жизненного цикла: макет выведен на экран (стал активным).

class EJIO.ctk_extender.windows.SuccessNotification(parent: Any, flags: StyleFlags = StyleFlags.DEFAULT, message: str | None = None, **kwargs: Any)[исходный код]¶

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

Встроенное уведомление об успешной операции (Зеленый стиль).

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>[исходный код]¶: Парсит побитовые флаги и собирает пустую оболочку фона.

class EJIO.ctk_extender.windows.WarningNotification(parent: Any, flags: StyleFlags = StyleFlags.DEFAULT, message: str | None = None, **kwargs: Any)[исходный код]¶

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

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

build() → <MagicMock name='mock.CTkFrame' id='140416972239120'>[исходный код]¶: Парсит побитовые флаги и собирает пустую оболочку фона.

class EJIO.ctk_extender.windows.WarningPopup(title: str, message: str, master: Any = None, timeout: float | None = None)[исходный код]¶

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

Модальное окно предупреждений и критических ошибок.

build_content() → None[исходный код]¶

Абстрактный метод сборки внутреннего наполнения диалога. Переопределяется в дочерних классах.

Raises:: NotImplementedError Переопределяется в подклассах.

EJIO.ctk_extender.windows.popup_color(title: str, initial_color: str | Color = '#FFFFFF') → Color | None[исходный код]¶: Открывает палитру и синхронно возвращает объект Color или None.

EJIO.ctk_extender.windows.popup_confirm(title: str, message: str, on_callback: Callable[[bool], None], /, *, timeout: float | None = None) → None[исходный код]¶: Выводит модальный диалог подтверждения с кнопками Да/Нет. Результат выбора (True/False) передается аргументом в on_callback.

EJIO.ctk_extender.windows.popup_date(title: str, initial_date: date | None = None) → date | None[исходный код]¶: Открывает календарь и синхронно возвращает дату или None.

EJIO.ctk_extender.windows.popup_directory(title: str = 'Select folder') → str | None[исходный код]¶: Синхронный диалог выбора папки. Возвращает абсолютный путь в виде строки или None.

EJIO.ctk_extender.windows.popup_file(title: str = 'Select file', file_types: list[tuple[str, str]] | None = None, multiple: bool = False, single_only: bool = True) → str | list[str] | None[исходный код]¶

Синхронный диалог выбора файлов с фильтром расширений и контролем количества.

Параметры:

file_types – Список кортежей ограничений, например: [(«Изображения», «.png;.jpg»), («Все файлы», «.»)]
multiple – Если True, разрешает множественный выбор файлов (Ctrl+Клик)
single_only – Если True, то даже при multiple=True вернет ошибку или жестко обрежет массив до 1 элемента

EJIO.ctk_extender.windows.popup_image(title: str, source: str | Path | bytes, /, *, timeout: float | None = None) → None[исходный код]¶: Открывает независимое неблокирующее окно просмотра изображения. Позволяет пользователю параллельно работать с главным интерфейсом приложения.

EJIO.ctk_extender.windows.popup_info(title: str, message: str, /, *, timeout: float | None = None) → None[исходный код]¶: Выводит быстрое информационное модальное окно уведомления.

EJIO.ctk_extender.windows.popup_warning(title: str, message: str, /, *, timeout: float | None = None) → None[исходный код]¶: Выводит модальное окно предупреждения или критической ошибки.