DynamicDocumentPaginator.GetPageNumberAsync Metoda

Definicja

Przestrzeń nazw:

System.Windows.Documents

Zestaw:

PresentationCore.dll

Zwraca numer strony zero określonej ContentPosition.

Przeciążenia

GetPageNumberAsync(ContentPosition)	Asynchronicznie zwraca wartość (za pomocą tej metody zgłasza zdarzenie GetPageNumberCompleted) numer strony zero określonej ContentPosition.
GetPageNumberAsync(ContentPosition, Object)	Asynchronicznie zwraca wartość (za pomocą tej metody zgłasza zdarzenie GetPageNumberCompleted) numer strony zero określonej ContentPosition.

GetPageNumberAsync(ContentPosition)

Asynchronicznie zwraca wartość (za pomocą tej metody zgłasza zdarzenie GetPageNumberCompleted) numer strony zero określonej 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)

Parametry

contentPosition

ContentPosition

Pozycja zawartości, której numer strony jest wymagany.

Uwagi

Jedynym sposobem anulowania operacji asynchronicznej tej metody jest anulowanie wszystkich operacji asynchronicznych. Porównaj to z innym przeciążeniem tej metody: GetPageNumberAsync(ContentPosition, Object).

Ta metoda zgłasza zdarzenie GetPageNumberCompleted. Numer strony jest przekazywany do zdarzenia jako jeden z argumentów zdarzenia. Zobacz GetPageNumberAsync(ContentPosition, Object), aby uzyskać numer strony za pomocą tej metody.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez GetPageNumber(ContentPosition).

GetPageNumberAsync(ContentPosition, Object)

Asynchronicznie zwraca wartość (za pomocą tej metody zgłasza zdarzenie GetPageNumberCompleted) numer strony zero określonej 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)

Parametry

contentPosition

ContentPosition

Element pozycji zawartości, który ma zwrócić numer strony.

userState

Object

Unikatowy identyfikator zadania asynchronicznego.

Uwagi

To przeciążenie metody umożliwia anulowanie tej operacji asynchronicznej bez anulowania wszystkich operacji asynchronicznych.

Ta metoda zgłasza zdarzenie GetPageNumberCompleted.

Poniższe kroki ilustrują sposób pobierania numeru strony danej contentPosition asynchronicznie.

1. Utwórz delegata GetPageNumberCompletedEventHandler i dodaj go, aby otrzymywać powiadomienia o zdarzeniach GetPageNumberCompleted.

2. Wywołaj GetPageNumberAsync(ContentPosition, Object) określając żądany contentPosition i unikatowy obiekt userState, który będzie używany do identyfikowania zadania asynchronicznego.

3. Po wystąpieniu zdarzenia i wywołaniu delegata porównaj GetPageNumberCompletedEventArgszdarzenia .UserState właściwość z oryginalnym parametrem GetPageNumberAsyncuserState.

4. Gdy GetPageNumberCompletedEventArgs.UserState właściwość odpowiada oryginalnej GetPageNumberAsync(ContentPosition, Object)userState, operacja jest ukończona, a numer strony jest gotowy. (Właściwość GetPageNumberCompletedEventArgs.ContentPosition będzie również zgodna z oryginalnym parametrem GetPageNumberAsync(ContentPosition, Object)contentPosition).

5. GetPageNumberCompletedEventArgs.PageNumber właściwość zawiera numer strony zero określonej contentPosition.

GetPageNumber zapewnia podobne funkcje jak GetPageNumberAsync, ale w przypadku operacji synchronicznej.