¶ 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)
| Параметры: | |
cerebro.gui.get_existing_directory(title)
| Параметры: | title (string) – заголовок диалога выбора. |
| Результат: | путь до выбранной директории. |
| Тип результата: | string |
dir = cerebro.gui.get_existing_directory('Выберите директорию')
if dir:
print('Выбранная директория', dir)
cerebro.gui.get_open_file_name(title, filter='')
| Параметры: | Если вы хотите использовать несколько фильтров, разделяйте их „;;“, например: 'Images (*.png .xpm .jpg);;Text files (.txt);;XML files (.xml)' |
| Результат: | путь до выбранного файла. |
| Тип результата: | string |
Показывает пользователю диалог выбора файла и возвращает выбранный. Если пользователь отменил выбор, возвратиться None.
file = cerebro.gui.get_open_file_name('Выберите файл', '*.txt')
if file:
print('Выбранный файл', file)
См.также
cerebro.gui.get_open_file_names(title, filter='')
| Параметры: | Если вы хотите использовать несколько фильтров, разделяйте их „;;“, например: |
| Результат: | список путей до выбранных файлов. |
| Тип результата: | list(string,) |
Показывает пользователю диалог выбора одного и более файлов и возвращает выбранные. Если пользователь отменил выбор, возвратиться None.
files = cerebro.gui.get_open_file_names('Выберите файлы', '*.txt')
if files:
print('Выбранные файлы', files)
См.также
cerebro.gui.get_save_file_name(title, suffix, filename='')
| Параметры: | |
| Результат: | путь до выбранного файла. |
| Тип результата: | string |
Показывает пользователю диалог выбора файла для сохранения и возвращает выбранный. Если пользователь отменил выбор, возвратиться None.
file = cerebro.gui.get_save_file_name('Сохранить файл', 'txt')
if file:
print('Файл для сохранения', file)
cerebro.gui.information_box(title, text)
| Параметры: | |
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)
| Параметры: | |
Все аргументы, кроме типа сообщения и идентификатора задачи, необязательны. Если какие-то из параметров сообщения не нужно изменять, передавайте вместо них 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)
| Параметры: | |
| Результат: | True, если пользователь нажал кнопку «Да». |
| Тип результата: | bool |
Показывает пользователю диалог с вопросом.
cerebro.gui.warning_box(title, text)
| Параметры: | |
¶ 10.7.1. Класс cerebro.gui.AccountDialog
classcerebro.gui.AccountDialog(title, label='', store_key='')
| Параметры: | |
¶ Методы
daccount = cerebro.gui.account_dialog('Пример', 'Введите ваш логин и пароль', 'store_key')
res = daccount.execute()
if res == True:
print('Введенные пользователем логин и пароль', daccount.login(), daccount.password())
daccount.store('store_key') # сохраняем пароль для последующих вызовов
execute()
| Результат: | True, если пользователь ввел логин и пароль и нажал кнопку Ok, либо логин и пароль были сохранены ранее. |
| Тип результата: | bool |
Если логин и пароль были сохранены при прошлом вызове, диалог не будет показан, вернётся значение True и далее вы можете получить логин и пароль воспользовавшись методами login() и password().
login()
| Результат: | введенный пользователем логин. |
| Тип результата: | string |
См.также
password()
| Результат: | введенный пользователем пароль. |
| Тип результата: | string |
set_login(login)
| Параметры: | login (string) – логин. |
См.также
store(store_key, expires=7)
| Параметры: | |
Примечание
Все пароли сохраняются в зашифрованном виде.
¶ 10.7.2. Класс cerebro.gui.InputDialog
classcerebro.gui.InputDialog(type, title, label='', storeKey='')
| Параметры: | |
Класс диалога ввода.
¶ Методы
- display_format()
- execute()
- items()
- max()
- min()
- set_display_format()
- set_items()
- set_range()
- set_value()
- type()
- value()
dinput = cerebro.gui.input_dialog(cerebro.gui.InputDialog.TYPE_INT, 'Пример ввода', 'Введите')
dinput.set_range(-100, 100)
dinput.set_value(10)
res = dinput.execute()
if res == True:
print('Введенное пользователем значение', dinput.value())
display_format()
| Результат: | формат, используемый для отображения даты и времени. |
Применяется только для типа cerebro.gui.InputDialog.TYPE_DATETIME
См.также
execute()
| Результат: | значение True, если пользователь ввел значение и нажал кнопку Ok. |
| Тип результата: | bool |
items()
| Результат: | список для выбора значения. |
| Тип результата: | list(string,) |
Применяется только для типа cerebro.gui.InputDialog.TYPE_COMBOBOX.
См.также
max()
| Результат: | максимальное значение для ввода. |
Применяется только для типов cerebro.gui.InputDialog.TYPE_FLOAT и cerebro.gui.InputDialog.TYPE_INT
См.также
min()
| Результат: | минимальное значение для ввода. |
Применяется только для типов cerebro.gui.InputDialog.TYPE_FLOAT и cerebro.gui.InputDialog.TYPE_INT
См.также
set_display_format(format)
| Параметры: | format (string) – формат, используемый для отображения даты и времени. |
Пример:
dinput.set_display_format('yyyy.MM.dd hh:mm") # for example: 2014.01.01 13:09
Применяется только для типа cerebro.gui.InputDialog.TYPE_DATETIME
См.также
set_items(items)
| Параметры: | items (list(string,)) – список для выбора значения. |
Применяется только для типа cerebro.gui.InputDialog.TYPE_COMBOBOX.
См.также
set_range(min, max)
| Параметры: | |
Применяется только для типов cerebro.gui.InputDialog.TYPE_FLOAT и cerebro.gui.InputDialog.TYPE_INT
См.также
set_value(val)
| Параметры: | val – значение по умолчанию. |
Тип входного аргумента определяется типом диалога ввода.
См.также
type()
| Результат: | тип вводимого значения. |
| Тип результата: | int |
value()
| Результат: | введенное пользователем значение. |
См.также
¶ 10.7.3. Класс cerebro.gui.ProgressBox
classcerebro.gui.ProgressBox(title, min=0, max=100)
| Параметры: | |
¶ Методы
- close()
- hide_cancel_button()
- label()
- max()
- min()
- reset()
- set_label()
- set_range()
- set_title()
- set_value()
- show()
- title()
- value()
- was_canceled()
prgbar = cerebro.gui.ProgressBox('Окно прогресса', 0, 100)
prgbar.set_label('Прогресс...')
prgbar.show()
for i in range(0,100):
if prgbar.was_canceled() == True: # проверяем, не отменил ли пользователь операцию
break
prgbar.set_value(i)
prgbar.close()
close()
Закрывает окно прогресса.
См.также
hide_cancel_button()
Скрывает кнопку отмены.
Если вы не хотите давать пользователю возможность отменить операцию, вызовите этот метод. Если вы оставляете возможность отмены пользователю, вам следует обрабатывать метод was_canceled() для того, чтобы узнать о нажатии пользователем кнопки отмены.
label()
| Результат: | текстовая метка. |
| Тип результата: | string |
См.также
max()
| Результат: | максимальное значение прогресса. |
| Тип результата: | int |
См.также
min()
| Результат: | минимальное значение прогресса. |
| Тип результата: | int |
См.также
reset()
Сбрасывает значение прогресса в минимальное значение.
set_label(label)
| Параметры: | label (string) – текстовая метка. |
См.также
set_range(min, max)
| Параметры: | |
См.также
set_title(title)
| Параметры: | |
См.также
set_value(value)
| Параметры: | value (int) – значение прогресса. |
См.также
show()
Показывыает окно прогресса.
См.также
title()
| Результат: | заголовок окна прогресса. |
| Тип результата: | string |
См.также
value()
| Результат: | значение прогресса. |
| Тип результата: | int |
См.также
was_canceled()
| Результат: | True, если пользователь нажал кнопку отмены. |
| Тип результата: | bool |