Anchouss -маленькая рыбка. Эмблема Clubrus!

Реклама в Интернет & Все кулички
Добро пожаловать !
Добавить в избранное
CLUBRUS  На главную
Наиболее полный каталог ссылок  Найди свой русификатор!
    Русификаторы
    От Clubrus
    Партнеры
Программы  Программы
    Нужные
    Интересные
    Заработок
   
Ученье свет!   Учимся вместе
Клуб  Клуб
    Регистрация
    Вход
Форум !   Форум !
Гостевая  Гостевая
     Посмотреть
     Написать
Реклама на сайте   Реклама





Макросы

Имеется множество макросов, помимо описанных выше KLink и ALink, которые можно использовать при разработке справки. Они могут запускаться из «горячих областей» — выделенных словосочетаний, кнопок и т.д., или при открытии той или иной темы, или при открытии справки в целом. Рассмотрение этих макросов выходит за рамки данной статьи. Все они хорошо описаны в файле справки Hcw.hlp, который может быть вызван непосредственно из Windows или из Microsoft Help Workshop. Большинство этих макросов позволяют работать с кнопками окна справки, с меню, создавать и уничтожать элементы списков и т.д. Рассмотрим коротко только некоторые из них.

Отметим прежде всего макросы, позволяющие оперировать с файлами внешних программ. Эти макросы, введенные в WinHelp 4.0:

              Макрос

Описание

          ControlPanel

Открывает заданный элемент (файл.cpl) программы «Контрольная панель».

 

ExecFile

 

Зпускает указанную программу или открывает файл и запускает связанную  ним программу

 

FileExist

 

Проверяет наличие указанного файла на компьютере пользователя.

 

ShellExecute

Открывает, печатает или запускает файл или программу

 

ShortCut

 

Запускает указанную программу, если она еще не запущена, или активизирует ее и передает ее сообщение WM_COMMAND

 


Впрочем, и в более ранних версиях WinHelp, даже в Windows 3.x имелся макрос ExecProgram, позволяющий запускать внешние программы.

Не останавливаясь детально на синтаксисе макросов, описанном в справке по подготовке Help, рассмотрим несколько примеров.

Приведенный ниже оператор создает кнопку, при нажатии на которую запускается элемент «Контрольной Панели» Дата/время.

{button Дата/время, ControlPanel(Timedate)}

Следующий оператор создает кнопку, при нажатии на которую запускается программа Windows «Калькулятор».

{button Калькулятор, ExecFile(Calc.exe)}

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

{button Topics.rtf, ExecFile(Topics.rtf)}

Следующий оператор проверяет, есть ли на компьютере файл приложения my-app.exe. Если есть, то это приложение запускается. В противном случае осуществляется переход на тему с идентификатором install.

IfThenElse(FileExist(myapp.exe), ExecFile(myapp), Jumpld(in-stall_my_app))

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

Макрос

BrowseButtons()

создает в полосе кнопок заголовка окна справки кнопки просмотра вперед и назад (кнопки » и «). Эти кнопки обычно имеет смысл включать только при использовании в темах сносок упорядочивания +.

Макрос CreateButton создает в полосе кнопок заголовка окна справки новую кнопку с указанным именем, соответствующую указанному макросу. Синтаксис макроса CreateButton следующий:

CreateButton("<идентификатор>", "<надпись>", "<макрос>")

Здесь <идентафикатор> — внутренний идентификатор кнопки (произвольный), который можно использовать, если вы потом захотите, например, в каких-то темах удалить эту кнопку. <надпись> — это то, что будет написано на кнопке. А <макрос> — тот макрос, который будет выполняться при щелчке на этой кнопке.

Например, макрос

CreateButton("History", "&История", "History ()")

создаст кнопку с надписью История, при щелчке на которой будет выполняться макрос History(), отображающий окно со списком до сорока последних тем, просмотренных пользователем. Из этого списка пользователь может выбрать тему, к которой он хочет вернуться.

В заключение приведем несколько макросов, позволяющих добавлять новые меню и разделы в полосу меню окна справки. Первый из этих макросов — Insert-Menu, добавляющий новое меню. Его синтаксис:

InsertMenu("<идентификатор меню>","<надпись>", <номер>)

Здесь <идентификатор меню> — внутренний идентификатор меню, который можно использовать при последующих ссылках, <надпись> — надпись раздела, <номер> — порядковый номер меню (меню нумеруются слева направо, начиная с 0).

Второй макрос — Appendltem, вставляющий раздел в конец указанного меню. Его синтаксис:

Appendltem("<идентификатор меню>", "<идентификатор раэдела>", "<надпись>", "<макрос>")

Здесь <идентификатор меню> и <идентификатор раздела> — внутренние идентификаторы, используемые в справке для последующих ссылок на меню и его раздел, <надпись> — надпись, которая появится в меню, <макрос> — макрос или макросы, которые должны выполняться при выборе пользователем данного раздела меню.

Приведем пример совместного использования этих макросов. Операторы

InsertMenu("mexit","Выход",5)
Appendltem("mexit","exit","Выход","exit()")


заносят в полосу меню окна справки меню Выход на 5-е место и заносят в него раздел Выход, в котором выполняется макрос exit(), осуществляющий выход из справки.

Макрос InsertItem позволяет вставить раздел в меню, указанное его идентификатором. Для предусмотренных по умолчанию меню окна справки используются следующие идентификаторы:

Меню

Идентификатор

Файл

mnu_file

Правка

mnu_edit

Параметры

mnu_options

Закладка

mnu_bookmark

?

mnu_hlp

Всплывающее меню

mnu_floating


Пример использования макроса InsertItem:

InsertItem("mnu_help","How","Как использовать справку",HelpOn(),0)

В этом примере в меню справки вставляется на первое место (индекс 0 - последний элемент макроса) раздел Как использовать справку, при выборе которого выполняется макрос HelpOn(), обеспечивающий переход на стандартный файл, поясняющий использование справки.

<<<Назад     Далее >>>



 URL: http://clubrus.kulichki.net Автор: Korsar 

Rambler's Top100 Рейтинг ресурсов УралWeb