DynamicDocumentPaginator.GetPageNumberAsync Methode

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationCore.dll

Gibt die nullbasierte Seitenzahl der angegebenen ContentPosition zurück.

Überlädt

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

GetPageNumberAsync(ContentPosition)

Gibt (über das GetPageNumberCompleted-Ereignis) die nullbasierte Seitenzahl der angegebenen ContentPosition asynchron zurü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 benötigt wird.

Hinweise

Die einzige Möglichkeit, den asynchronen Vorgang dieser Methode abzubrechen, 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 zum Abrufen der Seitenzahl finden Sie GetPageNumberAsync(ContentPosition, Object) unter Verwenden dieser Methode.

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden GetPageNumber(ContentPosition).

GetPageNumberAsync(ContentPosition, Object)

Gibt (über das GetPageNumberCompleted-Ereignis) die nullbasierte Seitenzahl der angegebenen ContentPosition asynchron zurü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, dessen Seitenzahl zurückgegeben werden soll.

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 angegebenen contentPosition asynchron abgerufen wird.

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

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

3. Wenn das Ereignis auftritt und der Delegat aufgerufen wird, vergleichen Sie die .UserState-Eigenschaft des Ereignisses GetPageNumberCompletedEventArgsmit 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 bereit. (Die GetPageNumberCompletedEventArgsEigenschaft .ContentPosition entspricht auch dem ursprünglichen GetPageNumberAsync(ContentPosition, Object)contentPosition Parameter.)

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

GetPageNumber bietet ähnliche Funktionen wie GetPageNumberAsync, aber für synchrone Vorgänge.