EJIO.ctk_extender.windows.popup package

Submodules

EJIO.ctk_extender.windows.popup.base module

class EJIO.ctk_extender.windows.popup.base.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

Завершает работу диалога и освобождает модальный фокус.

EJIO.ctk_extender.windows.popup.color module

class EJIO.ctk_extender.windows.popup.color.ColorPickerPopup(title: str, initial_color: str | Color, master: Any = None)

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

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

build_content() → None

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

Raises:

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

chosen_color: Color

is_confirmed: bool

EJIO.ctk_extender.windows.popup.confirm module

class EJIO.ctk_extender.windows.popup.confirm.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.

EJIO.ctk_extender.windows.popup.date module

class EJIO.ctk_extender.windows.popup.date.DatePickerPopup(title: str, initial_date: date | None = None, master: Any = None)

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

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

build_content() → None

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

Raises:

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

is_confirmed: bool

selected_date: date

EJIO.ctk_extender.windows.popup.factory module

EJIO.ctk_extender.windows.popup.factory.popup_color(title: str, initial_color: str | Color = '#FFFFFF') → Color | None

Открывает палитру и синхронно возвращает объект Color или None.

EJIO.ctk_extender.windows.popup.factory.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.factory.popup_date(title: str, initial_date: date | None = None) → date | None

Открывает календарь и синхронно возвращает дату или None.

EJIO.ctk_extender.windows.popup.factory.popup_directory(title: str = 'Select folder') → str | None

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

EJIO.ctk_extender.windows.popup.factory.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.factory.popup_image(title: str, source: str | Path | bytes, /, *, timeout: float | None = None) → None

Открывает независимое неблокирующее окно просмотра изображения. Позволяет пользователю параллельно работать с главным интерфейсом приложения.

EJIO.ctk_extender.windows.popup.factory.popup_info(title: str, message: str, /, *, timeout: float | None = None) → None

Выводит быстрое информационное модальное окно уведомления.

EJIO.ctk_extender.windows.popup.factory.popup_warning(title: str, message: str, /, *, timeout: float | None = None) → None

Выводит модальное окно предупреждения или критической ошибки.

EJIO.ctk_extender.windows.popup.image module

class EJIO.ctk_extender.windows.popup.image.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 графические буферы виджета при закрытии.

EJIO.ctk_extender.windows.popup.info module

class EJIO.ctk_extender.windows.popup.info.InfoPopup(title: str, message: str, master: Any = None, timeout: float | None = None)

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

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

build_content() → None

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

Raises:

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

EJIO.ctk_extender.windows.popup.localization module

EJIO.ctk_extender.windows.popup.warning module

class EJIO.ctk_extender.windows.popup.warning.WarningPopup(title: str, message: str, master: Any = None, timeout: float | None = None)

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

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

build_content() → None

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

Raises:

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

Module contents

class EJIO.ctk_extender.windows.popup.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.popup.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.popup.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.popup.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.popup.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.popup.InfoPopup(title: str, message: str, master: Any = None, timeout: float | None = None)

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

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

build_content() → None

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

Raises:

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

class EJIO.ctk_extender.windows.popup.WarningPopup(title: str, message: str, master: Any = None, timeout: float | None = None)

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

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

build_content() → None

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

Raises:

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

EJIO.ctk_extender.windows.popup.popup_color(title: str, initial_color: str | Color = '#FFFFFF') → Color | None

Открывает палитру и синхронно возвращает объект Color или None.

EJIO.ctk_extender.windows.popup.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.popup_date(title: str, initial_date: date | None = None) → date | None

Открывает календарь и синхронно возвращает дату или None.

EJIO.ctk_extender.windows.popup.popup_directory(title: str = 'Select folder') → str | None

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

EJIO.ctk_extender.windows.popup.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.popup_image(title: str, source: str | Path | bytes, /, *, timeout: float | None = None) → None

Открывает независимое неблокирующее окно просмотра изображения. Позволяет пользователю параллельно работать с главным интерфейсом приложения.

EJIO.ctk_extender.windows.popup.popup_info(title: str, message: str, /, *, timeout: float | None = None) → None

Выводит быстрое информационное модальное окно уведомления.

EJIO.ctk_extender.windows.popup.popup_warning(title: str, message: str, /, *, timeout: float | None = None) → None

Выводит модальное окно предупреждения или критической ошибки.