Свойства компонента интерфейса, унаследованного от компонента «СтандартноеКлиентскоеПриложениеСРазделами»

Если в проекте есть компонент, унаследованный от типа СтандартноеКлиентскоеПриложениеСРазделами, то «1С:Исполнитель» будет использовать для приложения автоматический интерфейс, содержащий следующие области:

• Панель навигации — основная панель для общей навигации по приложению. Отображается либо слева, либо сверху, в зависимости от свойства ОриентацияПанелиНавигации. В мобильном варианте трансформируется в мобильную нижнюю навигационную панель.
• Область содержимого — основная часть интерфейса приложения, в которой открываются формы.
• Панель действий — позволяет выполнять основные действия над приложением, такие как смена цветовой схемы, перемещение по ранее открытым вкладкам, получение информации о приложении и др. Расположена справа. В мобильном варианте перемещается наверх.
• ДополнительныйКомандныйИнтерфейс — нижняя часть панели действий, обычно содержит команды профиля или завершения работы с приложением.

Для наполнения областей интерфейса командами вы можете использовать следующие элементы в редакторе компонента СтандартноеКлиентскоеПриложениеСРазделами:

• КомандныйИнтерфейсПанелиНавигации;
• КомандныйИнтерфейсПанелиДействий;
• ДополнительныйКомандныйИнтерфейс.

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

Если вы не описали КомандныйИнтерфейсПанелиНавигации или не создали формы для каких-то элементов проекта, то «1С:Исполнитель» будет использовать автоматические команды и формы, таким же образом как и для автоматического интерфейса.

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

Свойства

ВидимостьИнтерфейсаСистемыВзаимодействия

Авто|Булево. Видимость иконки, открывающей интерфейс Системы Взаимодействия в приложении. Иконка отображается, только если приложение зарегистрировано на сервере Системы Взаимодействия.

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
Ид: 76eb6f8f-e340-42ed-8dad-7a1104a6da02
Имя: ДемонстрационноеПриложение
ОбластьВидимости: ВПодсистеме
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    ВидимостьИнтерфейсаСистемыВзаимодействия: Ложь

ВидимостьПереключателяЦветовойСхемы

Авто|Булево. Отображает на панели действий иконку переключения цветовой схемы.

ВидЭлемента: КомпонентИнтерфейса
Ид: 76eb6f8f-e340-42ed-8dad-7a1104a6da02
Имя: ДемонстрационноеПриложение
ОбластьВидимости: ВПодсистеме
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    ВидимостьПереключателяЦветовойСхемы: Ложь

ВидимостьЦентраУведомлений

Авто|Булево. Показать или скрыть на панели действий иконку Колокольчик, которая предоставляет доступ к центру уведомлений.

Пример YAML-файла:

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    ВидимостьЦентраУведомлений: Ложь

ДополнительныйКомандныйИнтерфейс

Экземпляр ФрагментКомандногоИнтерфейса<ТипКоманды>, содержащий одну группу с командами. Описывает интерфейс дополнительной панели навигации.

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    ДополнительныйКомандныйИнтерфейс: =ДополнительныйИнтерфейс

КомандныйИнтерфейсПанелиДействий

Экземпляр ФрагментКомандногоИнтерфейса<ТипКоманды>, состоящий из команд. Описывает интерфейс панели действий.

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    КомандныйИнтерфейсПанелиДействий: =ПанельДействий

КомандныйИнтерфейсПанелиНавигации

Экземпляр ФрагментКомандногоИнтерфейса<ТипКоманды>. Описывает интерфейс панели навигации.

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    КомандныйИнтерфейсПанелиНавигации: =ПанельНавигации

ОриентацияПанелиНавигации

Авто|ОриентацияПанелиНавигации. Определяет ориентацию панели навигации приложения. Возможные значения:

• Авто — значение ОриентацияПанелиНавигации.Вертикальная;
• ОриентацияПанелиНавигации.Вертикальная — вертикально слева (слева от области содержимого);
• ОриентацияПанелиНавигации.Горизонтальная — горизонтально сверху (над областью содержимого).

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    ОриентацияПанелиНавигации: Горизонтальная

ОсобоеОформлениеПервогоРаздела

Авто|Булево. Необходимость оформления области содержимого первого раздела особым образом, отличным от других разделов:

• Серый фон;
• Нет скруглений верхних углов.

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    ОсобоеОформлениеПервогоРаздела: Ложь

ПоложениеЗаголовка

Авто|ПоложениеЗаголовкаПриложения. Способ совместного отображения логотипа и заголовка приложения. Возможные значения:

• Авто — «Исполнитель» использует вариант ПоложениеЗаголовкаПриложения.Горизонтально;
• элементы перечисления ПоложениеЗаголовкаПриложения:
  • Горизонтально — «Исполнитель» отображает заголовок справа от логотипа;
  • Вертикально — «Исполнитель» отображает заголовок под логотипом;
  • НеОтображать — «Исполнитель» отображает только логотип, заголовок не отображается.

Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    ПоложениеЗаголовка: Вертикально

Заголовок

Заголовок приложения. Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    Заголовок: demo APP

ИспользоватьВебЧат

Авто|Булево. Включить/отключить использование веб-чата в приложении.

Путь

Путь публикации данного приложения (подробнее). Должен содержать один сегмент пути или пустую строку. Не должен содержать следующие зарезервированные пути:

• api;
• stdapi;
• sys;
• ui.

Если содержит пустую строку, то входом в приложение является точка публикации проекта. Если путь указан, то входом в приложение является путь публикации проекта плюс данный путь. Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    Путь: back-office

РежимАутентификации

Необходимость аутентификации пользователя при входе в приложение:

• Аутентифицированный — пользователь будет автоматически перенаправлен на страницу аутентификации;
• НеАутентифицированный — может работать анонимный пользователь. Стандартно это свойство имеет значение Аутентифицированный, но вы можете установить его в значение НеАутентифицированный и тогда пользователь не будет перенаправлен на страницу аутентификации при входе в приложение. Такого пользователя не будет в списке подключенных пользователей и Пользователи.ТекущийПользователь будет возвращать Неопределено. Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 8e6c16f6-a3f8-4a63-a53d-d48aa146a3c9
Имя: МоеПриложение
Наследует:
    Тип: СтандартноеКлиентскоеПриложениеСРазделами
    РежимАутентификации: НеАутентифицированный

ВесПриРастягивании

Значимость данного компонента по сравнению с другими растягиваемыми компонентами. Например, если у данного компонента ВесПриРастягивании = 1, а у другого ВесПриРастягивании = 2, то другой компонент будет в 2 раза больше данного (подробнее). Пример YAML-файла:

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

ВыравниваниеВГруппеПоВертикали

Способ вертикального выравнивания этого компонента внутри родительской группы:

• Авто — значение ВыравниваниеПоВертикали.ПоБазовойЛинии;
• элементы перечисления ВыравниваниеПоВертикали — Верх, Центр, Низ, ПоБазовойЛинии. Позволяет управлять индивидуальным положением этого компонента в группе, если размер группы больше размера, требуемого всем ее компонентам. Например, если «Исполнитель» растягивает группу, а компоненты в ней не растягивает.

Для компонента, расположенного внутри вертикальной группы, это свойство имеет смысл только в том случае, если этот компонент крайний. Например, если компоненты группы расположены вверху, то последний компонент можно расположить внизу.

Если у компонентов внутри группы указаны разные способы вертикального положения, которые входят в конфликт друг с другом, то «Исполнитель» будет использовать для всех конфликтных компонентов тот способ, который указан у первого из них. Например, если у первого конфликтного компонента в группе указано положение Низ, а у второго Верх, то оба компонента окажутся внизу.

Пример YAML-файла:

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

Видимость

Показать или скрыть компонент. Фактическая видимость компонента зависит от видимости его родительских компонентов. Пример YAML-файла:

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

Высота

Авто|Число. Высота компонента в пикселях (подробнее).

Если Авто, то рассчитывается автоматически. Если отлична от 0 и РастягиватьПоВертикали вычислено как Ложь, то компонент будет иметь указанную высоту. Пример YAML-файла:

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

ВыравниваниеВГруппеПоГоризонтали

Способ горизонтального выравнивания этого компонента внутри родительской группы:

• Авто — значение ВыравниваниеПоГоризонтали.Начало;
• Элементы перечисления ВыравниваниеПоГоризонтали — Начало, Центр, Конец, ПоШирине.

Позволяет управлять индивидуальным положением компонента в группе, если размер группы больше размера, требуемого всем ее компонентам. Например, если «Исполнитель» растягивает группу, а компоненты в ней не растягивает.

Для компонента, расположенного внутри горизонтальной группы, это свойство имеет смысл только в том случае, если этот компонент крайний. Например, если компоненты группы расположены в начале, то последний компонент можно расположить в конце.

Если у компонентов внутри группы указаны разные способы горизонтального положения, которые входят в конфликт друг с другом, то «Исполнитель» будет использовать для всех конфликтных компонентов тот способ, который указан у первого из них. Например, если у первого конфликтного компонента в группе указано положение Конец, а у второго Начало, то оба компонента окажутся в конце группы.

Пример YAML-файла:

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

Доступность

Способность компонента принимать фокус и редактировать данные. Состояние доступности распространяется на все компоненты содержимого, пока не встретится переопределение этого свойства. Имеет приоритет над свойством ТолькоЧтение. Пример YAML-файла:

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

МаксимальнаяВысота

Максимальная высота компонента в пикселях. Свойство используется, если РастягиватьПоВертикали вычислено как Истина. Пример YAML-файла:

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

МаксимальнаяШирина

Максимальная ширина компонента в пикселях. Свойство используется, если РастягиватьПоГоризонтали вычислено как Истина. Пример YAML-файла:

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

МинимальнаяВысота

Минимальная высота компонента в пикселях. Свойство используется, если РастягиватьПоВертикали вычислено как Истина. Пример YAML-файла:

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

МинимальнаяШирина

Минимальная ширина компонента в пикселях. Свойство используется, если РастягиватьПоГоризонтали вычислено как Истина. Пример YAML-файла:

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

РастягиватьПоВертикали

Авто|Булево. Необходимость растягивания компонента по всей доступной высоте (подробнее).

Доступная высота — это высота родительской группы, которая определяется:

• либо также растягиванием по ее родительской группе;
• либо компонентом содержимого с максимальным значением свойства Высота.

Значения:

• Истина — «Исполнитель» растягивает компонент, несмотря на значения свойств Высота или Ширина;
• Ложь;
• Авто — имеет различное поведение в зависимости от типа компонента:
  • Компоненты, не перечисленные далее — Ложь.
  • Таблица — Истина.
  • Группа, Страницы — анализируются вычисленные значения растягивания у компонентов содержимого. Если хотя бы одно из них равно Истина, то используется Истина, иначе — Ложь.
  • МатричнаяГруппа — если хотя бы для одной колонки или столбца включено растягивание, то Истина, иначе Ложь. Если у матричной группы задано фиксированное количество колонок или строк, то компоненты содержимого так же проверяются на наличие растягиваемых.
  • ПроизвольныйКомпонент, Страница — используется вычисленное значение этого свойства у того компонента, который указан в свойстве Содержимое.
  • СтековаяГруппа — используется вычисленное значение этого свойства у последнего из компонентов содержимого.

Пример YAML-файла:

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

РастягиватьПоГоризонтали

Необходимость растягивания компонента по всей доступной ширине (подробнее).

Доступная ширина — это ширина родительской группы, которая определяется:

• либо также растягиванием по ее родительской группе;
• либо компонентом содержимого с максимальным значением свойства Ширина.

Значения:

• Истина — «Исполнитель» растягивает компонент, несмотря на значения свойств Высота или Ширина;
• Ложь;
• Авто — имеет различное поведение в зависимости от типа компонента:
  • Компоненты, не перечисленные далее — Ложь.
  • Таблица — Истина.
  • Группа, Страницы — анализируются вычисленные значения растягивания у компонентов содержимого. Если хотя бы одно из них равно Истина, то используется Истина, иначе — Ложь.
  • МатричнаяГруппа — если хотя бы для одной колонки или столбца включено растягивание, то Истина, иначе Ложь. Если у матричной группы задано фиксированное количество колонок или строк, то компоненты содержимого так же проверяются на наличие растягиваемых.
  • ПроизвольныйКомпонент, Страница — используется вычисленное значение этого свойства у того компонента, который указан в свойстве Содержимое.
  • СтековаяГруппа — используется вычисленное значение этого свойства у последнего из компонентов содержимого.

Пример YAML-файла:

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

ТолькоЧтение

Запрет редактирования данных компонента. Если флажок установлен, то компонент может принимать фокус, текст более четкий, его данные можно просматривать и копировать. В этом состоянии некоторые компоненты могут сохранять свою интерактивность, которая не влечет за собой изменение каких-либо данных. Состояние ТолькоЧтение распространяется на все компоненты содержимого, пока не встретится переопределение этого свойства. Имеет более низкий приоритет, чем свойство Доступность. Пример YAML-файла:

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

Ширина

Авто|Число. Ширина компонента в пикселях (подробнее).

Если Авто, то рассчитывается автоматически. Если отлична от 0 и РастягиватьПоГоризонтали вычислено как Ложь, то компонент будет иметь указанную высоту. Пример YAML-файла:

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

НастройкиТипа

Контракты, которые реализует компонент интерфейса

• Контракты

  Массив<Тип>. Имена контрактов типа, которые реализует данный компонент.

<Свойство разработчика>

Собственное свойство компонента (добавленное вами). Каждое собственное свойство описывается следующими свойствами:

ЗначениеПоУмолчанию

Стандартное значение свойства. Значение можно не указывать, если у его типа/типов есть значение по умолчанию (в частности, если его тип включает Неопределено или Null). Если тип свойства составной (включает несколько типов), необходимо указать тип значения. Иначе просто само значение. Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Свойства:
    - 
        Имя: Готовность
        Тип: Булево
        ЗначениеПоУмолчанию:
            Ложь
    -
        Имя: Проверено
        Тип: Булево|Строка
        ЗначениеПоУмолчанию:
            Тип: Булево
            Значение: Ложь
Наследует:
    Тип: ФормаОбъекта<МойСправочник.Объект>

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

Имя

Имя свойства. Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Свойства:
    -
        Имя: ЭлектроннаяПочта
        Тип: Строка
    - 
        Имя: Пользователь
        Тип: Пользователи.Ссылка?
Наследует:
    Тип: ФормаОбъекта<МойСправочник.Объект>

Контекстное

Булево. Признак доступности значения свойства на клиенте и сервере. Значение по умолчанию — Ложь. Если Истина, то поле Тип свойства должно содержать тип, доступный на клиенте и сервере.

«1С:Исполнитель» генерирует структурный тип {ИмяКомпонента}.Контекст, который содержит как собственные контекстные свойства, так и контекстные свойства, наследуемые от базовых системных типов. Этот тип генерируется всегда, даже если контекстные свойства отсутствуют.

Пример:

Имя: МойКомпонент
Свойства:
    -
        Имя: КонтекстноеСвойство
        Тип: Строка
        Контекстное: Истина

Для работы с контекстными свойствами на сервере вы можете использовать контекстные серверные методы. Эти методы должны располагаться в модуле компонента интерфейса и содержать аннотации @Контекстный и @НаСервере. В теле метода тип объекта этот заменяется на {ИмяКомпонента}.Контекст. Состояние этого объекта передается с клиента на сервер при каждом вызове метода. На сервере в теле метода вы можете изменить состояние объекта. Измененное состояние будет автоматически передано на клиент, и компонент будет инициализирован заново с учетом внесенных изменений.

Пример изменения значения контекстного свойства на сервере:

@НаСервере @ДоступноСКлиента
@Контекстный
метод КонтекстныйМетод()
    этот.ПолучитьТип() // Вернет "ИмяКомпонента.Контекст"
    // Задание значения контекстного свойства на сервере
    КонтекстноеСвойство = "Значение"
;

СохраняемыеДанные

Истина — при изменении значения этого свойства «Исполнитель» установит свойство СобственнаяМодифицированность элемента компонента в значение Истина. В значение Ложь свойство СобственнаяМодифицированность вам нужно установить самостоятельно после записи данных. Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Свойства:
    -
        Имя: ЭлектроннаяПочта
        Тип: Строка
        СохраняемыеДанные: Истина
Наследует:
    Тип: ФормаОбъекта<МойСправочник.Объект>

Тип

Тип свойства. Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 9f51db7f-c98d-499c-9607-545d5e0a58c2
Имя: МояФормаОбъекта
Свойства:
    -
        Имя: ЭлектроннаяПочта
        Тип: Строка
    - 
        Имя: Пользователь
        Тип: Пользователи.Ссылка?
    -
        Имя: Проверено
        Тип: Булево|Строка|?
Наследует:
    Тип: ФормаОбъекта<МойСправочник.Объект>

<Событие разработчика>

Собственные события компонента (добавленные вами). Здесь вы описываете только само событие, обработчик для этого события вы назначите при описании экземпляра этого компонента. О вызове и назначении обработчиков собственных событий компонента можно прочитать здесь. Каждое событие описывается следующими свойствами:

Имя

Имя события. Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 4a2f1305-d442-41e2-9c07-5aaebbe6bdeb
Имя: МояПроизвольнаяСтрокаСписка
События: 
    -
        Имя: ВыбратьСотрудника
        Тип: СобытиеСДанными<ДанныеМероприятия>
Наследует:
    Тип: ПроизвольнаяСтрокаСписка<МояСтруктура>

Тип

Тип объекта события:

• тип должен быть наследником типа СобытиеКомпонента;
• если значение не указано, то тип события — СобытиеКомпонента.

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 4a2f1305-d442-41e2-9c07-5aaebbe6bdeb
Имя:МояПроизвольнаяСтрокаСписка
События: 
    -
        Имя: ВыбратьСотрудника
        Тип: СобытиеСДанными<ДанныеМероприятия>
Наследует:
    Тип: ПроизвольнаяСтрокаСписка<МояСтруктура>

Тип

Тип наследуемого компонента. Пример YAML-файла:

ВидЭлемента: КомпонентИнтерфейса
ОбластьВидимости: ВПодсистеме
Ид: 746eb2b7-5067-4ee4-badd-16751a6ecd16
Имя: МояГруппа
Наследует:
    Тип: ФиксированнаяГруппа

Имя

Имя элемента проекта или компонента. Пример 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
Имя: МояГруппа
Наследует:
    Тип: ФиксированнаяГруппа

События

ПриИзмененииИсторииПереходов

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

@Обработчик
метод ПриИзмененииИсторииПереходов(Событие: СобытиеСДанными<Строка>)
;

ПриОткрытииПоСсылке

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

@Обработчик
метод ПриОткрытииПоСсылке(Событие: СобытиеПриОткрытииПоСсылке)
;

ПослеСоздания

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

• установлены значения свойств экземпляра компонента, указанные при описании экземпляра;
• созданы свои компоненты данного экземпляра;
• значения свойств своих компонентов установлены из описаний их экземпляров;
• подключены обработчики событий в экземпляре компонента и в экземплярах его внутренних компонентов.

Сигнатура обработчика на встроенном языке:

@Обработчик
метод ПослеСоздания()
;

ПриНаведении

Назначаемое событие. Вызывается при наведении указателя мыши на область компонента. Особенности вызова события:

• При наведении указателя мыши на вложенные элементы событие ПриНаведении сначала вызывается для родительского элемента, а затем для дочернего.
• Событие не поддерживается на мобильных устройствах. Когда указатель мыши покидает область компонента, вызывается событие ПриПотереНаведения.

В примере ниже показано использование событий ПриНаведении и ПриПотереНаведения для изменения цвета картинки при наведении на нее указателя мыши:

Тип: Картинка
Изображение: Дом.svg
ПриНаведении: ПриНаведении
ПриПотереНаведения: ПриПотереНаведения

Обработка событий во встроенном языке:

метод ПриНаведении(Источник: Компонент, Событие: СобытиеКомпонента)
(Источник как Картинка).Цвет = Цвета.Стилевые.АкцентныйПервичный
;

метод ПриПотереНаведения(Источник: Компонент, Событие: СобытиеКомпонента)
(Источник как Картинка).Цвет = Авто
;

ПриПеретаскивании

Назначаемое событие. Возникает при окончании перетаскивания, например, при перетаскивании файлов из проводника на компонент. Если обработчик события не установил свойство СобытиеПриПеретаскивании.СтандартнаяОбработка равным Ложь, то происходит системная обработка события (она есть, например, у компонента ВыборФайлов), после чего «Исполнитель» вызывает событие у родительского по визуальной иерархии компонента, вплоть до компонента, унаследованного от КлиентскоеПриложение. Пример YAML-файла:

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

Сигнатура обработчика события на встроенном языке:

метод ОбработчикПриПеретаскивании(Компонент: Компонент, 
                                      Событие: СобытиеПриПеретаскивании)
;

ПриПотереНаведения

Назначаемое событие. Вызывается, когда указатель мыши покидает область компонента. Особенности вызова события:

• Если событие срабатывает для вложенных элементов (курсор смещается за пределы родительского элемента), то сначала оно вызывается для дочернего элемента, а затем для родительского.
• Событие не вызывается при удалении компонента, изменении его видимости или размера (если в результате указатель мыши больше не находится над областью компонента).
• Событие не поддерживается на мобильных устройствах.

При наведении указателя мыши на область компонента вызывается событие ПриНаведении.

В примере ниже показано использование событий ПриНаведении и ПриПотереНаведения для изменения цвета картинки при наведении на нее указателя мыши:

Тип: Картинка
Изображение: Дом.svg
ПриНаведении: ПриНаведении
ПриПотереНаведения: ПриПотереНаведения

Обработка событий во встроенном языке:

метод ПриНаведении(Источник: Компонент, Событие: СобытиеКомпонента)
        (Источник как Картинка).Цвет = Цвета.Стилевые.АкцентныйПервичный
;
    
метод ПриПотереНаведения(Источник: Компонент, Событие: СобытиеКомпонента)
        (Источник как Картинка).Цвет = Авто
;

См. также

Обработка глубоких ссылок