Condividi tramite

Implementazione del pattern di controllo finestra di automazione UI

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

In questo argomento vengono illustrate le linee guida e le convenzioni per l'implementazione IWindowProvider, comprese le informazioni su proprietà WindowPattern, metodi ed eventi. I collegamenti a riferimenti aggiuntivi sono elencati alla fine dell'argomento.

Il WindowPattern pattern di controllo viene usato per supportare i controlli che forniscono funzionalità fondamentali basate su finestre all'interno di un'interfaccia utente grafica tradizionale (GUI). Esempi di controlli che devono implementare questo pattern di controllo includono finestre delle applicazioni di primo livello, finestre figlio MDI (Multiple-Document Interface), controlli riquadri suddivisi ridimensionabili, finestre modali e finestre della Guida di balloon.

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 dello schermo tramite Automazione interfaccia utente, un controllo deve implementare ITransformProvider oltre a IWindowProvider.

  • I controlli che contengono barre del titolo e elementi della barra del titolo che consentono di spostare, ridimensionare, ingrandire, ridurre al minimo o chiudere sono in genere necessari per implementare IWindowProvider.

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

  • Le finestre della Guida balloon si differenziano dai suggerimenti di base tramite la presenza di un pulsante Chiudi come quello presente nelle finestre.

  • La modalità schermo intero non è supportata da IWindowProvider perché è specifica della funzionalità per un'applicazione e non è un comportamento tipico della finestra.

Membri obbligatori per IWindowProvider

Per l'interfaccia IWindowProvider sono necessarie le proprietà, i metodi e gli eventi seguenti.

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

Eccezioni

I provider devono sollevare 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.

Vedere anche

  • Last updated on