Настройка пользовательских кнопок

При выборе типа «Модуль Fore/JS-функция» задайте дополнительные настройки:

• Модуль. Выберите из раскрывающегося списка модуль, написанный на языке Fore. Для кнопки можно задать только один модуль;

• Метод/функция модуля. Выберите из раскрывающегося списка метод или функцию модуля. Функция должна иметь требуемую сигнатуру:

Public Sub <Наименование функции>(<Report>: IPrxReport);
Begin
…
End Sub <Наименование функции>;

Параметр:

Report. В параметр передаётся регламентный отчёт в формате IPrxReport. При работе с этим объектом будут доступны все свойства и методы интерфейса IPrxReport;

Предобработчик используется для вывода текстового сообщения с произвольным текстом при нажатии на пользовательскую кнопку. Например, для кнопки, вызывающей выполнение расчёта, может быть настроен предобработчик с сообщением о начале выполнения расчёта, которое может занять длительное время. В этом случае при нажатии кнопки перед выполнением расчёта будет выведено настроенное сообщение.

Для настройки предобработчика задайте параметры:

• Метод/функция модуля. Выберите из раскрывающегося списка метод или функцию модуля. Поле доступно только после выбора модуля.

Список содержит все методы и функции выбранного модуля, соответствующие сигнатуре:

Function <Наименование функции> (<Report>: IPrxReport; [Var messageType: Integer]): String;

Примечание. Если в модуле нет методов и функций, удовлетворяющих требуемой сигнатуре, то список «Метод/функция модуля» недоступен.

Параметры:

Report. В параметр передаётся регламентный отчёт в формате IPrxReport. При работе с этим объектом будут доступны все свойства и методы интерфейса IPrxReport;

messageType. Необязательный параметр. Предназначен для определения формата выводимого сообщения. Если параметр не задан, то будет применяться диалог подтверждения. Для скрытия выводимого сообщения уберите возвращаемое значение в Return. Доступные значения:

• 0. Диалог подтверждения. При нажатии кнопки «Да» диалога выполняется заданное для кнопки действие. При нажатии кнопки «Нет» диалога заданное для кнопки действие выполняться не будет;

• 1. Ошибка. При нажатии кнопки «ОК» диалога заданное для кнопки действие не выполняется;

• 2. Предупреждение. При нажатии кнопки «ОК» диалога заданное для кнопки действие не выполняется;

• 3. Информационное сообщение. При нажатии кнопки «ОК» диалога заданное для кнопки действие не выполняется.

Пример функции:

Function MessageInformationBox(Report: IPrxReport; Var messageType: integer): String;
    Begin
        messageType := 3;
    Return "Операция будет доступна, когда будут введены все данные";
End Function MessageInformationBox;

Постобработчик используется для выполнения требуемых действий после завершения работы метода Доступно задание только одного постобработчика.

Для настройки постобработчика задайте параметры:

• Метод/функция модуля. Выберите из раскрывающегося списка метод или функцию модуля. Поле доступно только после выбора модуля.

Список содержит все методы и функции выбранного модуля, соответствующие сигнатуре:

Sub <Наименование метода>(<Report>: IPrxReport);

Примечание. Если в модуле нет методов и функций, удовлетворяющих требуемой сигнатуре, то список «Метод/функция модуля» недоступен.

Параметр:

Report. В параметр передаётся регламентный отчёт в формате IPrxReport. При работе с этим объектом будут доступны все свойства и методы интерфейса IPrxReport.

Пример функции:

Sub UpdateData(Report: IPrxReport);
Var
    SheetT: IPrxTable;
    ItemIndex: Integer;
Begin
    ItemIndex := Report.ActiveSheet.Index;
    SheetT := Report.Sheets.Item(ItemIndex) As IPrxTable;
    SheetT.TabSheet.CellValue(10,10) := 1000000;
End Sub UpdateData;

Для настройки управления активностью кнопки задайте параметр «Метод/функция модуля»», в котором выберите из раскрывающегося списка метод или функцию модуля. Поле доступно только после выбора модуля.

Список содержит все методы и функции выбранного модуля, соответствующие сигнатуре:

Function <Название функции>(<Report>: IPrxReport): Boolean;

Примечание. Если в модуле нет методов и функций, удовлетворяющих требуемой сигнатуре, то список «Метод/функция модуля» недоступен.

Параметр:

Report. В параметр передаётся регламентный отчёт в формате IPrxReport. При работе с этим объектом будут доступны все свойства и методы интерфейса IPrxReport.

Доступные значения:

• True. Кнопка активна;

• False. Кнопка неактивна.

Примечание. Проверка выполнения условия проходит постоянно, поэтому Fore-функция должна быстро выполняться, иначе регламентный отчёт будет неработоспособным.