DynamicDocumentPaginator.GetPageNumberAsync Metoda

Definice

Obor názvů:

System.Windows.Documents

Sestavení:

PresentationCore.dll

Vrátí číslo stránky založené na nule zadané ContentPosition.

Přetížení

GetPageNumberAsync(ContentPosition)	Asynchronně vrátí (prostřednictvím metody Tato metoda vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadaného ContentPositionobjektu .
GetPageNumberAsync(ContentPosition, Object)	Asynchronně vrátí (prostřednictvím metody Tato metoda vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadaného ContentPositionobjektu .

GetPageNumberAsync(ContentPosition)

Asynchronně vrátí (prostřednictvím metody Tato metoda vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadaného ContentPositionobjektu .

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

Pozice obsahu, jejíž číslo stránky je potřeba.

Poznámky

Jediným způsobem, jak zrušit asynchronní operaci této metody, je zrušit všechny asynchronní operace. Porovnejte to s jiným přetížením této metody: GetPageNumberAsync(ContentPosition, Object).

Tato metoda vyvolá GetPageNumberCompleted událost. Číslo stránky se události předá jako jeden z argumentů události. Podívejte GetPageNumberAsync(ContentPosition, Object) se, jak pomocí této metody získat číslo stránky.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem GetPageNumber(ContentPosition).

GetPageNumberAsync(ContentPosition, Object)

Asynchronně vrátí (prostřednictvím metody Tato metoda vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadaného ContentPositionobjektu .

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 pozice obsahu, který vrátí číslo stránky.

userState

Object

Jedinečný identifikátor asynchronní úlohy.

Poznámky

Toto přetížení metody umožňuje zrušit tuto asynchronní operaci bez zrušení všech asynchronních operací.

Tato metoda vyvolá GetPageNumberCompleted událost.

Následující kroky ukazují, jak asynchronně načíst číslo stránky daného contentPosition objektu.

1. Vytvořte delegáta GetPageNumberCompletedEventHandler a přidejte ho, aby byl upozorněn na GetPageNumberCompleted události.

2. Volání GetPageNumberAsync(ContentPosition, Object) určující contentPosition požadovaný a jedinečný userState objekt, který se použije k identifikaci asynchronní úlohy.

3. Když dojde k události a delegát je volána, porovnejte GetPageNumberCompletedEventArgsvlastnost .UserState události s původním GetPageNumberAsyncuserState parametrem.

4. Když vlastnost GetPageNumberCompletedEventArgs.UserState odpovídá původnímu GetPageNumberAsync(ContentPosition, Object)userStateobjektu , operace je dokončena a číslo stránky je připravené. (Vlastnost GetPageNumberCompletedEventArgs.ContentPosition bude také odpovídat původnímu GetPageNumberAsync(ContentPosition, Object)contentPosition parametru.)

5. PageNumber Vlastnost GetPageNumberCompletedEventArgsobsahuje číslo stránky založené na nule zadaného contentPositionobjektu .

GetPageNumber poskytuje podobné funkce jako GetPageNumberAsync, ale pro synchronní operaci.