Vai al contenuto principale
Questa è un’interfaccia di callback utilizzata per segnalare gli eventi dall’oggetto FRPages ai listener. Questa interfaccia viene implementata lato client. Per indicazioni dettagliate sull’implementazione per il proprio strumento di sviluppo, vedere Utilizzo degli oggetti connettibili. Di seguito è riportata una breve descrizione: Gli utenti C++ dovranno implementare l’interfaccia IFRPagesEvents, ottenere un connection point (Windows) e registrare (“advise”) presso l’oggetto FRPages l’oggetto che implementa l’interfaccia. Poiché l’interfaccia deriva da IUnknown, anche l’oggetto client deve implementarne i metodi. Gli utenti Visual Basic che vogliono ricevere notifiche dall’oggetto FRPages devono dichiararlo con WithEvents e implementare procedure simili alle seguenti:
Public WithEvents pages As FREngine.FRPages
Private Sub pages_PageRemoved(ByVal sender As FRPages, _
                              ByVal page As FRPage, _
                              ByVal index  As Integer)
...
End Sub
Un oggetto che riceve notifiche tramite i metodi di questa interfaccia può effettuare le seguenti operazioni all’interno della loro implementazione:
  • Segnalare il completamento della rimozione e dell’aggiunta di pagine.
  • Segnalare il completamento della rinumerazione delle pagine.
  • In Windows: elaborare eventuali messaggi di sistema per evitare che l’applicazione sembri non rispondere durante operazioni prolungate. Questo può essere utile nelle applicazioni con un’interfaccia utente.

Metodi

NomeDescrizione
PageAddedFornisce al client informazioni sull’avvenuto completamento dell’aggiunta di una pagina.
PageRemovedFornisce al client informazioni sull’avvenuto completamento della rimozione di una pagina.
PagesRenumberedFornisce al client informazioni sull’avvenuto completamento della rinumerazione delle pagine.

Note

In Linux, questa interfaccia non funziona se l’oggetto Engine viene caricato come server esterno al processo.

Vedi anche

FRPages Utilizzo degli oggetti connettibili