Устанавливает новое выделение. Элементы, тип которых отличается от ТочкаДиаграммы, СерияДиаграммы , ЗначениеДиаграммы игнорируются.
Синтаксис
УстановитьВыделенныеЭлементы(<МассивЭлементов>)Полное описание, параметры и ограничения
РисунокТабличногоДокумента.УстановитьВыделенныеЭлементы (SpreadsheetDocumentDrawing.SetSelectedItems)
РисунокТабличногоДокумента (SpreadsheetDocumentDrawing)
УстановитьВыделенныеЭлементы (SetSelectedItems)
Доступен, начиная с версии 8.3.14.
Синтаксис:
УстановитьВыделенныеЭлементы(<МассивЭлементов>)
Параметры:
<МассивЭлементов> (необязательный)
Тип: Массив.
Массив выделяемых элементов.
Описание:
Устанавливает новое выделение. Элементы, тип которых отличается от ТочкаДиаграммы, СерияДиаграммы , ЗначениеДиаграммы игнорируются.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.3.14.
Методическая информация
Практические примеры
Выделить мартовское значение на диаграмме табличного документа
Методы рисунка работают с элементами диаграммы: точкой, серией или значением. Это не выделение самого рисунка в документе.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Рисунок = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Диаграмма);
Рисунок.Имя = "УчебнаяДиаграмма";
Рисунок.Расположить(ТабДок.Область(1, 1, 20, 10));
Диаграмма = Рисунок.Объект;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
План = Диаграмма.УстановитьСерию("plan");
План.Текст = "План, шт.";
Факт = Диаграмма.УстановитьСерию("actual");
Факт.Текст = "Факт, шт.";
Месяцы = Новый Массив;
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-01", "Январь", 10, 8));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-02", "Февраль", 12, 11));
Месяцы.Добавить(Новый Структура("Ключ,Название,План,Факт", "2026-03", "Март", 15, 16));
Для Каждого Месяц Из Месяцы Цикл
Точка = Диаграмма.УстановитьТочку(Месяц.Ключ);
Точка.Текст = Месяц.Название;
Диаграмма.УстановитьЗначение(Точка, План, Месяц.План);
Диаграмма.УстановитьЗначение(Точка, Факт, Месяц.Факт);
КонецЦикла;
Диаграмма.РежимВыделения = РежимВыделенияДиаграммы.ВыделениеЗначений;
Март = Диаграмма.УстановитьТочку("2026-03");
МартФакт = Диаграмма.ПолучитьЗначение(Март, Факт);
Выделение = Новый Массив;
Выделение.Добавить(МартФакт);
Рисунок.УстановитьВыделенныеЭлементы(Выделение);
Выбранные = Рисунок.ПолучитьВыделенныеЭлементы();
Сообщить(Выбранные.Количество() = 1);
Сообщить(ТипЗнч(Выбранные.Получить(0)) = Тип("ЗначениеДиаграммы"));
Сообщить(МартФакт.Значение = 16);
Рисунок.УстановитьВыделенныеЭлементы(Новый Массив);
Сообщить(Рисунок.ПолучитьВыделенныеЭлементы().Количество() = 0);
ТабДок.ТолькоПросмотр = Истина;
Возврат ТабДок;
КонецФункции
Разбор по шагам
Рисунок типа Диаграмма создаёт объект диаграммы. Расположить принимает область ячеек; это другой способ задания геометрии, не четыре числовых аргумента.
В собственной матрице мартовский факт равен 16. ПолучитьЗначение возвращает объект ЗначениеДиаграммы для пары точка/серия.
УстановитьВыделенныеЭлементы получает массив именно объектов диаграммы. Проверяем количество/тип, затем снимаем выделение пустым массивом.
В финальном показе выделение снято намеренно. Для демонстрации выделенного марта временно не выполняйте последние две строки снятия/проверки.
Как проверить результат
Четыре проверки дают Истина.
В показе план/факт за три месяца: 10/8, 12/11, 15/16. Выделение элементов и изменение чисел — разные операции.
Ожидаемый результат
Управление выделением одного значения без редактирования данных диаграммы.
На что обратить внимание
Эти методы предназначены для рисунка типа Диаграмма, не для картинки или надписи.
Массив неподходящих типов игнорируется платформой; не передавайте строку 2026-03 вместо объекта точки/значения.
ВыделенныеОбласти табличного документа выделяют другой уровень объектов и здесь не используются.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.