Implementazione del pattern di controllo Window di automazione interfaccia utente

  • Articolo

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 IWindowProvider, incluse le informazioni relative a proprietà, metodi ed eventi di WindowPattern . Alla fine della panoramica sono elencati collegamenti ad altro materiale di riferimento.

Il pattern di controllo WindowPattern viene usato per supportare i controlli che forniscono la funzionalità fondamentale basata su finestra in un'interfaccia utente grafica (GUI) tradizionale. I controlli che devono implementare questo pattern di controllo sono, ad esempio, le finestre dell'applicazione di primo livello, le finestre figlio dell'interfaccia a documenti multipli, i controlli riquadro ridimensionabili, le finestre di dialogo modali e le finestre fumetto della Guida.

Linee guida e convenzioni di implementazione

Quando si implementa il pattern di controllo Window, tenere presenti le linee guida e le convenzioni seguenti:

  • Per supportare la possibilità di modificare sia le dimensioni della finestra che la posizione sullo schermo con Automazione interfaccia utente, un controllo deve implementare ITransformProvider oltre a IWindowProvider.

  • I controlli contenenti barre del titolo ed elementi della barra del titolo che consentono di spostare, ridimensionare, ingrandire, ridurre a icona o chiudere il controllo in genere devono implementare IWindowProvider.

  • I controlli come i popup di descrizione comando e le caselle combinate o i menu a discesa in genere non implementano IWindowProvider.

  • Le finestre fumetto della Guida si distinguono dai popup di descrizione comando di base per il provisioning di un pulsante Chiudi simile a quello delle finestre.

  • La modalità schermo intero non è supportata da IWindowProvider perché è una funzionalità specifica delle applicazioni e non è un comportamento tipico delle finestre.

Membri obbligatori per IWindowProvider

Le proprietà, i metodi e gli eventi seguenti sono obbligatori per l'implementazione dell'interfaccia IWindowProvider.

Membro obbligatorio Tipo di membro Note
InteractionState Proprietà None
IsModal Proprietà None
IsTopmost Proprietà None
Maximizable Proprietà None
Minimizable Proprietà None
VisualState Proprietà None
Close metodo None
SetVisualState metodo None
WaitForInputIdle metodo None
WindowClosedEvent Event None
WindowOpenedEvent Event None
WindowInteractionState Event Non è garantito che sia ReadyForUserInteraction

Eccezioni

I provider devono generare le eccezioni seguenti.

Tipo di eccezione Condizione
InvalidOperationException SetVisualState

- Quando un controllo non supporta un comportamento richiesto.
ArgumentOutOfRangeException WaitForInputIdle

- Quando il parametro non è un numero valido.

Vedi anche