Команда FormatConditionSetup

Назначение

Вызов стандартного диалога настройки параметров заданного условного формата.

Параметры использования

Параметры команды передаются в свойстве Data. Для работы команды в данном свойстве необходимо указать массив типа Variant, элементы которого содержат следующие значения:

Тип значения	Описание
Элемент 1: ITabSheet	Страница, на которой расположен диапазон ячеек.
Элемент 2: ITabRange	Диапазон ячеек, для которого будет вызван диалог настройки параметров условного форматирования данных. Данный параметр используется при создании новых условных форматов. Для диапазона, указанного в данном параметре, будет применен новый условный формат. Если осуществляется редактирование существующего условного формата, то данный параметр можно не указывать, либо указывать диапазон, для которого был создан условный формат.
Элемент 3: ITabFormatCondition	Условный формат, параметры которого будут отображены в диалоге.

Особенности применения

Команда может применяться только для регламентных отчетов.

Пример

Для выполнения примера предполагается наличие формы, расположенной на ней кнопки с наименованием "Button1", компонента ReportBox и компонента UiReport с наименованием «UiReport1», являющегося источником данных для ReportBox.

    Sub Button1OnClick(Sender: Object; Args: IMouseEventArgs);
    Var
        Sheet: ITabSheet;
        Cond: ITabFormatCondition;
        Target: IUiCommandTarget;
        Context: IUiCommandExecutionContext;
        Data: Array;
    Begin
        Sheet := (UiReport1.Instance As IPrxReport).ActiveSheet As ITabSheet;
        Cond := Sheet.FormatConditions.Add;
        Cond.Type := TabConditionType.Duplicate;
        Target := WinApplication.Instance.GetPluginTarget("Report");
        Context := Target.CreateExecutionContext;
        Data := New Variant[3];
        Data[0] := Sheet;
        Data[1] := Sheet.ParseRange("A0:C10");
        Data[2] := Cond;
        Context.Data := Data;
        Target.Execute("FormatConditionSetup", Context);
    End Sub Button1OnClick;

При нажатии на кнопку для текущего листа регламентного отчета, подключенного в «UiReport1», будет создан новый условный формат. Условный формат будет осуществлять форматирование ячеек с уникальными/дублирующимися значениями. На экран будет выведен диалог настройки условного формата. После настройки параметров условного нажатия кнопки «ОК» данный условный формат будет применен для диапазона «A0:C10» листа отчета.

См. также:

IUiCommandTarget.Execute