Тип: Число. Содержит высоту выпадающего списка выбора. Высота измеряется в строках.
Полное описание, параметры и ограничения
Расширение поля формы для поля ввода.ВысотаСпискаВыбора (Form field extension for a text box.ChoiceListHeight)
Расширение поля формы для поля ввода (Form field extension for a text box)
ВысотаСпискаВыбора (ChoiceListHeight)
Доступен, начиная с версии 8.2.
Использование:
Чтение и запись.
Описание:
Тип: Число.
Содержит высоту выпадающего списка выбора. Высота измеряется в строках.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Выбрать статус из списка и отличить значение от представления
Пользователь выбирает Черновик/Опубликован/Закрыт, а реквизит хранит draft/published/closed. Список задаётся полностью в коде формы.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.
Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.
Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Новые = Новый Массив;
ТипРеквизита = Новый ОписаниеТипов("Строка", , Новый КвалификаторыСтроки(24));
Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
ЭтаФорма.ИзменитьРеквизиты(Новые);
ЭтаФорма.ЗначениеПримера = "draft";
Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеВвода;
Поле.ПутьКДанным = "ЗначениеПримера";
Поле.Заголовок = "Статус учебной карточки";
Поле.СписокВыбора.Добавить("draft", "Черновик");
Поле.СписокВыбора.Добавить("published", "Опубликован");
Поле.СписокВыбора.Добавить("closed", "Закрыт");
Поле.РежимВыбораИзСписка = Истина;
Поле.РедактированиеТекста = Ложь;
Поле.КнопкаСпискаВыбора = Истина;
Поле.КнопкаВыпадающегоСписка = Истина;
Поле.КнопкаОчистки = Истина;
Поле.ВысотаСпискаВыбора = 3;
Поле.ШиринаВыпадающегоСписка = 24;
Поле.ОтметкаОбязательногоЗаполнения = Истина;
Поле.АвтоВыборНезаполненного = Ложь;
Поле.АвтоОтметкаНезаполненного = Истина;
КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
КомандаДействия.Действие = "УчебноеДействие";
КомандаДействия.Заголовок = "Проверить выбранный статус";
КомандаДействия.Подсказка = "Действие только над данными учебной формы";
КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
Кнопка.ИмяКоманды = КомандаДействия.Имя;
Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры
&НаКлиенте
Процедура УчебноеДействие(Команда)
Если ЗначениеПримера <> "draft" И ЗначениеПримера <> "published"
И ЗначениеПримера <> "closed" Тогда
Сообщить("Выберите один из трёх статусов. Пустой/неизвестный статус не обработан.");
Возврат;
КонецЕсли;
Сообщить("Хранимый код статуса: " + ЗначениеПримера);
Сообщить("Карточка в базе или на сайте не изменена");
КонецПроцедуры
Разбор по шагам
СписокВыбора — существующий СписокЗначений поля. Его наполняют методом Добавить; присваивать новую коллекцию свойству не нужно.
Первый аргумент Добавить — значение для реквизита, второй — удобное представление для человека.
РежимВыбораИзСписка и запрет редактирования текста направляют пользователя к подготовленным вариантам.
КнопкаОчистки оставлена для демонстрации отсутствующего значения; команда в этом случае отказывается от обработки.
Отметка обязательного заполнения визуальна. Код явно проверяет все допустимые значения до любого последующего обмена.
Как проверить результат
Выберите Опубликован, затем кнопку: выводится код published, а не слово Опубликован.
После очистки выводится просьба выбрать статус; значение не отправляется в сервис.
В списке три варианта и нет автоматического назначения первого при пустом поле.
Ожидаемый результат
Создан законченный выбор статуса с человеческими подписями и стабильными строковыми кодами.
На что обратить внимание
Это учебный набор, не реальные состояния API Авито. Перед интеграцией сверяйте контракт сервиса.
Представление может меняться или переводиться, поэтому обмен должен использовать код, а не подпись.
Красная отметка обязательности не запускает проверку вашего внешнего обмена автоматически.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.