Формы в диаграммах

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

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

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

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

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

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

В следующем примере показано, как добавить метку в график. В примере используется файл дизайнера (exp_piechart.xls), в котором есть график. Мы используем этот файл для вставки метки в график. Ниже приведен исходный код для добавления метки в график. При выполнении кода генерируется следующий вывод.

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

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

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

Метод возвращает объект Aspose.Cells.Drawing.TextBox. Класс TextBox представляет собой текстовый блок на диаграмме.

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

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

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

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

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

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

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

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

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

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

todo:image_alt_text

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

Продвинутые темы