Основы > Интерфейс пользователя Creo Parametric > Меню "Файл" > Работа с файлами протоколов и обучения > Директивы для создания файлов обучения и файлов текста обучения
  
Директивы для создания файлов обучения и файлов текста обучения
Для создания файлов обучения и текстовых файлов обучения доступны следующие директивы. Директивы перечисляются в алфавитном порядке.
 
*Примечание Перед указанием требуется включить одинарную кавычку ( ` ).
Точка прерывания
Синтаксис
`breakpoint
Описание
Останавливает быстрое выполнение файла обучения и возвращает практиканта к пошаговому исполнению. Добавьте эту директиву после выбора меню, в котором нужно сделать разрыв.
Продолжить от метки
Синтаксис
`cont_at<label_name>
Описание
Заставляет файл обучения пропускать все команды и инструкции до тех пор, пока не будет найдена заданная метка. Затем выполнение продолжается из этой точки далее. Аргумент label_name может указать на метку, стоящую впереди в файле обучения, но не может указать назад.
Пример
`cont_at get_out
Перемещает выполнение файла обучения к метке get_out.
См. также
Имя маркера
Отобразить меню
Синтаксис
`display_menu menu_name
Описание
Показывает меню, которое уже было определено командой `menu_options. Для выбранного объекта выполняется действие, указанное в команде `menu_options.
Пример
`display_menuchoices
Отображает выборы в виде меню с именами. Предполагается, что меню уже было определено командой `menu_options.
См. также
Опции меню
Файл
Синтаксис
`filename
Описание
Определяет, какой текстовый файл инструктора используется с файлом обучения.
Можно указать только один такой файл; последующие команды `file не дадут результата.
Необходимо ввести только имя полного пути, если текстовый файл находится не в той же папке (имена путей могут содержать до 260 знаков). Если не указано имя пути, то система ищет файл в следующих папках в таком порядке:
Текущая папка
Папка, в которой находится файл обучения
Папка обучения, если определена в файле config.pro с опцией конфигурации TRAIN_PATH_FILE
Пример
`file text.txt
Файл text.txt связан с файлом обучения.
`file /usr/users/train/text.txt
Файл text.txt, расположенный в папке /usr/users/train, связан с файлом обучения.
Возобновление графики
Синтаксис
`graphics_resume
Описание
Восстанавливает графический режим после выполнения команды `graphics_stop. Если система не встретила предыдущую команду `graphics_stop, то не выполняется ничего.
См. также
Остановка графики
Остановка графики
Синтаксис
`graphics_stop
Описание
Останавливает помещение нового графического окна на экран. Данную команду можно использовать, чтобы скрыть определенную последовательность операций от ученика.
Можно выполнить все команды в файле протокола между данной директивой и `graphics_resume, но они не отображаются на экране. Геометрия, показанная в главном окне, фиксирована в точке перед командой, предшествующей директиве `graphics_stop. Меню не отображаются. Когда файл протокола достигает директиву `graphics_resume, система возобновляет нормальную геометрию и показывает меню.
Пример
См. также
Возобновление графики
Игнорировать
Синтаксис
`ignore
Описание
Можно использовать в других командах для замены действия или аргумента. При замене действия система ничего не делает. При замене аргумента система использует значение по умолчанию.
Пример
`menu_options choices continue `ignore `ignore skip `cont_at dome_feature
Имя маркера
Синтаксис
`marker label_name
Описание
Определяет метку в файле обучения, которая может использоваться как ссылка цели для перехода.
Пример
`marker get_out
Определяет метку, названную get_out в файле обучения.
См. также
Продолжить от метки
Опции меню
Синтаксис
`menu_options menu_nameitem 1_name action1 {arg1} {item2_name action2 {arg2}...}
Описание
Разрешает определить меню для показа ученику во время выполнения файла обучения. Аргумент menu_name является именем, с помощью которого определяется меню.
В меню может быть любое количество объектов. Каждое определение объекта должно иметь команду действия и аргумент, в случае необходимости. Можно использовать `ignore для действий и аргументов.
Число символов в menu_name и в любом его объекте не может превышать 20.
Пример
`menu_options choices quit `cont_at get_out continue `ignore `ignore skip `cont_at dome_feature.
См. также
Имя маркера
Тип файла без остановки
Синтаксис
`nostop_typefile
Описание
Возвращает управление ИНФОРМАЦИОННЫМ ОКНОМ модулю Creo Parametric после команды ``stop_typefile. Если не было предыдущей команды `stop_typefile, ничего не происходит.
Пример
`nostop_typefile
ИНФОРМАЦИОННОЕ ОКНО (отличное от окна с текстом инструктора) быстро прокручивается.
См. также
Тип файла стоп
Пауза
Синтаксис
`pause line number
Описание
Останавливает выполнение файла обучения, пока вы не нажмете "Восстановить".
Пример
`pause 74
Подсказка
Синтаксис
`prompt number
Описание
Показывает подсказку в окне сообщения. Аргумент number это число блоков в текстовом файле обучения.
Пример
`prompt 77
Показывает первую линию текстового блока номер 77 в связанном текстовом файле в окне сообщения.
См. также
Файл
Текст
Задать окно вывода
Синтаксис
`set_window_output
Описание
Восстанавливает операции обычного файла обучения для вывода сообщения.
См. также
Сбросить окно вывода
Тип файла стоп
Синтаксис
`stop_typfile
Описание
Передает управление над изображением ИНФОРМАЦИОННОГО ОКНА ученику, предоставляя возможность листать страницы назад и вперед, и т. д.
При выполнении файла обучения информация Creo Parametric (например, информация о конструкторском элементе и расчеты массовых свойств) отображается в ИНФОРМАЦИОННОМ ОКНЕ. Если сообщение в ИНФОРМАЦИОННОМ ОКНЕ имеет несколько страниц, они быстро прокручиваются и времени для их просмотра не будет. Данная директива позволяет ученику управлять изображением.
Данная команда не влияет на показ текста ученику. Чтобы выключить эту команду, используйте команду`nostop_typefile.
См. также
Тип файла без остановки
Текст
Синтаксис
`text<number>
Описание
Укажите, какой блок текстового файла будет показан в ИНФОРМАЦИОННОМ ОКНЕ в указанном интервале во время выполнения файла обучения. Добавьте эту директиву после выбора меню, где нужно сделать разрыв.
Каждый блок текста можно показать в любое время, в любом порядке. Также разрешены повторяющиеся показы блоков.
Пример
`text 44
Показывает текстовый блок номер 44.
Подсказки текстового окна
Синтаксис
`textwindow_hints {px py} {rows cols}
Описание
Позволяет изменить размер и положение ИНФОРМАЦИОННОГО ОКНА с текстом инструктора. В синтаксисе px и py представляют горизонтальное и вертикальное положение текстового окна (его левый нижний угол) относительно главного окна. Аргумент rows определяет число строк в текстовом окне, и cols определяет число столбцов в текстовом окне.
Можно пропустить любую пару параметров, тогда будут использоваться параметры системы по умолчанию. (Для исключения первой пары замените ее на две команды `ignore.) Если значение какого-либо параметра находится вне диапазона, система использует значения по умолчанию. Таблица "Параметры команды" перечисляет системные значения по умолчанию и допустимые диапазоны параметров.
Пример
`textwindow_hints 0.1 0.1 8 80
Размер ИНФОРМАЦИОННОГО ОКНА будет 8 строк на 80 столбцов. Его началом будет смещение в 0,1, 0,1 относительно главного окна.
`textwindow_hints `ignore `ignore 30 70
В данном примере задается только размер окна (30 строк на 70 столбцов). Начало ИНФОРМАЦИОННОГО ОКНА будет находиться в месте, заданном по умолчанию.
См. также
Игнорирование
Сбросить вывод окна
Синтаксис
`unset_window_output
Описание
Удаляет текст ИНФОРМАЦИОННОГО ОКНА и направляет вывод сообщения в окно сообщения.
См. также
Задать окно вывода
Ввод пользователя
Синтаксис
`user_input keyboard_data {fail} {succ} {giveup} {retries}
Описание
Заставляет ученика ввести данные с клавиатуры в определенный момент выполнения файла обучения.
Возможны следующие аргументы.
keyboard_data - строка данных с клавиатуры дублируется из файла обучения.
fail - данное сообщение отображается, если пользователь не ввел ожидаемые данные. Форматом является команда `text. Только первая строка заданного текстового блока отображается. Если данный аргумент заменить на "игнорировать", отображается сообщение по умолчанию.
succ - данное сообщение отображается, если пользователь ввел ожидаемые данные. Форматом является команда `text. Только первая строка заданного текстового блока отображается. Если заменить аргумент на `ignore, то будет отображаться сообщение по умолчанию.
giveup - данное сообщение отображается, если пользователь превысил максимально допустимое число повторных попыток, которое указывается в аргументе retries. Форматом является команда `text. Только первая строка заданного текстового блока отображается. Если заменить аргумент на `ignore, то будет отображаться сообщение по умолчанию.
retries - максимально допустимое число попыток. Если аргумент не указан или заменен на ignore, система использует значение по умолчанию (5).
Командная строка `user_input является дубликатом, а не заменой существующей строки данными, введенными с клавиатуры, в файле обучения. Чтобы составить эту команду, скопируйте строку данных с клавиатуры и добавьте `user_input командный префикс. Разместите команду над фактической строкой данных с клавиатуры.
Пример
`user_input 0.5
0.5
Данный пример показывает основную команду `user_input, использующую спецификаторы сообщения по умолчанию. Вторая строка является строкой действительного файла протокола.
``user_input 0.5 'text 67 `ignore `ignore 20.5
Данный пример определяет сообщение о сбое (первая строка блока номер 67 в связанном текстовом файле) и разрешает две попытки. Вторая строка является строкой действительного файла протокола.
См. также
Игнорировать
Выбор меню пользователя
Выбор пользователя
Выбор меню пользователя
Синтаксис
`user_menu_pick command {fail} {succ} {giveup} {retries}
Описание
Заставляет ученика произвести выбор меню в определенный момент выполнения файла обучения.
Возможны следующие аргументы.
command - командная строка меню дублируется из файла обучения. Символ # сохранен.
fail - данное сообщение показывается, если пользователь не сделал ожидаемый выбор меню. Форматом является команда `text. Только первая строка заданного текстового блока отображается. Если заменить аргумент на `ignore, то будет отображаться сообщение по умолчанию.
succ - данное сообщение показывается, если пользователь успешно сделал ожидаемый выбор меню. Форматом является команда `text. Только первая строка заданного текстового блока отображается. Если заменить аргумент на `ignore, то будет отображаться сообщение по умолчанию.
giveup - сообщение, которое показывается, если пользователь достиг максимально допустимого числа повторных попыток, которое указывается в следующем аргументе. Форматом является команда `text. Только первая строка заданного текстового блока отображается. Если заменить аргумент на `ignore, то будет отображаться сообщение по умолчанию.
retries - максимально допустимое число попыток. Если данный аргумент не указан или заменен на ignore, система использует значение по умолчанию (5).
Командная строка `user_menu_pick является дубликатом, а не заменой существующей строки выбора меню в файле обучения. Чтобы составить эту команду, скопируйте строку выбора меню и добавьте командный префикс `user_menu_pick. Разместите команду над фактической строкой выбора меню.
 
*Примечание Эта функция доступна только для стандартных опций Creo Parametric. Она недоступна для определяемых пользователем опций (определяемых с помощью функций "Опции меню" (Menu Options) и "Показать меню" (Display Menu)).
Пример
`user_menu_pick #DIMENSION
#DIMENSION
Данный пример показывает основную команду `user_menu_pick, использующую все спецификаторы сообщений по умолчанию. Вторая строка является строкой действительного файла протокола.
`user_menu_pick #REGENERATE `ignore `text 78`ignore 3 #REGENERATE
Данный пример определяет сообщение об успешном выполнении (первая строка блока номер 78 в связанном текстовом файле) и разрешает три попытки. Вторая строка является строкой действительного файла протокола.
См. также
Игнорировать
Ввод пользователя
Выбор пользователя
Выбор пользователя
Синтаксис
`user_pick x y b {fail} {succ} {giveup} {retries}
Описание
Заставляет ученика произвести выбор графики в определенный момент выполнения файла обучения.
Возможны следующие аргументы.
x, y, b - координаты XY и код кнопки выбора дублируются из файла обучения.
fail - данное сообщение показывается, если пользователь не сделал ожидаемый выбор. Форматом является команда `text. Только первая строка заданного текстового блока отображается. Если вы замените аргумент на `ignore, то будет отображаться сообщение по умолчанию.
succ - данное сообщение показывается, если пользователь успешно сделал ожидаемый выбор. Форматом является команда `text. Только первая строка заданного текстового блока отображается. Если вы замените аргумент на `ignore, то будет отображаться сообщение по умолчанию.
giveup - сообщение, которое показывается, если пользователь достиг максимально допустимого числа повторных попыток, которое указывается в следующем аргументе. Форматом является команда `text. Только первая строка заданного текстового блока отображается. Если вы замените аргумент на `ignore, то будет отображаться сообщение по умолчанию.
retries - максимально допустимое число попыток. Если аргумент не указан или заменен на `ignore, система использует значение по умолчанию (5).
Командная строка `user_pick является дубликатом, а не заменой существующего выбора в файле обучения. Чтобы составить эту команду, скопируйте строку выбора и добавьте командный префикс `user_pick. Разместите команду над фактической строкой выбора.
Пример
`user_pick 0.427022 0.495110 L 0.427022 0.495110 L
Данный пример показывает основную команду `user_pick со всеми спецификаторами сообщений по умолчанию. Вторая строка является строкой действительного файла протокола.
`user_pick 0.427022 0.495110 L `text 43 `ignore `ignore 15 0.427022 0.495110 L
Данный пример определяет сообщение о сбое (первая строка блока номер 43 в связанном текстовом файле) и разрешает пятнадцать попыток. Вторая строка является строкой действительного файла протокола.
См. также
Игнорировать
Выбор меню пользователя