10.7. Модуль gui¶

Модуль cerebro.gui предоставляет доступ к простым графическим интерфейсам, таким как диалоги ввода, выбора файлов, индикатор прогресса и т.д.

Функции

critical_box()
get_existing_directory()
get_open_file_name()
get_open_file_names()
get_save_file_name()
information_box()
message_editor()
question_box()
warning_box()

Классы

cerebro.gui.critical_box(title, text)[исходный код]¶

Параметры:	title (string) – заголовок окна. text (string) – текст сообщения.

Показывает пользователю окно c ошибкой.

cerebro.gui.get_existing_directory(title)[исходный код]¶

Параметры:	title (string) – заголовок диалога выбора.
Результат:	путь до выбранной директории.
Тип результата:	string

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

dir = cerebro.gui.get_existing_directory('Выберите директорию')
if dir != None:
        print('Выбранная директория', dir)      

cerebro.gui.get_open_file_name(title, filter='')[исходный код]¶

Параметры:	title (string) – заголовок диалога выбора. filter (string) – фильтр файлов по типу, например `'.txt'`. Если вы хотите использовать несколько фильтров, разделяйте их „;;“, например: 'Images (.png .xpm .jpg);;Text files (.txt);;XML files (.xml)'
Результат:	путь до выбранного файла.
Тип результата:	string

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

file = cerebro.gui.get_open_file_name('Выберите файл', '*.txt')
if file != None:
        print('Выбранный файл', file)   

См.также

get_open_file_names().

cerebro.gui.get_open_file_names(title, filter='')[исходный код]¶

Параметры:	title (string) – заголовок диалога выбора. filter (string) – фильтр файлов по типу, например `'.txt'`. Если вы хотите использовать несколько фильтров, разделяйте их „;;“, например: 'Images (.png .xpm .jpg);;Text files (.txt);;XML files (.xml)'
Результат:	список путей до выбранных файлов.
Тип результата:	list(string,)

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

files = cerebro.gui.get_open_file_names('Выберите файлы', '*.txt')
if files != None:
        print('Выбранные файлы', files)

См.также

get_open_file_name().

cerebro.gui.get_save_file_name(title, suffix, filename='')[исходный код]¶

Параметры:	title (string) – заголовок диалога выбора. suffix (string) – суффикс(расширение) файла. filename (string) – имя файла по умолчанию.
Результат:	путь до выбранного файла.
Тип результата:	string

Показывает пользователю диалог выбора файла для сохранения и возвращает выбранный. Если пользователь отменил выбор, возвратиться None.

file = cerebro.gui.get_save_file_name('Сохранить файл',  'txt')
if file != None:
        print('Файл для сохранения', file)

cerebro.gui.information_box(title, text)[исходный код]¶

Параметры:	title (string) – заголовок окна. text (string) – текст сообщения.

Показывает пользователю окно c информацией.

cerebro.gui.message_editor(type, task_id, parent_message_id=None, html_text=None, attachments=None, attachment_as_links=None, work_time=None, status_id=None, client_visible=None)[исходный код]¶

Параметры:

type (int) – тип сообщения.
task_id (int) – идентификатор задачи, к которой будет добавлено сообщение.
parent_message_id (int) – идентификатор родительского сообщения, то есть сообщения на которое это сообщение является ответом.
html_text (string) – текст сообщения в формате html. Текст может быть и без форматирования.
attachments (list(string,)) – список файлов, которые будут приложены к сообщению.
attachment_as_links (list(string,)) – список файлов, которые будут добавлены к сообщению как сссылки.
work_time (float) – время в минутах.
status_id (int) – идентификатор статуса задачи, в который перейдет задача после отправки сообщения.
client_visible (bool) – Если равен True, сообщение устанавливается как видимое для клиентов.

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

Все аргументы, кроме типа сообщения и идентификатора задачи, необязательны. Если какие-то из параметров сообщения не нужно изменять, передавайте вместо нех None.

Файлы или линки на файлы в списках attachments и attachment_as_links должны иметь полный путь.

Чтобы задать статус задачи в „Нет статуса“, передайте арнумент status_id равный 0.

Аргумент work_time имеет смысл задавать только для отчетов или рецензий. Если тип сообщения "Отчет" или "Отчет за ресурс", рабочее время означает заявленное время работы. Если тип сообщения "Рецензия", рабочее время означает принятое время работы за предыдущий отчет.

current_task = cerebro.core.current_task()
cerebro.gui.message_editor(cerebro.aclasses.AbstractMessage.TYPE_NOTE, current_task.id(), None, 'Test')         

cerebro.gui.question_box(title, text)[исходный код]¶

Параметры:	title (string) – заголовок окна. text (string) – текст вопроса.
Результат:	True, если пользователь нажал кнопку «Да».
Тип результата:	bool

Показывает пользователю диалог с вопросом.

cerebro.gui.warning_box(title, text)[исходный код]¶

Параметры:	title (string) – заголовок окна. text (string) – текст сообщения.

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