Open XML SDK в C#. Класс Run — работа с участками текста

В предыдущей части мы изучили вопросы, связанные с оформлением абзацев текста в Open XML с использованием класса Paragraph. В этой части мы рассмотрим вопросы, связанные с оформлением отдельных участков текста в абзаце. Класс Run в Open XML представляет собой участок текста с одним оформлением. 

Класс Run

Класс Run в Open XML — это относительно простой класс, который сериализуется в узел <w:r>и представляет собой отдельный участок текста внутри абзаца. Так, абзац в документе Word может содержать набор объектов типа Run, каждый из которых оформлен по своему. Вся функциональность, связанная с оформлением текста, сосредоточена в одном свойстве — RunProperties, которое представляется объектом одноименного типа и именно этот класс содержит множество свойств, отвечающих за стиль оформления текста внутри одного элемента Run. Рассмотрим, какие свойства мы можем использовать в работе.

Свойство RunProperties

Свойство RunProperties представляется объектом одноименного типа — RunProperties.Все свойства в этом объекте, определяющие оформление текста относятся к прямому форматированию. То есть, вначале применяются свойства форматирования на уровне документа, а затем — перечисленные в RunProperties.

Как можно видеть, RunProperties, содержит достаточно много свойств для оформления текста (и это только основные свойства, по факту — их ещё больше). Однако, используются они, практически все идентично. Например, ниже представлен фрагмент кода в котором строка текста будет написана полужирным курсивом:

using WordprocessingDocument doc = WordprocessingDocument.Create("hello.docx", DocumentFormat.OpenXml.WordprocessingDocumentType.Document);

MainDocumentPart mainPart = doc.AddMainDocumentPart();
mainPart.Document = new Document();
Body body = mainPart.Document.AppendChild(new Body());
Paragraph para = body.AppendChild(new Paragraph(
    new Run(
           new Text("Это строка текста с написана полужирным курсивом. Размер шрифта - 14pt Это пример работы с Open XML и документов Word"))
    {
        RunProperties = new RunProperties() 
        {
            Bold = new Bold(),
            Italic = new Italic(),
            FontSize = new FontSize() { Val="28"},
        }
    }
    )
 );

В результате выполнения этого примера, мы получим документ со следующим содержимым:

Рассмотрим другой пример: как сделать в одном абзаце несколько фрагментов текста с различным оформлением?

using WordprocessingDocument doc = WordprocessingDocument.Create("hello.docx", DocumentFormat.OpenXml.WordprocessingDocumentType.Document);

MainDocumentPart mainPart = doc.AddMainDocumentPart();
mainPart.Document = new Document();
Body body = mainPart.Document.AppendChild(new Body());
Paragraph para = body.AppendChild(new Paragraph(
    new Run(
           new Text("Это строка текста с написана полужирным курсивом. "))
    {
        RunProperties = new RunProperties() 
        {
            Bold = new Bold(),
            Italic = new Italic(),
            FontSize = new FontSize() { Val="28"},
   
        }
    },
    new Run(new Text("Этот текст красного цвета")) 
    {
        RunProperties= new RunProperties()
        {
            Color = new Color() { Val="ff0000"}
        }
    }
    )
 );

В примере выше мы создаем абзац, состоящий из двух фрагментов текста: первый фрагмент полужирный курсив, второй — красного цвета. Но обратите внимание на то, как будет выглядеть текст в Word:

Несмотря на то, что в конце первой строки стоит пробел, в итоговом документе этот пробел был убран в результате чего Word сообщает нам об орфографической ошибке. Чтобы такого не происходило и строка текста выводилась в документ как есть, необходимо использовать настройки текста в строке. Перепишем наш пример следующим образом:

using WordprocessingDocument doc = WordprocessingDocument.Create("hello.docx", DocumentFormat.OpenXml.WordprocessingDocumentType.Document);

MainDocumentPart mainPart = doc.AddMainDocumentPart();
mainPart.Document = new Document();
Body body = mainPart.Document.AppendChild(new Body());
Paragraph para = body.AppendChild(new Paragraph(
    new Run(
        //в этой строке будут сохраняться начальные и конечные пробелы
           new Text("Это строка текста с написана полужирным курсивом. ") { Space = SpaceProcessingModeValues.Preserve})
    {
        RunProperties = new RunProperties() 
        {
            Bold = new Bold(),
            Italic = new Italic(),
            FontSize = new FontSize() { Val="28"},
   
        }
    },
    new Run(new Text("Этот текст красного цвета")) 
    {
        RunProperties= new RunProperties()
        {
            Color = new Color() { Val="ff0000"}
        }
    }
    )
 );

Теперь при выводе текста в первом фрагменте все начальные и конечные пробелы будут выводиться как есть:

Итого

Для того, чтобы в Open XML настроить оформление текста в абзаце используется свойство RunProperties объекта Run. Чтобы сохранить начальные и конечные пробелы в строке текста необходимо использовать свойство Space в объекте Text со значением SpaceProcessingModeValues.Preserve.