Платформа A2v10 довідкова система
EN


Шаблони. Команди

Об'єкт, що описує команди в шаблоні, є звичайним об'єктом JavaScript. Імена властивостей цього об'єкта є іменами команд, а значення - функціями або об'єктами.

Команди в видах задаються за допомогою прив`язки BindCmd зі заченням властивості Command що дорівнює Execute або ExecuteSelected. Ім'я команди задається властивістю CommandName.

Синтаксис


Якщо значенням є функція, то вона просто викликається при виконанні команди.

Властивості об'єкта команди

  • {Function} exec - функція, що виконує команду.
  • {Function} canExec - функція, що визначає чи можна виконати команду. Повертає ознаку того, чи можна виконати команду. Значення приводиться до типу Boolean.
  • {Boolean} saveRequired - чи потрібно зберігати модель перед виконанням команди. Також може бути встановлено в прив'язці BindCmd за допомогою властивості SaveRequired.
  • {Boolean} validRequired - виконувати команду тільки для моделі, що пройшла перевірку (властивість $valid кореневого об'єкта = true. Також може бути встановлено в прив'язці BindCmd за допомогою властивості ValidRequired.
  • {Boolean} checkReadOnly - забороняти команду для моделі в стані "тільки читання", Також може бути встановлено в прив'язці BindCmd за допомогою властивості CheckReadOnly.
  • {String|Object} confirm - запитувати підтвердження користувача перед виконанням команди. Також може бути встановлено в прив'язці BindCmd за допомогою властивості Confirm. Якщо значення - рядок, то він вважається текстом підтвердження. Якщо це об'єкт, то він має структуру, приведену нижче.

Властивості об'єкта confirm

  • {String} message - текст повідомлення.
  • {String} title - заголовок вікна повідомлення. Якщо не вказано, буде дорівнювати locale.$Confirm.
  • {String} okText - текст на кнопці підтвердження. Якщо не вказано, буде дорівнювати locale.$Ok.
  • {String} cancelText - текст на кнопці скасування. Якщо не вказано, буде дорівнювати locale.$Cancel.

Аргументи функцій exec і canExec

  • this - кореневий об`єкт (TRoot).
  • arg - аргумент, переданий в команду. Якщо команда задається в розмітці, то аргумент задається властивістю (або прив'язкою) Argument об'єкта BindCmd.

Зверніть увагу! Елементи інтерфейсу користувача, пов'язані з командами (наприклад кнопки), будуть автоматично заборонятися або дозволятися в залежності від можливості виконати команду. Використовувати властивість Disabled не потрібно.

Приклад

XAML:


Javascript: