• Post category:ApiRun
  • Запись изменена:26.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("xlsx");
var oWorksheet = Api.GetActiveSheet();
var oFill = Api.CreateSolidFill(Api.CreateRGBColor(255, 111, 61));
var oStroke = Api.CreateStroke(0, Api.CreateNoFill());
var oShape = oWorksheet.AddShape("flowChartOnlineStorage", 120 * 36000, 70 * 36000, oFill, oStroke, 0, 2 * 36000, 0, 3 * 36000);
var oDocContent = oShape.GetContent();
var oParagraph = oDocContent.GetElement(0);
var oRun = Api.CreateRun();
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. After it three tab stops will be added.");
oRun.AddTabStop();
oRun.AddTabStop();
oRun.AddTabStop();
oRun.AddText("This is the text which starts after the tab stops.");
oRun.SetItalic(true);
oParagraph.AddElement(oRun);
oRun = Api.CreateRun();
var oTextPr = oRun.GetTextPr();
oTextPr.SetFontSize(30);
oRun.AddText("This is just a sample text. ");
oRun.AddText("But you will not see it in the resulting document, as it will be cleared.");
oParagraph.AddElement(oRun);
oRun.ClearContent();
oParagraph = Api.CreateParagraph();
oRun = Api.CreateRun();
oRun.AddText("The text in the previous paragraph cannot be seen, as it has been cleared.");
oParagraph.AddElement(oRun);
oRun = Api.CreateRun();
oRun.AddLineBreak();
oRun.AddText("This is just a sample text that was copied.");
oParagraph.AddElement(oRun);
var oCopyRun = oRun.Copy();
oCopyRun.SetCaps(true);
oCopyRun.SetBold(true);
oCopyRun.SetFontSize(20);
var sClassType = oCopyRun.GetClassType();
oCopyRun.AddLineBreak();
oCopyRun.AddText("Class Type = " + sClassType);
oParagraph.AddElement(oCopyRun);
oDocContent.Push(oParagraph);
builder.SaveFile("xlsx", "ApiRun.xlsx");
builder.CloseFile();