Устанавливает элемент управления для редактирования значения рисунка типа "Текст".
Синтаксис
УстановитьЭлементУправления(<ТипЭлементаУправления>)Полное описание, параметры и ограничения
РисунокТабличногоДокумента.УстановитьЭлементУправления (SpreadsheetDocumentDrawing.SetControl)
РисунокТабличногоДокумента (SpreadsheetDocumentDrawing)
УстановитьЭлементУправления (SetControl)
Доступен, начиная с версии 8.0.
Синтаксис:
УстановитьЭлементУправления(<ТипЭлементаУправления>)
Параметры:
<ТипЭлементаУправления> (обязательный)
Тип: Тип.
Задает тип элемента управления, который устанавливается.
Описание:
Устанавливает элемент управления для редактирования значения рисунка типа "Текст".
Доступность:
Сервер, толстый клиент, внешнее соединение.
Примечание:
Применяется только для рисунков типа Текст. Доступно, если свойство СодержитЗначение равно Истина.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Настроить ввод четырёх цифр в собственном рисунке
Редактор можно установить только для рисунка Текст с СодержитЗначение = Истина. Используем строковый код 1234, не пароль и не номер рабочего товара.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Надпись = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Текст);
Надпись.Имя = "УчебнаяНадпись";
Надпись.Лево = 5;
Надпись.Верх = 5;
Надпись.Ширина = 80;
Надпись.Высота = 25;
Надпись.АвтоРазмер = Ложь;
Надпись.СодержитЗначение = Истина;
Надпись.ТипЗначения = Новый ОписаниеТипов("Строка", Новый КвалификаторыСтроки(4));
Надпись.Значение = "";
Надпись.УстановитьЭлементУправления(Тип("ПолеВвода"));
Надпись.Маска = "9999";
Надпись.АвтоОтметкаНезаполненного = Ложь;
Надпись.ОтметкаНезаполненного = Истина;
Сообщить(Надпись.ОтметкаНезаполненного);
Надпись.Значение = "1234";
Если СтрДлина(Надпись.Значение) = 4 Тогда
Надпись.ОтметкаНезаполненного = Ложь;
КонецЕсли;
ТабДок.ТолькоПросмотр = Ложь;
Надпись.Защита = Ложь;
Сообщить(Надпись.Значение = "1234");
Сообщить(Не Надпись.ОтметкаНезаполненного);
Сообщить(Не Надпись.АвтоОтметкаНезаполненного);
Сообщить("Фактический тип редактора: " + Строка(ТипЗнч(Надпись.ЭлементУправления)));
Возврат ТабДок;
КонецФункции
Разбор по шагам
Устанавливаем тип строки длиной четыре. Рисунок должен иметь тип Текст и содержать значение до вызова УстановитьЭлементУправления.
Маска 9999 ограничивает ввод цифровыми позициями. Она не заменяет серверную проверку бизнес-данных и не создаёт секретное поле.
Автоматическая отметка отключена: управляем флагом явно, сначала отмечаем пустое, затем снимаем отметку после проверки длины собственного значения.
ТолькоПросмотр и Защита выключены только у нового учебного документа. Редактирование этого кода не пишет в справочники.
Как проверить результат
Четыре булевы проверки дают Истина; последнее сообщение показывает фактический тип редактора.
В режиме редактирования собственного документа попробуйте изменить текстовый рисунок: значение ограничено четырьмя цифрами.
Автоматической повторной проверки после пользовательского ввода здесь нет: показанный контроль выполнен при построении.
Ожидаемый результат
Минимальная настройка редактора и явной отметки незаполненного значения.
На что обратить внимание
ПолеВвода здесь — тип редактора табличного рисунка, не ПолеФормы управляемой формы. Не создавайте этот редактор прямым Новый ПолеФормы.
Клиентские маски и отметки не являются проверкой прав, обязательности реквизита или защиты от подмены.
Поведение редактирования рисунков проверяйте в клиенте Windows; перенос в веб/мобильный клиент не обещается.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.