DynamicDocumentPaginator Класс

Определение

Пространство имен:

System.Windows.Documents

Сборка:

PresentationCore.dll

Предоставление абстрактного базового класса, который поддерживает автоматическую фоновую разбивку на страницы и отслеживание позиций содержимого при разбивке в дополнение к методам и свойствам его собственного базового класса.

public ref class DynamicDocumentPaginator abstract : System::Windows::Documents::DocumentPaginator

public abstract class DynamicDocumentPaginator : System.Windows.Documents.DocumentPaginator

type DynamicDocumentPaginator = class
    inherit DocumentPaginator

Public MustInherit Class DynamicDocumentPaginator
Inherits DocumentPaginator

Наследование

Object

DocumentPaginator

DynamicDocumentPaginator

Комментарии

По умолчанию автоматически выполняется предварительная DynamicDocumentPaginator разбивка содержимого на страницы в фоновом режиме (этот процесс начинается, когда IsBackgroundPaginationEnabled имеет trueзначение , которое является параметром по умолчанию).

Если IsBackgroundPaginationEnabled имеет значение true, макет также будет изменен из-за изменений в содержимом или изменений в PageSize.

Событие PaginationProgress возникает после завершения разбиения на страницы (или повторной разбиения) одной или нескольких страниц, например в следующих ситуациях:

• PaginationProgress события происходят при разбиении содержимого на страницы в фоновом режиме. В зависимости от реализации событие может возникнуть при разбиении на страницы одной или нескольких страниц (PaginationProgressEventArgs указывает, какие страницы были разбиены на страницы).

• Вызовы или GetPageGetPageAsync могут привести к возникновению PaginationProgress события, если указанная страница не была разложена на страницы. Например, если фоновая разбиение на страницы включена (IsBackgroundPaginationEnabled = true), но разбиение на страницы завершено только до третьей страницы, вызов GetPage с аргументом 6 приведет к разбиению на страницы 4, пять, шесть и семь. По завершении PaginationProgress создается событие с PaginationProgressEventArgs параметрами Start = 4 и Count = 4.

• Если фоновая разбиение на страницы включена (IsBackgroundPaginationEnabled = true), изменение PageSize содержимого формата потока, например FlowDocument, может привести к повторному пагинации и связанным PaginationProgress событиям. Обратите внимание, что PageSize не влияет на изменение размера содержимого в фиксированном формате, например , где FixedDocumentразмер визуальной страницы не влияет на макет.

Событие PaginationCompleted также возникает при отключении фонового разбиения на страницы. Например, если есть только одна страница содержимого и IsBackgroundPaginationEnabled = false), вызов GetPage с аргументом 0 приведет к двум событиям:

1. Событие PaginationProgress с PaginationProgressEventArgs параметрами Start = 0 и Count = 1.

2. Событие PaginationCompleted .

Конструкторы

DynamicDocumentPaginator()

Инициализирует новый экземпляр класса DynamicDocumentPaginator.

Свойства

IsBackgroundPaginationEnabled	Возвращает или задает значение, которое показывает автоматическое выполнение разбивки страницы в фоновом режиме в ответ на такие события, как изменения размера страницы.
IsPageCountValid	Получение значения, указывающего на то, является ли PageCount общим числом страниц, при переопределении в производном классе. (Унаследовано от DocumentPaginator)
PageCount	При переопределении в производном классе возвращает число отформатированных на данный момент страниц. (Унаследовано от DocumentPaginator)
PageSize	Получает или задает варианта ширины и высоты каждой страницы при переопределении в производном классе. (Унаследовано от DocumentPaginator)
Source	Возвращение разбиваемого на страницы элемента при переопределении в производном классе. (Унаследовано от DocumentPaginator)

Методы

CancelAsync(Object)	Отмена предыдущей операции GetPageAsync или GetPageNumberAsync. (Унаследовано от DocumentPaginator)
ComputePageCount()	Обеспечивает разбиение содержимого на страницы, обновляет PageCount новым значением общего количества страниц и присваивает IsPageCountValid значение true. (Унаследовано от DocumentPaginator)
ComputePageCountAsync()	Асинхронный вызов разбивки содержимого на страницы, обновления PageCount новой суммой и установки IsPageCountValid на значение true. (Унаследовано от DocumentPaginator)
ComputePageCountAsync(Object)	Асинхронный вызов разбивки содержимого на страницы, обновления PageCount новой суммой и установки IsPageCountValid на значение true. (Унаследовано от DocumentPaginator)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectPosition(Object)	При переопределении в производном классе возвращает ContentPosition для заданного Object.
GetPage(Int32)	Получение DocumentPage для заданного номера страницы при переопределении в производном классе. (Унаследовано от DocumentPaginator)
GetPageAsync(Int32)	Асинхронное возвращение (посредством события GetPageCompleted) DocumentPage для заданного номера страницы. (Унаследовано от DocumentPaginator)
GetPageAsync(Int32, Object)	Асинхронное возвращение (посредством события GetPageCompleted) DocumentPage для заданного номера страницы и назначение заданного идентификатора для асинхронной задачи. (Унаследовано от DocumentPaginator)
GetPageNumber(ContentPosition)	При переопределении в производном классе возвращает начинающийся с нуля номер страницы для заданного ContentPosition.
GetPageNumberAsync(ContentPosition)	Асинхронный возврат (данный метод вызывает событие GetPageNumberCompleted) начинающегося с нуля номера страницы заданного ContentPosition.
GetPageNumberAsync(ContentPosition, Object)	Асинхронный возврат (данный метод вызывает событие GetPageNumberCompleted) начинающегося с нуля номера страницы заданного ContentPosition.
GetPagePosition(DocumentPage)	При переопределении в производном классе получает положение заданной страницы в содержимом документа.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs)	Вызывает событие ComputePageCountCompleted. (Унаследовано от DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs)	Вызывает событие GetPageCompleted. (Унаследовано от DocumentPaginator)
OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs)	Вызывает событие GetPageNumberCompleted.
OnPagesChanged(PagesChangedEventArgs)	Вызывает событие PagesChanged. (Унаследовано от DocumentPaginator)
OnPaginationCompleted(EventArgs)	Вызывает событие PaginationCompleted.
OnPaginationProgress(PaginationProgressEventArgs)	Вызывает событие PaginationProgress.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

ComputePageCountCompleted	Происходит при завершении операции ComputePageCountAsync. (Унаследовано от DocumentPaginator)
GetPageCompleted	Происходит после завершения работы метода GetPageAsync. (Унаследовано от DocumentPaginator)
GetPageNumberCompleted	Происходит после завершения работы метода GetPageNumberAsync.
PagesChanged	Происходит при изменении содержимого документа. (Унаследовано от DocumentPaginator)
PaginationCompleted	Происходит после разбивки всего содержимого документа.
PaginationProgress	Происходит при разбивке одной или более страниц содержимого.