Типы встроенного языка и свойства элемента проекта вида «ПереключаемаяКоманда»

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

После того, как вы добавили в проект переключаемую команду и дали ей имя, «1С:Шина» создаст один тип встроенного языка. Имя этого типа совпадает с именем вашей переключаемой команды.

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

Тип <ИмяПереключаемойКоманды>

Это тип-одиночка. Он доступен на клиенте.

Тип <ИмяПереключаемойКоманды> не имеет конструктора и имеет единственный экземпляр, обращение к которому выполняется по имени типа:

// Получить обычную команду «КомандаВИзбранное»
пер КомандаИзбранное = КомандаВИзбранное

Модуль переключаемой команды

В проекте модуль, расширяющий тип <ИмяПереключаемойКоманды>, называется модулем переключаемой команды. Он исполняется на клиенте.

В этом модуле вы можете обработать событие нажатия на команду.

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

Иерархия наследования

Свойства элемента проекта

ИзображениеАктивного
Ссылка на ресурс картинки, которая будет показана для активной команды. Пример YAML-файла:
ВидЭлемента: ПереключаемаяКоманда
ОбластьВидимости: Подсистема
Ид: cb1c56ba-0f64-40da-a1b1-d89689c8b23a
Имя: МояПереключаемаяКоманда
ПредставлениеАктивного: Избранное
ПредставлениеНеактивного: В избранное
ИзображениеАктивного: Action-on.svg
ИзображениеНеактивного: Action-off.svg
Обработчик: ОбработчикКоманды
ИзображениеНеактивного
Ссылка на ресурс картинки, которая будет показана для неактивной команды. Пример YAML-файла:
ВидЭлемента: ПереключаемаяКоманда
ОбластьВидимости: Подсистема
Ид: cb1c56ba-0f64-40da-a1b1-d89689c8b23a
Имя: МояПереключаемаяКоманда
ПредставлениеАктивного: Избранное
ПредставлениеНеактивного: В избранное
ИзображениеАктивного: Action-on.svg
ИзображениеНеактивного: Action-off.svg
Обработчик: ОбработчикКоманды
НастройкиТипа
Контракты, которые реализует переключаемая команда
Контракты
Массив<Тип>. Имена контрактов сервиса, которые реализует данная команда.
Обработчик
Имя метода, который будет вызван для выполнения команды. Пример YAML-файла:
ВидЭлемента: ПереключаемаяКоманда
ОбластьВидимости: Подсистема
Ид: cb1c56ba-0f64-40da-a1b1-d89689c8b23a
Имя: МояПереключаемаяКоманда
ПредставлениеАктивного: Избранное
ПредставлениеНеактивного: В избранное
ИзображениеАктивного: Action-on.svg
ИзображениеНеактивного: Action-off.svg
Обработчик: ОбработчикКоманды
ПредставлениеАктивного
Строка, которая будет показана как заголовок активной команды. Пример YAML-файла:
ВидЭлемента: ПереключаемаяКоманда
ОбластьВидимости: Подсистема
Ид: cb1c56ba-0f64-40da-a1b1-d89689c8b23a
Имя: МояПереключаемаяКоманда
ПредставлениеАктивного: Избранное
ПредставлениеНеактивного: В избранное
ИзображениеАктивного: Action-on.svg
ИзображениеНеактивного: Action-off.svg
Обработчик: ОбработчикКоманды
ПредставлениеНеактивного
Строка, которая будет показана как заголовок неактивной команды. Пример YAML-файла:
ВидЭлемента: ПереключаемаяКоманда
ОбластьВидимости: Подсистема
Ид: cb1c56ba-0f64-40da-a1b1-d89689c8b23a
Имя: МояПереключаемаяКоманда
ПредставлениеАктивного: Избранное
ПредставлениеНеактивного: В избранное
ИзображениеАктивного: Action-on.svg
ИзображениеНеактивного: Action-off.svg
Обработчик: ОбработчикКоманды
Важность
Определяет важность команды. Важность может использоваться при отображении команды, например, все команды с важностью Низкая из свойства формы ДополнительныеКоманды будут отображены в выпадающем меню «Еще»
Видимость
Управляет видимостью команды
Доступность
Если Ложь, команда не доступна для выполнения
Коннотация
Управляет коннотацией команды. Коннотация отображается только тогда, когда компонент, используемый для отображения команды умеет показывать коннотацию. Например, компонент Кнопка
Внешний
Является ли элемент проекта или компонент внешним. Пример YAML-файла:
ВидЭлемента: Пользователи
Внешний: Истина
Имя: Пользователи
СобственныйПакет: Стд::Пользователи
Имя
Имя элемента проекта или компонента. Пример YAML-файла:
ВидЭлемента: Справочник
ОбластьВидимости: Подсистема
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Импорт
Список импортированных пространств имен (подробнее). Пример YAML-файла:
ВидЭлемента: Справочник
ОбластьВидимости: Подсистема
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Импорт: 
    - Главная
    - Настройки::НовыйПакет
Ид
Идентификатор элемента проекта или компонента. «1С:Шина» создает этот идентификатор автоматически. Пример YAML-файла:
ВидЭлемента: Справочник
ОбластьВидимости: Подсистема
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
ОбластьВидимости
Видимость элемента проекта (подробнее):
  • Подсистема — элемент виден внутри одной подсистемы во всех пакетах. Значение по умолчанию.
  • Проект — элемент виден во всех подсистемах одного проекта.
  • Глобально — элемент виден в других проектах.
Пример YAML-файла:
ВидЭлемента: Справочник
ОбластьВидимости: Подсистема
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
СобственныйПакет
Имя пакета собственного объекта. Пример YAML-файла:
ВидЭлемента: Пользователи
Внешний: Истина
Имя: Пользователи
СобственныйПакет: Стд::Пользователи
ВидЭлемента
Вид элементов проекта (подробнее) либо компонент интерфейса (подробнее). Пример YAML-файла элемента проекта:
ВидЭлемента: Справочник
ОбластьВидимости: Подсистема
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600
Пример YAML-файла компонента:
ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: Подсистема
Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb
Имя: МояГруппа
Наследует:
    Тип: ОбычнаяГруппа