Свойства компонента интерфейса, унаследованного от компонента «Кнопка»
Небольшая прямоугольная область, выделенная фоном, с картинкой и названием. На эту область можно нажать, чтобы выполнить действие.
Иерархия наследования
Свойства
Активность
Значение типа Булево
. Признак активности. Если Истина
, то компонент отображается с соответствующим состоянием. Имеет смысл, только если свойство Переключаемость
равно Истина
. Если кнопке назначена переключаемая команда, значение этого свойства игнорируется, активность определяется активностью переключаемой команды.
Вид
Авто|ВидКнопки
. Вид отображения кнопки.
ВидОтображенияЗаголовка
Значение типа Авто|ВидОтображенияЗаголовка
. Определяет вид отображения заголовка и изображения кнопки. Возможные значения: Иконка
, ИконкаИТекст
, Текст
. Авто
интерпретируется как ИконкаИТекст
.
Заголовок
Авто|Строка
. Текст в кнопке.
ЗаголовокАктивного
Авто|Строка
. Задает заголовок в активном состоянии. Имеет смысл, только если свойство Переключаемость
равно Истина
. Если свойство ЗаголовокАктивного
неопределено, то используется значение свойства Заголовок
.
Изображение
Значение типа ДвоичныйОбъект.Ссылка
. Ссылка на двоичные данные картинки в кнопке.
ИзображениеАктивного
Значение типа Авто|ДвоичныйОбъект.Ссылка
. Задает адрес картинки в активном состоянии. Имеет смысл, только если свойство Переключаемость
равно Истина
. Если свойство ИзображениеАктивного
неопределено, то используется значение свойства Изображение
.
Картинка
Картинка, которую использует кнопка.
КартинкаАктивного
Значение типа Картинка
. Ссылка на внутренний компонент Картинка
, который отображается в активном состоянии. Может использоваться для дополнительного оформления картинки.
Команды
Команда
или массив команд (ГруппаКомандногоИнтерфейса<Команда>
), назначенных кнопке. Если указан массив команд, то они будут размещены в меню кнопки.
ОпасностьДействия
Авто|ОпасностьДействия
. Возможные значения: Отсутствует, Средняя, Высокая.
Переключаемость
Авто|Булево
. Признак переключаемости кнопки. Если имеет значение Истина
, то при нажатии на кнопку инвертируется свойство Активность
. Если кнопке назначена переключаемая команда, то значение свойства Переключаемость
игнорируется: кнопка будет переключаемой.
Подсказка
Авто|Строка
. Подсказка кнопки.
ПодсказкаАктивного
Авто|Строка
. Подсказка кнопки в активном состоянии.
ВесПриРастягивании
Значимость данного компонента по сравнению с другими растягиваемыми компонентами. Например, если у данного компонента ВесПриРастягивании
= 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
Имя: МояГруппа
Наследует:
Тип: ФиксированнаяГруппа