DynamicDocumentPaginator.GetPageNumberAsync Methode

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationCore.dll

Gibt die nullbasierte Seitenzahl der angegebenen ContentPositionzurück.

Überlädt

GetPageNumberAsync(ContentPosition)	Gibt (über die This-Methode das GetPageNumberCompleted-Ereignis) asynchron die nullbasierte Seitenzahl der angegebenen ContentPositionzurück.
GetPageNumberAsync(ContentPosition, Object)	Gibt (über die This-Methode das GetPageNumberCompleted-Ereignis) asynchron die nullbasierte Seitenzahl der angegebenen ContentPositionzurück.

GetPageNumberAsync(ContentPosition)

Gibt (über die This-Methode das GetPageNumberCompleted-Ereignis) asynchron die nullbasierte Seitenzahl der angegebenen ContentPositionzurück.

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)

Parameter

contentPosition

ContentPosition

Die Inhaltsposition, deren Seitenzahl erforderlich ist.

Hinweise

Die einzige Möglichkeit zum Abbrechen des asynchronen Vorgangs dieser Methode besteht darin, alle asynchronen Vorgänge abzubrechen. Vergleichen Sie dies mit der anderen Überladung dieser Methode: GetPageNumberAsync(ContentPosition, Object).

Diese Methode löst das GetPageNumberCompleted-Ereignis aus. Die Seitenzahl wird als eines der Ereignisargumente an das Ereignis übergeben. Informationen zur Verwendung dieser Methode zum Abrufen der Seitenzahl finden Sie unter GetPageNumberAsync(ContentPosition, Object).

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungs exceptions, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von GetPageNumber(ContentPosition)ausgelösten Ausnahmen.

GetPageNumberAsync(ContentPosition, Object)

Gibt (über die This-Methode das GetPageNumberCompleted-Ereignis) asynchron die nullbasierte Seitenzahl der angegebenen ContentPositionzurück.

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)

Parameter

contentPosition

ContentPosition

Das Inhaltspositionselement, um die Seitenzahl zurückzugeben.

userState

Object

Ein eindeutiger Bezeichner für die asynchrone Aufgabe.

Hinweise

Diese Überladung der Methode ermöglicht es, diesen asynchronen Vorgang abzubrechen, ohne alle asynchronen Vorgänge abzubrechen.

Diese Methode löst das GetPageNumberCompleted-Ereignis aus.

Die folgenden Schritte veranschaulichen, wie die Seitenzahl eines bestimmten contentPosition asynchron abgerufen wird.

1. Erstellen Sie einen GetPageNumberCompletedEventHandler Delegat, und fügen Sie ihn hinzu, um über GetPageNumberCompleted Ereignisse benachrichtigt zu werden.

2. Rufen Sie GetPageNumberAsync(ContentPosition, Object) auf, um die gewünschte contentPosition anzugeben, und ein eindeutiges userState-Objekt, das zum Identifizieren der asynchronen Aufgabe verwendet wird.

3. Wenn das Ereignis auftritt und der Delegat aufgerufen wird, vergleichen Sie die GetPageNumberCompletedEventArgsdes Ereignisses.UserState Eigenschaft mit dem ursprünglichen GetPageNumberAsyncuserState-Parameter.

4. Wenn die GetPageNumberCompletedEventArgs.UserState Eigenschaft mit dem ursprünglichen GetPageNumberAsync(ContentPosition, Object)userStateübereinstimmt, ist der Vorgang abgeschlossen und die Seitenzahl ist fertig. (Die eigenschaft GetPageNumberCompletedEventArgs.ContentPosition entspricht auch dem ursprünglichen GetPageNumberAsync(ContentPosition, Object)contentPosition Parameter.)

5. Die GetPageNumberCompletedEventArgs.PageNumber -Eigenschaft enthält die nullbasierte Seitenzahl der angegebenen contentPosition.

GetPageNumber bietet ähnliche Funktionen wie GetPageNumberAsync, aber für synchronen Betrieb.