Оператор ACTIVE

Оператор ACTIVE - создание свойства или действия, возвращающего информацию об активном элементе формы: закладке, свойстве (или действии), форме либо текущем объекте в группе объектов.

Синтаксис

ACTIVE TAB formName.componentSelector
ACTIVE PROPERTY formPropertyId
ACTIVE FORM formName

ACTIVE formObjectId

Описание

Синтаксис оператора ACTIVE зависит от вида проверяемой активности.

Активность закладки или свойства

Формы ACTIVE TAB и ACTIVE PROPERTY создают свойство без параметров типа BOOLEAN, реализующее проверку активности закладки или свойства на форме. Платформа пересчитывает значение свойства автоматически:

• TAB — значение пересчитывается при переключении закладок на форме. Как правило, используется для вычисления значений других свойств (например, для SHOWIF, в условиях выгрузки и т. п.), чтобы избежать вычислений на неактивных закладках.
• PROPERTY — значение пересчитывается при изменении фокуса на форме и рассылается на клиент.

Если вместо чтения состояния закладки требуется выполнить действие в момент переключения на неё, используется обработчик EVENTS ON TAB.

Активность формы

Форма ACTIVE FORM создаёт действие, выполняющее проверку активности указанной формы у пользователя и записывающее результат (TRUE или FALSE) во встроенное локальное свойство System.isActiveForm[]. Результат доступен для чтения через свойство isActiveForm() в том же сеансе / блоке действия.

Значение активного объекта

Форма ACTIVE formObjectId (без уточнителей TAB/PROPERTY/FORM) создаёт свойство без параметров, возвращающее текущее значение указанного объекта формы.

Параметры

• formName

  Имя формы. Составной идентификатор.

• componentSelector

  Селектор компонента дизайна. Компонент должен быть закладкой панели вкладок (то есть находиться внутри контейнера со свойством tabbed = TRUE).

• formPropertyId

  Глобальный идентификатор свойства или действия на форме, активность которого проверяется.

• formObjectId

  Глобальный идентификатор объекта на форме, значение которого возвращается.

Примеры

//Форма с двумя закладками
FORM tabbedForm 'Форма с табами'
    OBJECTS u = CustomUser
    PROPERTIES(u) name

    OBJECTS c = Chat
    PROPERTIES(c) name
;

DESIGN tabbedForm {
    NEW tabPane FIRST {
        tabbed = TRUE;
        NEW contacts {
            caption = 'Контакты';
            MOVE BOX(u);
        }
        NEW recent {
            caption = 'Последние';
            MOVE BOX(c);
        }
    }
}

//Активна ли закладка 'Последние'
recentActive() = ACTIVE TAB tabbedForm.recent;

//Свойство вычисляется только когда активна закладка 'Последние'
//(за счет этого тяжелое вычисление не выполняется, пока закладка скрыта)
chatNameIfActive (Chat c) = name(c) IF ACTIVE TAB tabbedForm.recent;

FORM users
    OBJECTS c = CustomUser
    PROPERTIES(c) name, login
;

activeLogin = ACTIVE PROPERTY users.login(c);
EXTEND FORM users
    PROPERTIES() activeLogin
;

//Подсказку показываем только когда фокус на поле login
loginHint 'Введите логин в латинице' () = 'Введите логин в латинице' IF activeLogin();
EXTEND FORM users
    PROPERTIES() loginHint
;

FORM exampleForm;
testActive  {
    ACTIVE FORM exampleForm;
    IF isActiveForm() THEN MESSAGE 'Example form is active';
}

FORM report
    OBJECTS dFrom = DATE PANEL
    PROPERTIES VALUE(dFrom)
;

//Сохраняем текущее значение dFrom из формы отчета во внешнее свойство
savedFromDate = DATA DATE ();
saveFromDate { savedFromDate() <- ACTIVE report.dFrom; }