Выражение привязки

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

  • Стандартные ссылки (без схемы), которые указывают на переменные или функции контекста, их поля или свойства

  • Ссылки на компоненты (использующие схему form/),  которые указывают на свойства, события или функции компонентов инструментальной панели

  • Специальные ссылки Web UI (использующие схему web/), которые запускают специфичные для Web UI операции

  • Параметры инструментальной панели доступны как переменные окружения выражения (схема env/)

  • Ссылка на данные активатора события (записанная как env/value), которая указывает на переменную окружения с именем value, содержащую таблицу данных события, вызвавшего активацию привязки

Ссылки на компоненты

Ссылка на компонент указывает на свойство компонента Инструментальная панель (например, текст метки). Она имеет следующий формат:

form/component:property

form  - имя схемы, используемой для идентификации ссылок на компонент. Схема говорит обработчику языка выражений распознавать ссылки в соответствии с компонентом, в отличие от стандартной ссылки. Ссылки на компоненты необходимо всегда начинать с form/.

component - имя компонента инструментальной панели, с которым вы хотите работать. Имя компонента отображается в дереве компонентов и в заголовке окна свойств компонентов, если компонент выбран в конструкторе.

property  - имя определенного свойства внутри компонента. Имена свойств можно найти в описании свойств каждого компонента инструментальной панели. Указывать свойство в ссылке на компонент необязательно. Если свойство не указано, ссылка ведет к свойству по умолчанию компонента.

Формат свойства, т.е. типа значения, возвращаемого ссылкой на свойство компонента, можно найти в описании этого свойства в справочнике компонентов.

Примеры ссылок на свойство компонента

{form/userNameField:}

{form/userNameField:text}

Обе ссылки разрешаются в текст, который содержится в userNameField (при условии, что это текстовое поле). Первая ссылка указывает на свойство по умолчанию компонента, то есть text, а вторая прямо называет его (:text).

Специальные ссылки web UI

Специальные ссылки веб-интерфейса относятся к Web UI и обозначаются схемой web/.

Ссылка на событие активатора

Многие инструментальные панели генерируют события при взаимодействии с пользователем или при изменении их свойств каким-либо другим способом. Некоторые события содержат сопутствующую информацию (например, координаты точки щелчка мыши в области компонента).

Ссылка env/value (т. е. ссылка на переменную окружения value) указывает на таблицу, содержащую данные о событии, вызвавшем активацию привязки.

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

{form/numberField1:value} * 100

Это выражение разрешится в число, равное свойству value компонента Числовое поле, названного numberField1, умноженному на 100.

Was this page helpful?