DynamicDocumentPaginator.GetPageNumberAsync Metoda

Definice

Obor názvů:

System.Windows.Documents

Sestavení:

PresentationCore.dll

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

Přetížení

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

GetPageNumberAsync(ContentPosition)

Asynchronně, vrátí (prostřednictvím This metoda vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadané 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

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

Poznámky

Jediným způsobem zrušení asynchronní operace této metody je zrušení všech asynchronních operací. Naproti tomu s druhý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. Informace o tom, jak pomocí této metody získat číslo stránky, najdete v GetPageNumberAsync(ContentPosition, Object).

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. U uložených výjimek se podívejte na výjimky vyvolané GetPageNumber(ContentPosition).

GetPageNumberAsync(ContentPosition, Object)

Asynchronně, vrátí (prostřednictvím This metoda vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadané 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

Prvek pozice obsahu pro vrácení čísla 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 načíst číslo stránky daného contentPosition asynchronně.

1. Vytvořte delegáta GetPageNumberCompletedEventHandler a přidejte ho, aby se dostávalo oznámení o GetPageNumberCompleted událostech.

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

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

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

5. GetPageNumberCompletedEventArgs.PageNumber vlastnost obsahuje číslo stránky založené na nule zadaného contentPosition.

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