DynamicDocumentPaginator.GetPageNumberAsync Метод

Определение

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

System.Windows.Documents

Сборка:

PresentationCore.dll

Возвращает отсчитываемый от нуля номер страницы указанного ContentPosition.

Перегрузки

GetPageNumberAsync(ContentPosition)	Асинхронно возвращает (через этот метод вызывает событие GetPageNumberCompleted) отсчитываемый от нуля номер страницы указанного ContentPosition.
GetPageNumberAsync(ContentPosition, Object)	Асинхронно возвращает (через этот метод вызывает событие GetPageNumberCompleted) отсчитываемый от нуля номер страницы указанного ContentPosition.

GetPageNumberAsync(ContentPosition)

Асинхронно возвращает (через этот метод вызывает событие GetPageNumberCompleted) отсчитываемый от нуля номер страницы указанного ContentPosition.

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition)

Параметры

contentPosition

ContentPosition

Позиция содержимого, номер страницы которой необходим.

Комментарии

Единственным способом отмены асинхронной операции этого метода является отмена всех асинхронных операций. Контрастирует с другой перегрузкой этого метода: GetPageNumberAsync(ContentPosition, Object).

Этот метод вызывает событие GetPageNumberCompleted. Номер страницы передается событию в качестве одного из аргументов события. Сведения о том, как использовать этот метод, см. в GetPageNumberAsync(ContentPosition, Object), чтобы получить номер страницы.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых GetPageNumber(ContentPosition).

GetPageNumberAsync(ContentPosition, Object)

Асинхронно возвращает (через этот метод вызывает событие GetPageNumberCompleted) отсчитываемый от нуля номер страницы указанного ContentPosition.

public:
 virtual void GetPageNumberAsync(System::Windows::Documents::ContentPosition ^ contentPosition, System::Object ^ userState);

public virtual void GetPageNumberAsync (System.Windows.Documents.ContentPosition contentPosition, object userState);

abstract member GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit
override this.GetPageNumberAsync : System.Windows.Documents.ContentPosition * obj -> unit

Public Overridable Sub GetPageNumberAsync (contentPosition As ContentPosition, userState As Object)

Параметры

contentPosition

ContentPosition

Элемент положения содержимого, возвращаемый номером страницы.

userState

Object

Уникальный идентификатор асинхронной задачи.

Комментарии

Эта перегрузка метода позволяет отменить эту асинхронную операцию без отмены всех асинхронных операций.

Этот метод вызывает событие GetPageNumberCompleted.

Ниже показано, как получить номер страницы заданного contentPosition асинхронно.

1. Создайте делегат GetPageNumberCompletedEventHandler и добавьте его для уведомления о событиях GetPageNumberCompleted.

2. Вызов GetPageNumberAsync(ContentPosition, Object) указание требуемого contentPosition и уникального объекта userState, который будет использоваться для идентификации асинхронной задачи.

3. При возникновении события и вызове делегата сравните GetPageNumberCompletedEventArgsсобытия. свойствоUserState с исходным параметром GetPageNumberAsyncuserState.

4. Когда GetPageNumberCompletedEventArgs.UserState свойство соответствует исходному GetPageNumberAsync(ContentPosition, Object)userState, операция завершена и номер страницы готов. (Свойство GetPageNumberCompletedEventArgs.ContentPosition также соответствует исходному параметру GetPageNumberAsync(ContentPosition, Object)contentPosition.)

5. GetPageNumberCompletedEventArgs. свойствоPageNumber содержит отсчитываемый от нуля номер страниц указанного contentPosition.

GetPageNumber предоставляет аналогичные функции, как GetPageNumberAsync, но для синхронной операции.