Перейти к основному содержимому

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

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

После того как вы добавите в проект переключаемую команду и дадите ей имя, «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-файла:

ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Имя: МойСправочник
Ид: 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-файла элемента проекта:

ВидЭлемента: Справочник
ОбластьВидимости: ВПодсистеме
Имя: МойСправочник
Ид: 64cdbccd-a768-4877-9fdd-4f7ea44c2600

Пример YAML-файла компонента:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: d3f2fad1-4ce1-444b-8aaa-b37425f4f6bb
Имя: МояГруппа
Наследует:
    Тип: ФиксированнаяГруппа
Последнее обновление