Элементы управления в диаграммах

Иногда вам может потребоваться вставить объекты рисования, такие как метки, текстовые поля, изображения и т. д., в график. Aspose.Cells может добавлять элементы управления в график во время выполнения.

Добавление элемента управления метки в график

Метки предоставляют средство информирования пользователей о содержании электронной таблицы. Aspose.Cells позволяет добавлять и управлять метками даже в диаграммах.

Класс ShapeCollection предоставляет метод с названием addLabelInChart, используемый для добавления контрольной метки к диаграмме. Ниже приведен список параметров, используемых для этого метода:

• top – вертикальное смещение метки от верхнего левого угла в единицах 1/4000 от области графика.
• left – горизонтальное смещение метки от верхнего левого угла в единицах 1/4000 от области графика.
• height – высота метки в единицах 1/4000 от области графика.
• width – ширина метки в единицах 1/4000 от области диаграммы.

Метод возвращает объект класса Label, где класс Label представляет метку в диаграмме. Он имеет несколько важных членов, как показано ниже:

• свойство Text указывает строку заголовка метки.
• свойство Fill указывает атрибуты цвета заливки.

В следующем примере показано, как добавить метку в диаграмму. В примере используется файл дизайнера, в котором есть диаграмма. Мы используем этот файл для вставки метки в диаграмму.

Ниже приведен снимок экрана файла дизайнера.

Диаграмма дизайнера

Ниже приведен исходный код для добавления метки в диаграмму. При выполнении кода генерируется следующий вывод.

Метка добавлена в диаграмму

Добавление элемента управления текстовым полем в график

Один из способов выделить важную информацию в отчете – использование текстового поля. Например, введите текст для выделения названия компании или для указания географического региона с наибольшими продажами. Класс ShapeCollection предоставляет метод с именем addTextBoxInChart, который используется для добавления элемента управления текстовым полем в график. Ниже приведен список параметров, используемых для метода:

• top – вертикальное смещение текстового поля от верхнего левого угла в единицах 1/4000 от области графика.
• left - горизонтальное смещение текстового поля от верхнего левого угла в единицах 1/4000 от области диаграммы.
• height – высота текстового поля в единицах 1/4000 от области графика.
• ширина - ширина текстового блока в единицах 1/4000 от области диаграммы.

Метод возвращает объект класса TextBox, где класс TextBox представляет текстовое поле в диаграмме.

В следующем примере показано, как добавить текстовое поле в диаграмму. В примере используется предыдущий файл дизайнера с диаграммой. Мы используем этот файл, чтобы вставить текстовое поле в диаграмму и показать название диаграммы.

Ниже приведен исходный код для добавления текстового поля в диаграмму. Ниже приведен результат выполнения кода.

В диаграмму добавлено текстовое поле

Добавление изображения на диаграмму

Aspose.Cells позволяет вставлять изображения в диаграмму. Например, добавьте изображение, чтобы подчеркнуть или придать больший смысл диаграмме или ее содержимому, или вставьте файл изображения бренда.

Класс ShapeCollection предоставляет метод с именем addPictureInChart, который используется для добавления объекта изображения на диаграмму. Ниже приведен список параметров, используемых для метода:

• верх - вертикальное смещение изображения от верхнего левого угла в единицах 1/4000 от области диаграммы.
• слева - горизонтальное смещение изображения от верхнего левого угла в единицах 1/4000 от области диаграммы.
• поток - объект потока, содержащий данные изображения.
• масштабШирины - масштаб ширины изображения, значение в процентах.
• масштабВысоты - масштаб высоты изображения, значение в процентах.

Метод возвращает объект класса Picture, где класс Picture представляет объект изображения в диаграмме.

В следующем примере показано, как добавить изображение в диаграмму. Пример использует предыдущий файл дизайнера с диаграммой. Мы используем этот файл, чтобы вставить изображение в диаграмму.

Ниже приведен исходный код для добавления изображения в диаграмму. Ниже приведен результат выполнения кода.

Вставлено изображение в диаграмму

Добавление флажка на диаграмму

Aspose.Cells позволяет вам вставлять флажки в лист диаграммы, используя перечисление MsoDrawingType. Приведенный ниже пример демонстрирует добавление флажка на лист диаграммы.

На следующем изображении показан лист диаграммы с флажком в выходном файле.

Сгенерированный кодом сниппет выходной файл output file прилагается для вашего ознакомления.