Поделиться через

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для синхронных операций.

Применяется к