• Post category:ApiDrawing
  • Запись изменена:09.12.2023

new ApiDrawing()

Класс, представляющий графический объект.

Методы

Название Описание
AddBreak Вставляет разрыв в указанное место в основном документе.
Copy Копирует текущий графический объект.
Delete Удаляет текущий графический объект.
Fill Задает свойства форматирования заливки для текущего графического объекта.
GetClassType Возвращает тип класса ApiDrawing.
GetHeight Возвращает высоту текущего рисунка.
GetLockValue Возвращает значение блокировки для указанного типа блокировки текущего рисунка.
GetNextDrawing Возвращает следующий встроенный объект рисования, если он существует.
GetParentContentControl Возвращает родительский элемент управления содержимым, содержащий графический объект.
GetParentParagraph Возвращает родительский абзац, содержащий графический объект.
GetParentTable Возвращает родительскую таблицу, содержащую графический объект.
GetParentTableCell Возвращает родительскую ячейку таблицы, содержащую графический объект.
GetPrevDrawing Возвращает предыдущий встроенный объект рисования, если он существует.
GetWidth Возвращает ширину текущего рисунка.
InsertInContentControl Обертывает графический объект элементом управления текстовым содержимым.
InsertParagraph Вставляет абзац в заданную позицию.
ScaleHeight Масштабирует высоту фигуры с помощью указанного коэффициента.
ScaleWidth Масштабирует ширину фигуры с помощью указанного коэффициента.
Select Выбирает текущий графический объект.
SetDistances Определяет минимальное расстояние, которое будет поддерживаться между краями текущего объекта рисования и любым последующим текстом.
SetDrawingPrFromDrawing Задает свойства другого чертежа для текущего чертежа. Будут скопированы следующие свойства: горизонтальное и вертикальное выравнивание, расстояние между краями текущего объекта чертежа и любым последующим текстом, стиль обтекания, имя чертежа, заголовок и описание.
SetHorAlign Определяет, как плавающий объект будет выровнен по горизонтали.
SetHorFlip Переворачивает текущий рисунок по горизонтали.
SetHorPosition Устанавливает абсолютное измерение для горизонтального позиционирования плавающего объекта.
SetLockValue Устанавливает значение блокировки на указанный тип блокировки текущего чертежа.
SetOutLine Задает свойства контура для указанного графического объекта.
SetSize Задает размер ограничивающей рамки объекта (изображение, фигура, диаграмма).
SetVerAlign Указывает, как плавающий объект будет выровнен по вертикали.
SetVerPosition Устанавливает абсолютное измерение для вертикального позиционирования плавающего объекта.
SetVertFlip Переворачивает текущий рисунок по вертикали.
SetWrappingStyle Задает тип обтекания текущего объекта (изображение, фигура, диаграмма). Можно установить один из следующих стилей обтекания:

  • «inline» — объект рассматривается как часть текста, как символ, поэтому при перемещении текста перемещается и объект. В этом случае параметры позиционирования недоступны. Если выбран один из следующих стилей, объект можно перемещать независимо от текста и точно позиционировать на странице:
  • «square» — текст обволакивает прямоугольную рамку, ограничивающую объект.
  • «tight» — текст обволакивает фактические края объекта.
  • «through» — текст обтекает края объекта и заполняет пустое пространство внутри объекта.
  • «topAndBottom» — текст только над и под объектом.
  • «behind» — текст перекрывает объект.
  • «inFront» -объект перекрывает текст.
ToJSON Преобразует объект ApiDrawing в объект JSON.

Пример

builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oParagraph = oDocument.GetElement(0);
oParagraph.AddText("This is a paragraph with a shape. ");
oParagraph.AddText("The text wraps the rectangular box that bounds the object. ");
oParagraph.AddText("The distance between the shape and the text is half an inch (457200 English measure units).");
var oGs1 = Api.CreateGradientStop(Api.CreateRGBColor(255, 224, 204), 0);
var oGs2 = Api.CreateGradientStop(Api.CreateRGBColor(155, 64, 1), 100000);
var oFill = Api.CreateRadialGradientFill([oGs1, oGs2]);
var oStroke = Api.CreateStroke(0, Api.CreateNoFill());
var oDrawing = Api.CreateShape("rect", 1908000, 1404000, oFill, oStroke);
oDrawing.SetDistances(457200, 457200, 457200, 0);
oDrawing.SetWrappingStyle("square");
oDrawing.SetHorAlign("page", "center");
oParagraph.AddDrawing(oDrawing);
oParagraph = Api.CreateParagraph();
oParagraph.AddText("This is another paragraph.");
oDocument.Push(oParagraph);
oParagraph = Api.CreateParagraph();
oParagraph.AddText("The shape is aligned at the center of the page horizontally.");
oDocument.Push(oParagraph);
builder.SaveFile("docx", "ApiDrawing.docx");
builder.CloseFile();