ApiDrawing

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();