Закладка Handler Code (Код обработчика) определяет обрабочики для гиперссылок, которые выбраны в панели, в случае если тип панели представляет собой XML или HTML, а гиперссылки начинаются с  vfps:. Например, приведенный ниже код открывает окно обозревателя для указанного унифицированного локатора ресурса URL:

<a href="vfps:linkto?url=http://msdn.microsoft.com/vfoxpro/">Go to the VFP site</a>

В приведенной ниже таблице перечислены обработчики по умолчанию, встроенные в Task Pane Manager (Диспетчер панели задач).

 
Обработчик по умолчанию Описание

vfps:refresh

Перезагружает текущую панель.

vfps:linkto

Открывает окно обозревателя для указанного URL. URL указывается с параметров url=cURL.

vfps:gotopane

Переключает Task Pane Manager (Диспетчер панели задач) на указанную панель. Панель определяется параметром uniqueid=cPaneUniqueID.

vfps:help

Отображает конкретную справку по конкретной статьте или ID. Help отображается с использованием параметра ID=cTopicID или Topic=cTopicName.

vfps:options

Отображает диалоговое окно Task Pane Options (Параметры панели задач) для указанной панели. Панель указывается с помощью параметра uniqueid=cPaneUniqueID.

vfps:message

Отображает информационное окно сообщения. Сообщение указывается в параметре msg=cMessage.

Вы можете включить параметр refresh с любым обработчиком кода, для немедленной перезагрузки панели после вызова обработчика. Это полезно в случае, когда результат обработки ссылки может воздействовать на содержание панели. Вы можете использовать параметр refresh вместе с другими параметрами так, как показано в приведенной ниже строке примера:

vfps:message?msg=This is a message&refresh

В приведенной ниже таблице перечислены параметры, посылаемые коду, когда вы используете свой собственный обработчик.

 
Параметр Описание

cAction

Указывает действие, который представляет собой текст, которые следует за vfps: но до любых параметров. Например, следующая строка указывает на использование собственного обработчика с именем MyAction:

<a href="vfps:MyAction?Param=Value">This is my handler</a>

oParameters

Коллекция конкретных параметров. В дополнение к этому, если обработчик представляет собой отправку формы (submit), коллекция помимо параметров, включает в себя значения из формы. Для извлечения значения вызовите функцию GetParam( ) с именем параметра так, как показано в приведенной ниже строке:

oParameters.GetParam("ParameterName")

oBrowser

Содержит объектную ссылку на объект Window в элементе управления browser панели. Вы можете использовать это для обращения к методам и свойствам DHTML. Например:

oBrowser.document.all("SearchResults").style.display = "none"

oContent

Содержит ссылку на определение страницы содержания, для того, чтобы вы смогли извлечь значения опций и каталог PaneCache, указанный в дилаоговом окне Task Pane Options (Параметры панели задач). Это тот же самый объект, который посылается в скрипт на Закладке Data диалогового окна Pane Customization (Настройка панели).

Modify (Изменить)

Открывает окно для редактирования кода обработчика.

Edit Box (Бокс редактирования)

Отображает код обработчика.

Смотрите также