• Post category:ApiRun
  • Запись изменена:27.01.2024

new ApiRun()

Класс, представляющий небольшой текстовый блок под названием «run».

Методы

НазваниеОписание
AddLineBreakДобавляет разрыв строки в текущую позицию выполнения и начинает следующий элемент с новой строки.
AddTabStopДобавляет табуляцию к текущему запуску.
AddTextДобавляет текст в текущий запуск.
ClearContentУдаляет содержимое текущего запуска.
CopyСоздает копию текущего запуска.
DeleteУдаляет текущий запуск.
GetClassTypeВозвращает тип класса ApiRun.
GetFontNamesВозвращает все имена шрифтов из всех элементов текущего выполнения.
GetTextPrВозвращает текстовые свойства текущего запуска.
RemoveAllElementsУдаляет все элементы из текущего выполнения.
SetBoldУстанавливает свойство полужирного шрифта для текстового символа.
SetCapsУказывает, что любые символы нижнего регистра в текущем текстовом фрагменте форматируются для отображения только как эквиваленты символов заглавных букв.
SetColorУстанавливает цвет текста для текущего текста в формате RGB.
SetDoubleStrikeoutУказывает, что содержимое текущего запуска отображается в виде двух горизонтальных линий, пересекающих каждый символ, отображаемый в строке.
SetFillУстанавливает цвет текста для текущего текста.
SetFontFamilyУстанавливает все 4 слота шрифтов с указанным семейством шрифтов.
SetFontSizeУстанавливает размер шрифта в соответствии с символами текущего текста.
SetHighlightУказывает цвет выделения, который применяется в качестве фона к содержимому текущего запуска.
SetItalicУстанавливает свойство курсива для текстового символа.
SetLanguageУказывает языки, которые будут использоваться для проверки орфографии и грамматики (если требуется) при обработке содержимого этого текстового прогона.
SetOutLineУстанавливает структуру текста для текущего фрагмента текста.
SetPositionУказывает величину, на которую текст поднимается или опускается для этого прогона относительно базовой линии по умолчанию для окружающего непозиционированного текста.
SetShdУказывает затенение, применяемое к содержимому текущего фрагмента текста.
SetSmallCapsУказывает, что все символы строчных букв в этом фрагменте текста форматируются для отображения только как эквиваленты символов заглавных букв, которые на два пункта меньше фактического размера шрифта, указанного для этого текста.
SetSpacingУстанавливает интервал между текстом, измеряемый в двадцатых долях точки.
SetStrikeoutУказывает, что содержимое текущего запуска отображается одной горизонтальной линией, проходящей через центр линии.
SetStyleУстанавливает стиль для текущего выполнения.
SetTextFillУстанавливает заливку текста для текущего фрагмента текста.
SetTextPrУстанавливает свойства текста для текущего запуска.
SetUnderlineУказывает, что содержимое текущего запуска отображается вместе со строкой, расположенной непосредственно под символом (меньше, чем все пробелы над и под символами в строке).
SetVertAlignУказывает выравнивание, которое будет применено к содержимому текущего фрагмента относительно внешнего вида текстового фрагмента по умолчанию:

  • «базовая линия» — символы в текущем текстовом фрагменте будут выровнены по базовой линии текста по умолчанию.
  • «нижний индекс» — символы в текущем текстовом фрагменте будут выровнены ниже базовой линии текста по умолчанию.
  • «надстрочный индекс» — символы в текущем текстовом фрагменте будут выровнены над базовой линией текста по умолчанию.

Пример

builder.CreateFile("pptx");
var oPresentation = Api.GetPresentation();
var oSlide = oPresentation.GetSlideByIndex(0);
oSlide.RemoveAllObjects();
var oFill = Api.CreateSolidFill(Api.CreateRGBColor(255, 111, 61));
var oStroke = Api.CreateStroke(0, Api.CreateNoFill());
var oShape = Api.CreateShape("flowChartMagneticTape", 300 * 36000, 130 * 36000, oFill, oStroke);
oShape.SetPosition(608400, 1267200);
var oDocContent = oShape.GetDocContent();
var oParagraph = oDocContent.GetElement(0);
var oRun = Api.CreateRun();
oRun.SetItalic(true);
oRun.AddText("This is the text for the first line. Nothing special.");
oRun.AddLineBreak();
oRun.AddText("This is the text which starts from the beginning of the second line. ");
oRun.AddText("It is written in two text runs, you need a space at the end of the first run sentence to separate them.");
oParagraph.AddElement(oRun);
oRun = Api.CreateRun();
oRun.SetFontSize(30);
oRun.SetFontFamily("Comic Sans MS");
oRun.AddText("This is just a sample text. After it three tab stops will be added.");
oRun.SetBold(true);
oRun.AddTabStop();
oRun.AddTabStop();
oRun.AddTabStop();
oRun.AddText("This is the text which starts after the tab stops.");
oParagraph.AddLineBreak();
oParagraph.AddElement(oRun);
oRun = Api.CreateRun();
oRun.AddText("This is just a sample text that was copied. ");
oRun.SetColor(51, 51, 51);
oParagraph.AddLineBreak();
oParagraph.AddElement(oRun);
var oCopyRun = oRun.Copy();
var sClassType = oCopyRun.GetClassType();
oCopyRun.AddLineBreak();
oCopyRun.AddText("Class Type = " + sClassType);
oCopyRun.SetCaps(true);
oParagraph.AddElement(oCopyRun);
oSlide.AddObject(oShape);
builder.SaveFile("pptx", "ApiRun.pptx");
builder.CloseFile();