Form.Buttons

Buttons (Работа со связанными элементами)
Объект: Форма Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в строку, число Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Форма

Функция позволяет получить доступ к связанным элементам (кнопкам), определенным для текущего визуального элемента. Кнопка задается по цифровому идентификатору. Если кнопка с указанным идентификатором отсутствует, никаких изменений произведено не будет.

Синтаксис

Form.Buttons:(<Идентификатор кнопки-связанного элемента (INT)>,<Тип свойства кнопки-связанного элемента (STRING)>,<Новое значение свойства кнопки-связанного элемента>):<Текущее значение свойства кнопки-связанного элемента>

Аргументы

• <Идентификатор кнопки-связанного элемента (INT)> - Аргумент задает внутренний идентификатор связанного элемента, для которого необходимо получить или изменить свойства. Рекомендуется использование констант (см. Константы).
• <Тип свойства кнопки-связанного элемента (STRING)> - Аргумент задает тип свойства для получения или изменения. Доступны следующие типы свойств:
  • Font -- получает или изменяет шрифт связанной кнопки. Шрифт задается в стандартном виде.
  • Caption -- получает или изменяет заголовок связанного элемента.
  • IsDisabled -- получает или устанавливает свойство недоступности связанного элемента.
  • Hint -- получает или изменяет всплывающую подсказку, ассоциированную со связанным элементом.
  • Color -- получает или изменяет цвет кнопки (не текста) связанного элемента.
  • Remove -- удаляет кнопку с указанным идентификатором, если она определена для визуального элемента.
  • Add -- добавляет кнопку с указанным идентификатором, если она не определена (отсутствует) для визуального элемента.
• <Новое значение свойства кнопки-связанного элемента> - (необязательный аргумент) Аргумент задает новое значение свойства связанного элемента, заданного предыдущим аргументом. Если аргумент не задан, свойство не изменяется.

Возвращаемое значение

Возвращает значение свойства связанного элемента на текущий момент.

Примеры

//Фрагмент изменяет заголовок и вид кнопки связанного элемента 10104 в зависимости от заполненности строки СтрПорядокПечати
If СтрПорядокПечати<>"" Then
  Form.оДПеч.Buttons(10104,"Caption","Порядок (заполнен)");
  Form.оДПеч.Buttons(10104,"Font",",,B");
Else
  Form.оДПеч.Buttons(10104,"Caption","Порядок");
  Form.оДПеч.Buttons(10104,"Font",",,");
EndIf;