Implementazione del pattern di controllo ScrollItem di automazione interfaccia utente
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.
In questo argomento vengono presentate le linee guida e le convenzioni per l'implementazione di IScrollItemProvider, incluse le informazioni relative a proprietà, metodi ed eventi. Alla fine della panoramica sono elencati collegamenti ad altro materiale di riferimento.
Il pattern di controllo ScrollItemPattern viene usato per supportare singoli controlli figlio di contenitori che implementano IScrollProvider. Questo pattern di controllo funge da canale di comunicazione tra un controllo figlio e il relativo contenitore per assicurarsi che il contenitore possa modificare il contenuto (o l'area) attualmente visibile nel relativo riquadro di visualizzazione per visualizzare il controllo figlio. Per esempi di controlli che implementano questo pattern di controllo, vedere Control Pattern Mapping for UI Automation Clients.
Linee guida e convenzioni di implementazione
Quando si implementa il pattern di controllo ScrollItem, tenere presenti le linee guida e le convenzioni seguenti:
- Gli elementi contenuti in un controllo finestra o area di disegno non devono implementare l'interfaccia IScrollItemProvider. In alternativa, tuttavia, devono esporre una posizione valida per BoundingRectangleProperty. Ciò consentirà a un'applicazione client di automazione interfaccia utente di usare i metodi del pattern di controllo ScrollPattern sul contenitore per visualizzare l'elemento figlio del controllo.
Membri obbligatori per IScrollItemProvider
Il metodo seguente è necessario per l'implementazione dell'interfaccia IScrollProvider.
Membri obbligatori | Tipo di membro | Note |
---|---|---|
ScrollIntoView | - Metodo | None |
Questo pattern di controllo non è associato a proprietà o eventi.
Eccezioni
I provider devono generare le eccezioni seguenti.
Tipo di eccezione | Condizione |
---|---|
InvalidOperationException | Non è possibile visualizzare un elemento tramite lo scorrimento: - ScrollIntoView |
Vedi anche
- Panoramica dei pattern di controllo per l'automazione interfaccia utente
- Supportare pattern di controllo in un provider di automazione interfaccia utente
- Pattern di controllo di automazione interfaccia utente per i client
- Panoramica dell'albero di automazione interfaccia utente
- Usare la memorizzazione nella cache in automazione interfaccia utente