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čísla .

Přetížení

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

GetPageNumberAsync(ContentPosition)

Asynchronně vrátí (prostřednictvím Této metody vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadaného 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. Podívejte GetPageNumberAsync(ContentPosition, Object) se, jak tuto metodu použít k získání čísla stránky.

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ě. V případě uložených výjimek se podívejte na výjimky vyvolané GetPageNumber(ContentPosition).

GetPageNumberAsync(ContentPosition, Object)

Asynchronně vrátí (prostřednictvím Této metody vyvolá GetPageNumberCompleted událost) číslo stránky založené na nule zadaného 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 událostech GetPageNumberCompleted .

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 vlastnost události GetPageNumberCompletedEventArgsUserState s původním GetPageNumberAsyncuserState parametrem.

4. GetPageNumberCompletedEventArgsPokud vlastnost .UserState odpovídá původní 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 GetPageNumberAsync(ContentPosition, Object)contentPosition parametru.)

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

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