DynamicDocumentPaginator.GetPageNumberAsync Metodo

Definizione

Spazio dei nomi:

System.Windows.Documents

Assembly:

PresentationCore.dll

Restituisce il numero di pagina in base zero del ContentPositionspecificato.

Overload

GetPageNumberAsync(ContentPosition)	Restituisce in modo asincrono (tramite il metodo This genera l'evento GetPageNumberCompleted) il numero di pagina in base zero del ContentPositionspecificato.
GetPageNumberAsync(ContentPosition, Object)	Restituisce in modo asincrono (tramite il metodo This genera l'evento GetPageNumberCompleted) il numero di pagina in base zero del ContentPositionspecificato.

GetPageNumberAsync(ContentPosition)

Restituisce in modo asincrono (tramite il metodo This genera l'evento GetPageNumberCompleted) il numero di pagina in base zero del ContentPositionspecificato.

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)

Parametri

contentPosition

ContentPosition

Posizione del contenuto il cui numero di pagina è necessario.

Commenti

L'unico modo per annullare l'operazione asincrona di questo metodo consiste nell'annullare tutte le operazioni asincrone. Contrasto con l'altro overload di questo metodo: GetPageNumberAsync(ContentPosition, Object).

Questo metodo genera l'evento GetPageNumberCompleted. Il numero di pagina viene passato all'evento come uno degli argomenti dell'evento. Vedere GetPageNumberAsync(ContentPosition, Object) per informazioni su come usare questo metodo per ottenere il numero di pagina.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da GetPageNumber(ContentPosition).

GetPageNumberAsync(ContentPosition, Object)

Restituisce in modo asincrono (tramite il metodo This genera l'evento GetPageNumberCompleted) il numero di pagina in base zero del ContentPositionspecificato.

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)

Parametri

contentPosition

ContentPosition

Elemento della posizione del contenuto di cui restituire il numero di pagina.

userState

Object

Identificatore univoco per l'attività asincrona.

Commenti

Questo overload del metodo consente di annullare questa operazione asincrona senza annullare tutte le operazioni asincrone.

Questo metodo genera l'evento GetPageNumberCompleted.

I passaggi seguenti illustrano come recuperare in modo asincrono il numero di pagina di un determinato contentPosition.

1. Creare un delegato GetPageNumberCompletedEventHandler e aggiungerlo per ricevere una notifica degli eventi GetPageNumberCompleted.

2. Chiamare GetPageNumberAsync(ContentPosition, Object) specificare il contentPosition desiderato e un oggetto userState univoco che verrà usato per identificare l'attività asincrona.

3. Quando si verifica l'evento e viene chiamato il delegato, confrontare il GetPageNumberCompletedEventArgsdell'evento .UserState proprietà con il parametro GetPageNumberAsyncuserState originale.

4. Quando il GetPageNumberCompletedEventArgs.UserState proprietà corrisponde al GetPageNumberAsync(ContentPosition, Object)userStateoriginale, l'operazione è stata completata e il numero di pagina è pronto. La proprietà GetPageNumberCompletedEventArgs.ContentPosition corrisponderà anche al parametro GetPageNumberAsync(ContentPosition, Object)contentPosition originale.

5. Oggetto GetPageNumberCompletedEventArgs.PageNumber proprietà contiene il numero di pagina in base zero del contentPositionspecificato.

GetPageNumber offre funzionalità simili a GetPageNumberAsync, ma per l'operazione sincrona.