[ Страница назад | Страница вперед | Содержание | Индекс | Библиотека | Юридическая информация | Поиск ]

Программирование: Разработка и отладка программ


Класс объектов sm_cmd_hdr (заголовок окна диалога SMIT)

Заголовок окна диалога хранится в объекте sm_cmd_hdr. Этот объект создается для каждого окна диалога и указывает на объекты опций команд окна диалога, связанные с данным окном.

Примечание: При программировании объекта данного объектного класса обозначайте пустые строки парой двойных кавычек (""), а пустые целые поля - нулем (0).

Существуют следующие дескрипторы класса sm_cmd_hdr:

id Идентификатор или имя объекта. Значение поля id - строка длиной до 64 символов. Если с данным окном диалога не связан список вариантов, то поле id можно применять в качестве идентификатора команды быстрого доступа. Идентификатор должен быть уникален как в приложении, так и в системе.
option_id Идентификатор объектов sm_cmd_opt (полей окна диалога), на которое указывает данный заголовок. Значение поля option_id - строка длиной не более 64 символов.
has_name_select Указывает, будет ли перед данным окном выдаваться меню или окно со списком вариантов. Допустимы следующие значения:

"" или "n"
Нет; это значение по умолчанию.

"y"
Да; перед этим объектом будет выдаваться список вариантов. Если указано это значение, то id данного объекта не может применяться в качестве команды быстрого доступа к соответствующему окну диалога.
name Текст, который будет выдаваться в качестве заголовка окна диалога. Значение поля name - строка длиной не более 1024 символов. Текст представляет собой описание задачи, выполняемой данным окном диалога. Строка может быть отформатирована и может содержать символы новой строки (\n).
name_msg_file Неполное имя файла для каталога Средств работы с сообщениями, применяемого для строки name. Значение поля name_msg_file - строка длиной не более 1024 символов. Средства работы с сообщениями можно применять для создания каталогов сообщений прикладных программ.
name_msg_set Идентификатор набора Средств работы с сообщениями для строки name. Эти идентификаторы могут применяться для указания подкаталогов одного и того же каталога. Поле name_msg_set - целого типа.
name_msg_id Идентификатор Средства работы с сообщениями для строки name. Идентификаторы сообщений можно создавать средствами выбора сообщений, входящими в состав Средств работы с сообщениями. Поле name_msg_id - целого типа.
cmd_to_exec Начальная часть командной строки, которая состоит из самой команды, выполняющей требуемое действие, или из команды и постоянного набора некоторых опций. Остальные опции добавляются автоматически при работе пользователя с объектами опций команды (sm_cmd_opt), связанными с данным окном диалога. Значение поля cmd_to_exec - строка длиной до 1024 символов.
ask Указывает, должна ли система предлагать пользователю еще раз проверить выбранные варианты, перед тем как приступить к выполнению задачи. Допустимы следующие значения:

"" или "n"
Нет; не требовать от пользователя подтверждения выбора; выполнение задачи начинается при фиксации изменений в окне диалога. Для дескриптора ask это значение по умолчанию.

"y"
Да; выполнение задачи начинается только после того, как она будет подтверждена пользователем.

Запрос на подтверждение особенно полезен в тех случаях, когда выполняются задачи по удалению каких-либо объектов, причем удаляемые ресурсы трудно или невозможно восстановить, или когда с задачей не связано окно диалога (т.е. в поле ghost указано значение "y").

exec_mode Задает режим обработки стандартного ввода, стандартного вывода и файла stderr при выполнении задачи. Значение exec_mode - строкового типа. Допустимы следующие значения:

"" или "p"
Конвейерный режим; для дескриптора exec_mode это значение по умолчанию. Стандартный вывод команды и файл stderr перенаправляются в программу SMIT. Стандартным выводом команды управляет SMIT. После завершения задачи выходные данные сохраняются и могут быть просмотрены пользователем в режиме прокрутки. При необходимости вывод команды можно прокручивать на экране и во время выполнения задачи.

"n"
Конвейерный режим без прокрутки; аналогичен режиму "p" за исключением того, что нельзя прокручивать информацию на экране во время выполнения задачи. При запуске задачи появляется окно вывода, которое остается на экране все время, пока выполняется задача. После завершения задачи выходные данные сохраняются и могут быть просмотрены пользователем в режиме прокрутки.

"i"
Режим наследования; стандартный ввод, вывод и stderr команды наследуется дочерним процессом, в котором выполняется задача. В этом режиме управление вводом и выводом передается выполняемой команде. Рекомендуется указывать это значение для команд, которым необходимо записывать данные в файл /dev/tty, выполнять адресацию курсора или работать с библиотеками libcur или libcurses.

"e"
Режим "выход/выполнение"; в этом режиме SMIT запускает команду в текущем процессе (вызывает функцию execl), после чего программа SMIT завершается. Рекомендуется указывать этот режим для команд, несовместимых с программой SMIT (которые, например, изменяют режимы просмотра или размеры шрифтов). Будет выдано предупреждение о том, что перед запуском команды программа SMIT будет завершена.

"E"
То же, что и "e", но без выдачи предупреждения о выходе из программы SMIT.

"" или "p"
Режимы с восстановлением предыдущего состояния. Аналогично режимам "p", "n" и "i", за исключением того, что если при выходе из команды cmd_to_exec возвращается значение 0, то SMIT переходит в ближайшее предыдущее меню, к списку вариантов (если он существует) или в командную строку.
ghost Указывает, должно ли быть скрыто окно диалога, обычно показываемое на экране. Значение ghost - строчная константа. Допустимы следующие значения:

"" или "n"
Нет; окно диалога, связанное с задачей, будет показано на экране. Это значение по умолчанию.

"y"
Да; окно диалога, связанное с задачей, не показывается, так как от пользователя больше не требуется никакой информации. Команда, указанная в дескрипторе cmd_to_exec, начнет выполняться сразу, как только пользователь выберет данную задачу.
cmd_to_discover Задает текст команды, используемой для получения значений по умолчанию или текущих значений для обрабатываемого объекта. Значение cmd_to_discover - строка длиной до 1024 символов. Команда выполняется перед открытием окна диалога; считываются ее выходные данные. Выходные данные должны быть в формате с двоеточиями.
cmd_to_discover_postfix Постфикс, который анализируется и добавляется к тексту команды, заданному в поле cmd_to_discover. Значение cmd_to_discover_postfix - строка длиной не более 1024 символов.
help_msg_id Поле, в котором задается номер набора сообщений Средства работы с сообщениями и (через запятую) идентификатор сообщения, либо строка цифр, совпадающая с тегом идентификатора SMIT.
help_msg_loc Имя файла, передаваемого в качестве параметра команде man для поиска текста справки, либо имя файла, содержащего текст справки. Значение help_msg_loc - строка длиной до 1024 символов.
help_msg_base Полное имя библиотеки, в которой SMIT ищет имена файлов, связанные с нужным томом справки.
help_msg_book Содержит строку с именем файла из библиотеки, указанной в help_msg_base.

Инструкции по получению справки SMIT с помощью полей help_msg_id, help_msg_loc, help_msg_base и help_msg_book приведены в разделах Разделы справки man, Электронные библиотеки и Каталог сообщений главы Создание справки по новой задаче SMIT.

Связанная информация

Команда smit.


[ Страница назад | Страница вперед | Содержание | Индекс | Библиотека | Юридическая информация | Поиск ]