Потоковые документы

WPF --- Периферия WPF --- Потоковые документы

Потоковый документ WPF создается с помощью сочетания потоковых элементов. Потоковые элементы существенно отличаются от элементов, с которыми вы имели дело до настоящего момента, тем, что они не являются наследниками знакомых вам классов UIElement и FrameworkElement. Они формируют совершенно отдельную ветвь классов, порожденных от ContentElement и FrameworkContentElement.

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

Ключевым отличием элементов вывода содержимого от элементов, не связанных с содержимым, является то, что первые не выполняют свою прорисовку. Для этого им необходим контейнер, который сможет отобразить все элементы вывода содержимого. Такая отложенная прорисовка позволяет контейнеру выполнять разнообразную оптимизацию.

Например, контейнер может выбрать наиболее подходящий способ разрыва строк текста в абзаце, даже если этот абзац является единственным элементом.

Элементы вывода содержимого могут принимать фокус, хотя обычно этого не происходит (т.к. свойство Focusable по умолчанию имеет значение false). Чтобы элемент вывода содержимого мог принимать фокус, присвойте этому свойству значение true, примените стиль типа элемента, изменяющий целую группу элементов, или создайте потомка вашего собственного специального элемента, свойство Focusable которого равно true. Примером элемента вывода содержимого, свойство Focusable которого имеет значение true, является элемент Hyperlink.

На рисунке ниже показана иерархия наследования элементов вывода содержимого:

Элементы вывода содержимого делятся на две категории:

Блочные элементы

Могут применяться для группирования других элементов вывода содержимого. Например, Paragraph (абзац) является блочным элементом. Он может хранить текст разного формата. Каждый раздел текста с отличным форматом является отдельным элементом в абзаце.

Строковые элементы

Эти элементы находятся внутри блочных элементов (или других строковых элементов). Например, элемент Run (фрагмент) содержит текст, который затем может быть вложен в элемент Paragraph.

Модель содержимого позволяет строить несколько уровней вложения. К примеру, внутрь элемента Underline можно поместить элемент Bold, чтобы создать жирный подчеркнутый текст. Аналогично можно создать элемент Section, а внутри него несколько элементов Paragraph, каждый из которых содержит разнообразные строковые элементы с текстовым содержимым. Все эти элементы определены в пространстве имен System.Windows.Documents.

Если вы знакомы с HTML, то эта модель покажется вам весьма знакомой. В WPF принято очень много похожих соглашений (например, различие между блочными и строковыми элементами).

Если же вы очень хорошо знаете HTML, можете попробовать воспользоваться на удивление мощным транслятором из HTML в XAML, который доступен по адресу ссылка. Этот транслятор, реализованный на базе C#, позволяет использовать HTML-страницу в качестве заготовки потокового документа.

Форматирование элементов вывода содержимого

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

Наряду со свойствами, описанными в этих двух таблицах, имеются еще некоторые дополнительные детали, которые можно указывать в отдельных элементах. Некоторые из них связаны с разбиением на страницы и колонки. Здесь мы упомянем следующие свойства:

TextDecorations

Это свойство имеется в элементах Paragraph и во всех элементах, порожденных от класса Inline. Оно принимает значения Strikethrough (зачеркивание), Overline (надчеркивание) или чаще Underline (подчеркивание).

Можно даже объединить эти значения, чтобы получить в тексте несколько линий сразу, хотя такое встречается редко.

Typography

Этим свойством обладает элемент верхнего уровня FlowDocument, а также наследники классов TextBlock и TextElement. Оно предлагает объект Typography, который позволяет изменить самые разные детали прорисовки текста (большинство из них применимо только к шрифтам OpenType).

Создание простого потокового документа

Теперь, когда вы уже имеете представление о том, что такое модель элементов вывода содержимого, можно приступить к сборке некоторых элементов вывода содержимого в простой потоковый документ.

Потоковый документ создается с помощью класса FlowDocument. Visual Studio позволяет либо создать новый потоковый документ как отдельный файл, либо определить его внутри существующего окна, используя один из поддерживаемых контейнеров. Пока для создания потокового документа воспользуемся контейнером FlowDocumentScrollViewer. Ниже показан первоначальный вид разметки:

<Window x:Class="Wpf_Documents.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="WPF Documents API" Height="390" Width="525">
    <FlowDocumentScrollViewer>
        <FlowDocument>
            ...
        </FlowDocument>
    </FlowDocumentScrollViewer>
</Window>

На данный момент не существует интерфейса WYSIWYG (What You See Is What You Get — что видишь, то и получаешь) для создания потоковых документов. Некоторые разработчики создают инструменты, которые могут преобразовывать файлы, написанные в Word 2007 XML (известном как WordML), в файлы XAML посредством разметки потокового документа. Однако такие средства не готовы к массовому производству. А пока можно создать простой текстовый редактор с помощью элемента управления RichTextBox и использовать его для создания содержимого потокового документа.

Можно предположить, что теперь нужно лишь ввести текст внутри элемента FlowDocument, однако это невозможно. Высокоуровневый потоковый документ должен использовать элемент блочного уровня. Ниже показан пример с элементом Paragraph:

<FlowDocumentScrollViewer>
        <FlowDocument>
            <Paragraph>Hello, world!</Paragraph>
            <Paragraph>Это первый абзац</Paragraph>
        </FlowDocument>
</FlowDocumentScrollViewer>

На рисунке представлен результат:

Линейка прокрутки добавляется автоматически. Шрифт (Segoe UI) выбирается из системных настроек Windows, а не из вмещающего окна.

Обычно элемент FlowDocumentScrollViewer позволяет выделять текст (как в веб-браузере). Таким образом пользователь может копировать части документа в буфер обмена Windows и вставлять их в другие приложения. Если это нежелательно, присвойте свойству FlowDocumentScrollViewer.IsSelectionEnabled значение false.