EJIO.ctk_extender package

Subpackages

• EJIO.ctk_extender.app package
  • Submodules
  • EJIO.ctk_extender.app.base module
    • Application
      • Application.change_language()
      • Application.close_window()
      • Application.emit()
      • Application.exit()
      • Application.get_window()
      • Application.is_running
      • Application.navigate_to()
      • Application.notify()
      • Application.open_window()
      • Application.pop_screen()
      • Application.popup_confirm()
      • Application.popup_image()
      • Application.popup_info()
      • Application.popup_warning()
      • Application.push_screen()
      • Application.run()
      • Application.subscribe()
      • Application.translate()
      • Application.unsubscribe()
  • Module contents
    • Application
      • Application.change_language()
      • Application.close_window()
      • Application.emit()
      • Application.exit()
      • Application.get_window()
      • Application.is_running
      • Application.navigate_to()
      • Application.notify()
      • Application.open_window()
      • Application.pop_screen()
      • Application.popup_confirm()
      • Application.popup_image()
      • Application.popup_info()
      • Application.popup_warning()
      • Application.push_screen()
      • Application.run()
      • Application.subscribe()
      • Application.translate()
      • Application.unsubscribe()
• EJIO.ctk_extender.components package
  • Submodules
  • EJIO.ctk_extender.components.color_picker module
    • ColorPicker
      • ColorPicker.build()
  • EJIO.ctk_extender.components.copyable_field module
    • CopyableField
      • CopyableField.build()
      • CopyableField.copy_to_clipboard()
      • CopyableField.destroy()
  • EJIO.ctk_extender.components.date_picker module
    • DatePicker
      • DatePicker.build()
  • EJIO.ctk_extender.components.event module
    • FieldReturnEvent
      • FieldReturnEvent.field_name
  • EJIO.ctk_extender.components.image module
    • ImageWidget
      • ImageWidget.build()
      • ImageWidget.destroy()
      • ImageWidget.update_source()
  • EJIO.ctk_extender.components.labeled_field module
    • FormLabeledField
      • FormLabeledField.build()
      • FormLabeledField.clear()
      • FormLabeledField.destroy()
      • FormLabeledField.focus()
      • FormLabeledField.get_value()
      • FormLabeledField.name
      • FormLabeledField.set_value()
      • FormLabeledField.validate()
  • EJIO.ctk_extender.components.localization module
  • EJIO.ctk_extender.components.login_form module
    • LoginForm
      • LoginForm.build()
  • EJIO.ctk_extender.components.scrollable_container module
    • ScrollableContainer
      • ScrollableContainer.build()
  • EJIO.ctk_extender.components.section module
    • Section
      • Section.add_widget()
      • Section.build()
      • Section.destroy()
  • EJIO.ctk_extender.components.table module
    • TableWidget
      • TableWidget.build()
      • TableWidget.destroy()
  • Module contents
    • ColorPicker
      • ColorPicker.build()
    • CopyableField
      • CopyableField.build()
      • CopyableField.copy_to_clipboard()
      • CopyableField.destroy()
    • DatePicker
      • DatePicker.build()
    • FieldReturnEvent
      • FieldReturnEvent.field_name
    • FormLabeledField
      • FormLabeledField.build()
      • FormLabeledField.clear()
      • FormLabeledField.destroy()
      • FormLabeledField.focus()
      • FormLabeledField.get_value()
      • FormLabeledField.name
      • FormLabeledField.set_value()
      • FormLabeledField.validate()
    • ImageWidget
      • ImageWidget.build()
      • ImageWidget.destroy()
      • ImageWidget.update_source()
    • LoginForm
      • LoginForm.build()
    • ScrollableContainer
      • ScrollableContainer.build()
    • Section
      • Section.add_widget()
      • Section.build()
      • Section.destroy()
    • TableWidget
      • TableWidget.build()
      • TableWidget.destroy()
• EJIO.ctk_extender.config package
  • Submodules
  • EJIO.ctk_extender.config.settings module
    • AppSettings
      • AppSettings.appearance_mode
      • AppSettings.clear()
      • AppSettings.color_theme
      • AppSettings.is_dark_mode()
    • set_appearance_mode()
    • set_color_theme()
  • Module contents
    • AppSettings
      • AppSettings.appearance_mode
      • AppSettings.clear()
      • AppSettings.color_theme
      • AppSettings.is_dark_mode()
    • set_appearance_mode()
    • set_color_theme()
• EJIO.ctk_extender.event package
  • Submodules
  • EJIO.ctk_extender.event.base module
    • Event
      • Event.sender
      • Event.sender_thread_name
      • Event.timestamp
  • EJIO.ctk_extender.event.controller module
    • EventController
      • EventController.emit()
      • EventController.initialize()
      • EventController.subscribe()
      • EventController.unsubscribe()
  • EJIO.ctk_extender.event.listener module
    • EventListener
      • EventListener.register_listeners()
      • EventListener.unregister_listeners()
    • on_event()
  • Module contents
    • Event
      • Event.sender
      • Event.sender_thread_name
      • Event.timestamp
    • EventController
      • EventController.emit()
      • EventController.initialize()
      • EventController.subscribe()
      • EventController.unsubscribe()
    • EventListener
      • EventListener.register_listeners()
      • EventListener.unregister_listeners()
    • on_event()
• EJIO.ctk_extender.layout package
  • Submodules
  • EJIO.ctk_extender.layout.base module
    • Layout
      • Layout.build()
      • Layout.destroy()
      • Layout.on_hide()
      • Layout.on_show()
  • EJIO.ctk_extender.layout.err module
    • IncorrectLayoutTypeError
    • LayoutAlreadyRegisteredError
    • LayoutNotFoundError
    • LayoutRegistryError
  • EJIO.ctk_extender.layout.router module
    • LayoutRouter
      • LayoutRouter.get()
      • LayoutRouter.get_layout_class()
    • get_layout()
    • register_layout()
  • Module contents
    • Layout
      • Layout.build()
      • Layout.destroy()
      • Layout.on_hide()
      • Layout.on_show()
    • LayoutRouter
      • LayoutRouter.get()
      • LayoutRouter.get_layout_class()
    • get_layout()
    • register_layout()
• EJIO.ctk_extender.notification package
  • Submodules
  • EJIO.ctk_extender.notification.base module
    • BaseNotification
      • BaseNotification.build()
      • BaseNotification.content_area
      • BaseNotification.height
      • BaseNotification.width
  • EJIO.ctk_extender.notification.desktop_controller module
    • DesktopNotificationController
      • DesktopNotificationController.clear()
      • DesktopNotificationController.push()
  • EJIO.ctk_extender.notification.err module
    • NotificationMountError
  • EJIO.ctk_extender.notification.flags module
    • StyleFlags
      • StyleFlags.BORDER_NONE
      • StyleFlags.BORDER_THICK
      • StyleFlags.BORDER_THIN
      • StyleFlags.DEFAULT
      • StyleFlags.FILLED
      • StyleFlags.ROUNDED
      • StyleFlags.SQUARE
      • StyleFlags.TRANSPARENT
  • EJIO.ctk_extender.notification.in_app_controller module
    • InAppNotificationController
      • InAppNotificationController.clear()
      • InAppNotificationController.push()
  • EJIO.ctk_extender.notification.position module
    • NotificationPosition
      • NotificationPosition.apply_desktop()
      • NotificationPosition.apply_in_app()
    • get_position_strategy()
  • Module contents
    • BaseNotification
      • BaseNotification.build()
      • BaseNotification.content_area
      • BaseNotification.height
      • BaseNotification.width
    • DesktopNotificationController
      • DesktopNotificationController.clear()
      • DesktopNotificationController.push()
    • InAppNotificationController
      • InAppNotificationController.clear()
      • InAppNotificationController.push()
    • NotificationPosition
      • NotificationPosition.apply_desktop()
      • NotificationPosition.apply_in_app()
    • StyleFlags
      • StyleFlags.BORDER_NONE
      • StyleFlags.BORDER_THICK
      • StyleFlags.BORDER_THIN
      • StyleFlags.DEFAULT
      • StyleFlags.FILLED
      • StyleFlags.ROUNDED
      • StyleFlags.SQUARE
      • StyleFlags.TRANSPARENT
    • get_position_strategy()
• EJIO.ctk_extender.state package
  • Submodules
  • EJIO.ctk_extender.state.collection module
    • ReactiveDict
      • ReactiveDict.clear()
    • ReactiveList
      • ReactiveList.append()
      • ReactiveList.clear()
      • ReactiveList.extend()
      • ReactiveList.pop()
      • ReactiveList.remove()
  • EJIO.ctk_extender.state.events module
    • CollectionChangedEvent
      • CollectionChangedEvent.items
      • CollectionChangedEvent.operation
      • CollectionChangedEvent.sender
    • DictionaryChangedEvent
      • DictionaryChangedEvent.key
      • DictionaryChangedEvent.operation
      • DictionaryChangedEvent.sender
      • DictionaryChangedEvent.value
    • StateChangedEvent
      • StateChangedEvent.new_value
      • StateChangedEvent.sender
  • EJIO.ctk_extender.state.model module
    • ReactiveModel
  • EJIO.ctk_extender.state.reactive module
    • State
      • State.value
  • Module contents
    • CollectionChangedEvent
      • CollectionChangedEvent.items
      • CollectionChangedEvent.operation
      • CollectionChangedEvent.sender
    • DictionaryChangedEvent
      • DictionaryChangedEvent.key
      • DictionaryChangedEvent.operation
      • DictionaryChangedEvent.sender
      • DictionaryChangedEvent.value
    • ReactiveDict
      • ReactiveDict.clear()
    • ReactiveList
      • ReactiveList.append()
      • ReactiveList.clear()
      • ReactiveList.extend()
      • ReactiveList.pop()
      • ReactiveList.remove()
    • ReactiveModel
    • State
      • State.value
    • StateChangedEvent
      • StateChangedEvent.new_value
      • StateChangedEvent.sender
• EJIO.ctk_extender.widget package
  • Subpackages
    • EJIO.ctk_extender.widget.components package
      • Submodules
      • EJIO.ctk_extender.widget.components.button module
      • EJIO.ctk_extender.widget.components.label module
      • EJIO.ctk_extender.widget.components.progress module
      • EJIO.ctk_extender.widget.components.scrollable module
      • EJIO.ctk_extender.widget.components.tabview module
      • Module contents
    • EJIO.ctk_extender.widget.form package
      • Subpackages
      • Submodules
      • EJIO.ctk_extender.widget.form.base module
      • EJIO.ctk_extender.widget.form.events module
      • Module contents
    • EJIO.ctk_extender.widget.geometry package
      • Submodules
      • EJIO.ctk_extender.widget.geometry.base module
      • EJIO.ctk_extender.widget.geometry.implementations module
      • Module contents
  • Submodules
  • EJIO.ctk_extender.widget.base module
    • Widget
      • Widget.build()
      • Widget.ctk_instance
      • Widget.destroy()
      • Widget.focus()
      • Widget.mount()
      • Widget.parent
      • Widget.set_geometry()
      • Widget.unmount()
  • EJIO.ctk_extender.widget.container module
    • WidgetContainer
      • WidgetContainer.add_widget()
      • WidgetContainer.build()
      • WidgetContainer.children
      • WidgetContainer.destroy()
      • WidgetContainer.remove_widget()
  • EJIO.ctk_extender.widget.err module
    • CtkExtenderWidgetContainerError
    • CtkExtenderWidgetError
    • WidgetContainerExtensionError
    • WidgetMountError
    • WidgetNotInitializedError
  • Module contents
    • Button
      • Button.build()
    • 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
    • GeometryStrategy
      • GeometryStrategy.mount()
      • GeometryStrategy.unmount()
    • GridStrategy
      • GridStrategy.mount()
      • GridStrategy.unmount()
    • InputField
      • InputField.clear()
      • InputField.get_value()
      • InputField.name
      • InputField.set_value()
      • InputField.validate()
    • Label
      • Label.build()
    • PackStrategy
      • PackStrategy.mount()
      • PackStrategy.unmount()
    • PlaceStrategy
      • PlaceStrategy.mount()
      • PlaceStrategy.unmount()
    • ProgressBar
      • ProgressBar.build()
    • ScrollableFrame
      • ScrollableFrame.build()
    • Tabview
      • Tabview.add_widget_to_tab()
      • Tabview.build()
    • Widget
      • Widget.build()
      • Widget.ctk_instance
      • Widget.destroy()
      • Widget.focus()
      • Widget.mount()
      • Widget.parent
      • Widget.set_geometry()
      • Widget.unmount()
    • WidgetContainer
      • WidgetContainer.add_widget()
      • WidgetContainer.build()
      • WidgetContainer.children
      • WidgetContainer.destroy()
      • WidgetContainer.remove_widget()
• EJIO.ctk_extender.window package
  • Submodules
  • EJIO.ctk_extender.window.base module
    • Window
      • Window.active_layout_canvas
      • Window.center()
      • Window.config
      • Window.ctk_instance
      • Window.destroy()
      • Window.focus()
      • Window.get_default_config()
      • Window.maximize()
      • Window.minimize()
      • Window.mount()
      • Window.name
      • Window.on_mounted()
      • Window.pop_layout()
      • Window.push_layout()
      • Window.resize()
      • Window.restore()
      • Window.screenshot
      • Window.switch_layout()
  • EJIO.ctk_extender.window.config module
    • WindowConfig
      • WindowConfig.height
      • WindowConfig.initial_layout
      • WindowConfig.name
      • WindowConfig.resizable_x
      • WindowConfig.resizable_y
      • WindowConfig.title
      • WindowConfig.width
      • WindowConfig.x_pos
      • WindowConfig.y_pos
  • EJIO.ctk_extender.window.controller module
    • WindowController
      • WindowController.clear()
      • WindowController.close_window()
      • WindowController.get_active()
      • WindowController.open_window()
  • EJIO.ctk_extender.window.err module
    • CtkExtenderWindowError
    • IncorrectWindowTypeError
    • WindowAlreadyRegisteredError
    • WindowInstanceMissingError
    • WindowNotActiveError
    • WindowNotFoundError
    • WindowRegistryError
  • EJIO.ctk_extender.window.registry module
    • WindowRegistry
      • WindowRegistry.get()
    • register_window()
  • EJIO.ctk_extender.window.session module
    • WindowSessionManager
      • WindowSessionManager.clear()
      • WindowSessionManager.get_stored_geometry()
      • WindowSessionManager.load_sessions()
      • WindowSessionManager.save_sessions()
      • WindowSessionManager.store_geometry()
  • Module contents
    • Window
      • Window.active_layout_canvas
      • Window.center()
      • Window.config
      • Window.ctk_instance
      • Window.destroy()
      • Window.focus()
      • Window.get_default_config()
      • Window.maximize()
      • Window.minimize()
      • Window.mount()
      • Window.name
      • Window.on_mounted()
      • Window.pop_layout()
      • Window.push_layout()
      • Window.resize()
      • Window.restore()
      • Window.screenshot
      • Window.switch_layout()
    • WindowConfig
      • WindowConfig.height
      • WindowConfig.initial_layout
      • WindowConfig.name
      • WindowConfig.resizable_x
      • WindowConfig.resizable_y
      • WindowConfig.title
      • WindowConfig.width
      • WindowConfig.x_pos
      • WindowConfig.y_pos
    • WindowController
      • WindowController.clear()
      • WindowController.close_window()
      • WindowController.get_active()
      • WindowController.open_window()
    • WindowRegistry
      • WindowRegistry.get()
    • WindowSessionManager
      • WindowSessionManager.clear()
      • WindowSessionManager.get_stored_geometry()
      • WindowSessionManager.load_sessions()
      • WindowSessionManager.save_sessions()
      • WindowSessionManager.store_geometry()
    • register_window()
• EJIO.ctk_extender.windows package
  • Subpackages
    • EJIO.ctk_extender.windows.layout package
      • Submodules
      • EJIO.ctk_extender.windows.layout.blank module
      • EJIO.ctk_extender.windows.layout.localization module
      • EJIO.ctk_extender.windows.layout.login module
      • Module contents
    • EJIO.ctk_extender.windows.notification package
      • Submodules
      • EJIO.ctk_extender.windows.notification.error module
      • EJIO.ctk_extender.windows.notification.info module
      • EJIO.ctk_extender.windows.notification.localization module
      • EJIO.ctk_extender.windows.notification.success module
      • EJIO.ctk_extender.windows.notification.warning module
      • Module contents
    • EJIO.ctk_extender.windows.popup package
      • Submodules
      • EJIO.ctk_extender.windows.popup.base module
      • EJIO.ctk_extender.windows.popup.color module
      • EJIO.ctk_extender.windows.popup.confirm module
      • EJIO.ctk_extender.windows.popup.date module
      • EJIO.ctk_extender.windows.popup.factory module
      • EJIO.ctk_extender.windows.popup.image module
      • EJIO.ctk_extender.windows.popup.info module
      • EJIO.ctk_extender.windows.popup.localization module
      • EJIO.ctk_extender.windows.popup.warning module
      • Module contents
  • Module contents
    • BasePopup
      • BasePopup.add_widget()
      • BasePopup.build_content()
      • BasePopup.container
      • BasePopup.ctk_instance
      • BasePopup.destroy()
    • BlankLayout
      • BlankLayout.build()
      • BlankLayout.on_hide()
      • BlankLayout.on_show()
    • ColorPickerPopup
      • ColorPickerPopup.build_content()
      • ColorPickerPopup.chosen_color
      • ColorPickerPopup.is_confirmed
    • ConfirmPopup
      • ConfirmPopup.build_content()
      • ConfirmPopup.destroy()
    • DatePickerPopup
      • DatePickerPopup.build_content()
      • DatePickerPopup.is_confirmed
      • DatePickerPopup.selected_date
    • ErrorNotification
      • ErrorNotification.build()
    • ImagePopup
      • ImagePopup.build_content()
      • ImagePopup.destroy()
    • InfoNotification
      • InfoNotification.build()
    • InfoPopup
      • InfoPopup.build_content()
    • LoginLayout
      • LoginLayout.build()
      • LoginLayout.destroy()
      • LoginLayout.on_show()
    • SuccessNotification
      • SuccessNotification.build()
    • WarningNotification
      • WarningNotification.build()
    • WarningPopup
      • WarningPopup.build_content()
    • popup_color()
    • popup_confirm()
    • popup_date()
    • popup_directory()
    • popup_file()
    • popup_image()
    • popup_info()
    • popup_warning()

Submodules

EJIO.ctk_extender.base_error module

exception EJIO.ctk_extender.base_error.CtkExtenderBaseError(message: str)

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

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

EJIO.ctk_extender.err module

exception EJIO.ctk_extender.err.CtkExtenderBaseError(message: str)

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

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

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

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

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

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

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

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

exception EJIO.ctk_extender.err.CtkExtenderWindowError(message: str)

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

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

exception EJIO.ctk_extender.err.IncorrectLayoutTypeError(message: str)

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

Исключение связанное с некорректной попыткой регистрации лэйаута.

exception EJIO.ctk_extender.err.IncorrectWindowTypeError(message: str)

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

Исключение связанное с некорректной попыткой регистрации окна.

exception EJIO.ctk_extender.err.LayoutAlreadyRegisteredError(message: str)

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

Исключение связанное с ошибкой перезаписи зарегестрированного лэйаута.

exception EJIO.ctk_extender.err.LayoutNotFoundError(message: str)

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

Исключение связанное с ошибкой остутствия искомого лэйаута в реестре.

exception EJIO.ctk_extender.err.LayoutRegistryError(message: str)

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

Базовое исключение связанное с работой реестра окон.

exception EJIO.ctk_extender.err.NotificationMountError(message: str)

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

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

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

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

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

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

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

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

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

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

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

exception EJIO.ctk_extender.err.WindowAlreadyRegisteredError(message: str)

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

Исключение связанное с ошибкой перезаписи зарегестрированного окна.

exception EJIO.ctk_extender.err.WindowInstanceMissingError(message: str)

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

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

exception EJIO.ctk_extender.err.WindowNotActiveError(message: str)

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

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

exception EJIO.ctk_extender.err.WindowNotFoundError(message: str)

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

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

exception EJIO.ctk_extender.err.WindowRegistryError(message: str)

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

Базовое исключение связанное с работой реестра окон.

Module contents

class EJIO.ctk_extender.Application(*args: object, **kwargs: object)

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

Глобальный оркестратор и единый фасадный интерфейс фреймворка ctk_extender. Предоставляет методы для управления событиями, навигацией и жизненным циклом окон без прямого обращения к внутренним контроллерам.

change_language(locale: str) → None

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

close_window(name: str) → None

Закрывает окно по его имени.

emit(event: Event) → None

Потокобезопасно отправляет событие в глобальную шину.

exit(exit_code: int = 0) → None

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

get_window(name: str) → Window

Возвращает живой объект активного окна по имени.

property is_running: bool

navigate_to(window_name: str, layout_name: str) → None

Переключает текущий макет указанного окна (с полной очисткой стека).

notify(notification_cls: type[BaseNotification], target: Literal['in_app', 'desktop'] = 'in_app', flags: StyleFlags = StyleFlags.DEFAULT, position: str = 'top_right', duration: float = 3.5, **kwargs: Any) → None

Единая полиморфная точка входа для отправки уведомлений во фреймворке. Прозрачно проксирует переданный ООП-класс уведомления в контроллеры.

open_window(name: str, *args: Any, **kwargs: Any) → Window

Создает и выводит на экран окно из WindowRegistry.

pop_screen(window_name: str) → None

Возвращает указанное окно на предыдущий экран навигационного стека.

popup_confirm(title: str, message: str, on_callback: Callable[[bool], None]) → None

Показывает модальный диалог подтверждения операции (Да/Нет) с защитой от крестика.

popup_image(title: str, source: str | Path | bytes) → None

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

popup_info(title: str, message: str) → None

Показывает модальное информационное окно.

popup_warning(title: str, message: str) → None

Показывает модальное предупреждение об ошибке.

push_screen(window_name: str, layout_name: str) → None

Помещает новый экран на вершину стека навигации указанного окна.

run() → None

Запускает приложение, инициализируя тему, локали и главный цикл Tkinter.

subscribe(event_type: type[E], callback: Callable[[E], None], *, sender: Any | None = None, predicate: Callable[[E], bool] | None = None) → None

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

translate(key_path: str, default: str | None = None) → str

Извлекает локализованную строку по её точечному пути. Дублирует поведение глобальной функции _().

unsubscribe(event_type: type[E], callback: Callable[[E], None]) → None

Отписывает обработчик от события.

class EJIO.ctk_extender.BaseNotification(parent: Any, flags: StyleFlags = StyleFlags.DEFAULT, width: int = 320, height: int = 60, fg_color: str = '#1E293B', border_color: str = '#475569', **kwargs: Any)

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

Базовый ООП-компонент уведомления. Строит пустую оболочку фона на основании битовой комбинации флагов StyleFlags. Центрирует вложенное содержимое, предотвращая перекрытие рамок.

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

Парсит побитовые флаги и собирает пустую оболочку фона.

property content_area: <MagicMock name='mock.CTkFrame' id='140416972239120'>

property height: int

property width: int

class EJIO.ctk_extender.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.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.CollectionChangedEvent(sender: Any, operation: str, items: list[T])

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

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

property items: list[T]

property operation: str

property sender: Any

Возвращает отправителя события.

class EJIO.ctk_extender.ColorPicker(parent: Any, initial_color: str | Color, on_change: Callable[[Color], None], geometry: Any = None, **kwargs: Any)

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

Интерактивный виджет выбора цвета. Поддерживает ввод HEX, RGB целых чисел и вызов палитры ОС.

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

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

Результат:

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

Исключение:

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

class EJIO.ctk_extender.CopyableField(parent: Any, label_text: str, value_text: str, layout: Literal['row', 'column'] = 'row', geometry: Any = None, **kwargs: Any)

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

Информационное поле вывода данных с кнопкой копирования в буфер обмена. Поддерживает каноничное позиционирование подписи сверху (column) или в ряд (row).

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

Строит контейнер поля копирования с динамической сеткой.

copy_to_clipboard() → None

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

destroy() → None

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

class EJIO.ctk_extender.DatePicker(parent: Any, initial_date: date | None = None, on_select: Callable[[date], None] | None = None, geometry: Any = None, **kwargs: Any)

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

Интерактивный календарный виджет выбора даты. Полностью автономен, перерисовывает дни месяца на лету.

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

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

Результат:

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

Исключение:

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

class EJIO.ctk_extender.DictionaryChangedEvent(sender: Any, operation: str, key: K | None, value: V | None)

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

Событие, возникающее при изменении реактивного словаря (set, delete, clear).

property key: K | None

property operation: str

property sender: Any

Возвращает отправителя события.

property value: V | None

class EJIO.ctk_extender.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.Event(sender: Any = None)

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

Базовый абстрактный класс для всех событий. Каждое конкретное событие должно наследоваться от этого класса.

property sender: Any

Возвращает отправителя события.

property sender_thread_name: str

Возвращает имя потока, отправившего событие.

property timestamp: float

Возвращает UNIX-время создания события.

class EJIO.ctk_extender.EventListener(*args: tuple[object, ...], **kwargs: dict[str, object])

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

Вспомогательный класс-миксин или менеджер, автоматически связывающий декорированные методы объекта с глобальным EventController.

classmethod register_listeners(instance: Any) → None

Сканирует переданный объект на наличие методов с декоратором @on_event и автоматически подписывает их в EventController с учетом динамических отправителей.

Параметры:

instance: – Объект события которого нужно зарегестрировать.

classmethod unregister_listeners(instance: Any) → None

Автоматически отписывает все методы объекта от EventController.

Параметры:

instance – Объект события которого нужно отписать.

class EJIO.ctk_extender.FieldReturnEvent(sender: Any, field_name: str)

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

Триггерится при нажатии Enter внутри текстовых полей формы.

field_name: str

class EJIO.ctk_extender.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.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.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.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.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.FormLabeledField(parent: Any, name: str, label_text: str, placeholder: str = '', layout: Literal['row', 'column'] = 'row', required: bool = False, geometry: GeometryStrategy | None = None, **kwargs: Any)

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

Высокоуровневый составной компонент формы. Строится на базе WidgetContainer и использует внутри себя готовый FormTextField.

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

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

clear() → None

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

destroy() → None

Каскадно очищает ссылки и вызывает базовое уничтожение контейнера.

focus() → None

Перенаправляет фокус ввода внутреннему текстовому полю формы.

get_value() → str

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

property name: str

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

set_value(value: Any) → None

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

validate() → str | None

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

class EJIO.ctk_extender.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.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.FormReadyEvent(target_form: Any)

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

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

property target_form: Any

class EJIO.ctk_extender.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.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.FormSubmittedEvent(sender: Any, data: dict[str, Any])

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

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

property data: dict[str, Any]

class EJIO.ctk_extender.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.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.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.FormValidationErrorEvent(sender: Any, errors: dict[str, str])

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

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

property errors: dict[str, str]

class EJIO.ctk_extender.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.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.ImageWidget(parent: Any, source: str | Path | bytes | None = None, container_size: tuple[int, int] = (300, 300), forced_size: tuple[int, int] | None = None, placeholder_text: str = 'Изображение отсутствует', geometry: GeometryStrategy | None = None, **kwargs: Any)

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

Высокоуровневый интерактивный компонент для работы с изображениями на базе ctk.CTkCanvas. Поддерживает загрузку из строк-путей, объектов Path и сырых байт (bytes) в памяти.

build() → <MagicMock name='mock.CTkCanvas' id='140416946111408'>

Строит фиксированный по размеру холст-контейнер.

destroy() → None

Очищает тяжелые Pillow-ресурсы, закрывает буферы памяти и уничтожает холст.

update_source(new_source: str | Path | bytes) → None

Публичный метод: динамически загружает новое изображение в созданный контейнер.

class EJIO.ctk_extender.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.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.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.Layout(parent: <MagicMock name = 'mock.CTk.__or__().__or__()' id='140416957553632'>, geometry: GeometryStrategy | None = None)

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

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

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

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

destroy() → None

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

on_hide() → None

Хук жизненного цикла: макет скрыт (ушел вглубь стека или закрывается).

on_show() → None

Хук жизненного цикла: макет выведен на экран (стал активным).

class EJIO.ctk_extender.LoginForm(parent: Any, geometry: Any = None)

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

Высокоуровневый составной компонент формы авторизации.

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

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

class EJIO.ctk_extender.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.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.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.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.ReactiveDict(*args: Any, **kwargs: Any)

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

Реактивная событийная обертка над потокобезопасным словарем.

clear() → None

class EJIO.ctk_extender.ReactiveList(iterable: Iterable | None = None)

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

Реактивная обертка над потокобезопасным двусвязным списком. Любое изменение состава элементов порождает CollectionChangedEvent.

append(item: T) → None

Добавить элемент в конец коллекции.

clear() → None

Очистить коллекцию.

extend(iterable: Iterable) → None

Добавить все элементы из итерируемого объекта.

pop(index: int = -1) → T

Удалить и вернуть элемент по индексу.

remove(item: T) → None

Удалить первое вхождение элемента.

class EJIO.ctk_extender.ReactiveModel

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

Базовый класс-миксин для создания реактивных моделей и датаклассов. Любая модификация атрибутов автоматически генерирует StateChangedEvent.

class EJIO.ctk_extender.ScrollableContainer(parent: Any, geometry: Any = None, orientation: str = 'vertical', label_text: str = '', **kwargs: Any)

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

Потокобезопасный прокручиваемый контейнер. Позволяет динамически добавлять элементы через фабрику add_widget, автоматически управляя полосами прокрутки.

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

Строит нативный прокручиваемый фрейм customtkinter.

class EJIO.ctk_extender.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.Section(parent: Any, title_text: str, geometry: Any = None, **kwargs: Any)

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

Графическая секция: крупный заголовок по левому краю + прокручиваемый контейнер. Метод add_widget прозрачно проксирует добавление элементов прямо внутрь скролл-зоны.

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

Переопределенный метод: направляет виджеты строго внутрь скролл-зоны.

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

Строит каркас секции.

destroy() → None

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

class EJIO.ctk_extender.State(initial_value: T)

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

Потокобезопасный контейнер одиночного реактивного состояния. Любая перезапись значения автоматически транслирует событие в EventController.

property value: T

Возвращает текущее значение состояния.

class EJIO.ctk_extender.StateChangedEvent(sender: Any, new_value: T)

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

Событие, возникающее при изменении одиночного реактивного состояния.

property new_value: T

property sender: Any

Возвращает отправителя события.

class EJIO.ctk_extender.StyleFlags(*values)

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

Побитовые флаги оформления внешнего вида уведомлений. Позволяют декларативно конструировать фон, рамки и скругления.

BORDER_NONE = 16

BORDER_THICK = 64

BORDER_THIN = 32

DEFAULT = 41

FILLED = 1

ROUNDED = 8

SQUARE = 4

TRANSPARENT = 2

class EJIO.ctk_extender.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.TableWidget(parent: Any, data_list: ReactiveList[list[str]], headers: list[str] | None = None, max_visible_rows: int | None = None, placeholder_text: str = 'Нет данных для отображения', geometry: GeometryStrategy | None = None, **kwargs: Any)

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

Высокоуровневый реактивный компонент таблицы на базе ScrollableFrame. Автоматически перерисовывает строки при изменении привязанного ReactiveList. Использует менеджер разметки Grid для отрисовки ячеек.

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

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

destroy() → None

Очищает ячейки и каскадно уничтожает контейнер таблицы.

class EJIO.ctk_extender.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.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.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.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 – Экземпляр уничтожаемого виджета.

class EJIO.ctk_extender.Window(is_main: bool = False)

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

Абстрактный базовый класс окна приложения. Управляет собственным навигационным стеком макетов и системными событиями.

property active_layout_canvas: Any

Возвращает нативный Си-фрейм текущего активного макета, развернутого на экране.

center() → None

Математически точно центрирует окно по центру текущего активного монитора, на котором оно физически находится. Защищено от многомониторных сбоев.

config: WindowConfig = ('base_window', 'builtins.blank', 'Application default window', 800, 600, None, None, True, True)

property ctk_instance: <MagicMock name='mock.CTk.__or__()' id='140416957403200'>

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

destroy() → None

Каскадно уничтожает стек макетов окна, удаляет окно из глобального контроллера и закрывает физический ctk_instance.

focus() → Self

Переводит фокус ввода на данное окно и выводит его на передний план.

classmethod get_default_config() → WindowConfig

Возвращает базовый конфиг, если свойство класса не переопределено.

maximize() → Self

Разворачивает окно на весь доступный экран.

minimize() → Self

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

mount() → None

Вызывается фасадом Application сразу после успешного вывода окна на экран.

property name: str

Возвращает уникальное имя окна.

on_mounted() → None

Пользовательский хук жизненного цикла. Переопределяется в дочерних окнах.

pop_layout() → Self

Уничтожает текущий экран и пробуждает предыдущий из стека (Кнопка Назад).

push_layout(layout_name: str) → Self

Усыпляет текущий активный экран и пушит новый на вершину стека (мобильная навигация).

resize(width: int, height: int) → Self

Изменяет геометрические размеры окна.

restore() → Self

Восстанавливает нормальный размер окна (из свернутого или развернутого состояния).

property screenshot: Image

Делает скриншот текущего окна.

Параметры:

output_path – Путь для сохранения (опционально).

Результат:

Объект PIL Image.

switch_layout(layout_name: str) → Self

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

class EJIO.ctk_extender.WindowConfig(name: str = 'default_window', initial_layout: str | None = 'builtins.blank', title: str = 'Application default window', width: int = 800, height: int = 600, x_pos: int | None = None, y_pos: int | None = None, resizable_x: bool = True, resizable_y: bool = True)

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

Полная структура метаданных, геометрии и навигации окна.

height: int

Alias for field number 4

initial_layout: str | None

Alias for field number 1

name: str

Alias for field number 0

resizable_x: bool

Alias for field number 7

resizable_y: bool

Alias for field number 8

title: str

Alias for field number 2

width: int

Alias for field number 3

x_pos: int | None

Alias for field number 5

y_pos: int | None

Alias for field number 6

EJIO.ctk_extender.get_layout(window_name: str, layout_name: str) → type[Layout]

Безопасно извлекает класс макета для указанного окна.

Параметры:

• window_name – Имя управляющего окна (префикс).

• layout_name – Имя целевого макета.

Результат:

Класс Layout.

EJIO.ctk_extender.on_event(event_type: type[E], *, sender_attr: str | None = None, predicate: Callable[[E], bool] | None = None) → Callable[[Callable[[Any, E], None]], Callable[[Any, E], None]]

Декоратор для декларативной подписки методов класса на события. Полноценно оборачивает функцию, сохраняя метаданные для EventListener.

Параметры:

• event_type – Класс отслеживаемого события.

• sender_attr – Опционально: строка с именем атрибута экземпляра класса, который является отправителем (например, „state“ или „table“).

• predicate – Опционально: функция-фильтр условий.

Результат:

Функцию, обарачивающую указанный коллбэк для события.

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

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

EJIO.ctk_extender.popup_confirm(title: str, message: str, on_callback: Callable[[bool], None], /, *, timeout: float | None = None) → None

Выводит модальный диалог подтверждения с кнопками Да/Нет. Результат выбора (True/False) передается аргументом в on_callback.

EJIO.ctk_extender.popup_date(title: str, initial_date: date | None = None) → date | None

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

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

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

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

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

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

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

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

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

EJIO.ctk_extender.register_layout(key: str) → Callable[[type[E]], type[E]]

Декоратор для автоматической регистрации окон в LayoutRouter.

Параметры:

key – Ключ, под которым объект будет храниться в реестре.

Результат:

Обертку, выполняющую регистрацию класса.

EJIO.ctk_extender.register_window(window_cls: type[Window]) → type[Window]

Декоратор для автоматической регистрации окон в WindowRegistry.

EJIO.ctk_extender.set_appearance_mode(mode: Literal['System', 'Dark', 'Light'], /) → None

Устанавливает глобальный режим отображения темы интерфейса.

Допустимые значения: - „System“: Автоматическая синхронизация с темой операционной системы. - „Dark“: Принудительный темный режим оформления. - „Light“: Принудительный светлый режим оформления.

Параметры:

mode – Режим темы („System“, „Dark“, „Light“).

EJIO.ctk_extender.set_color_theme(theme: Literal['blue', 'green', 'dark-blue'], /) → None

Устанавливает базовую цветовую палитру (карту цветов) для виджетов CustomTkinter.

Допустимые значения: - „blue“: Классическая синяя цветовая схема. - „green“: Экологичная зеленая цветовая схема. - „dark-blue“: Современная темно-синяя палитра.

Параметры:

theme – Имя темы („blue“, „green“, „dark-blue“).