Implementazione del pattern di controllo Window di automazione interfaccia utente

Aggiornamento: novembre 2007

In questo argomento vengono presentate linee guida e convenzioni per l'implementazione di IWindowProvider, incluse informazioni su proprietà, metodi ed eventi di WindowPattern. Alla fine dell'argomento sono elencati i collegamenti a ulteriori riferimenti.

Il pattern di controllo WindowPattern viene utilizzato per supportare i controlli che forniscono funzionalità fondamentali basate su finestra all'interno di un'interfaccia utente grafica (GUI, Graphical User Interface) tradizionale. I controlli che devono implementare questo pattern di controllo includono ad esempio le finestre di primo livello dell'applicazione, le finestre figlio di interfaccia a documenti multipli (MDI, Multiple Document Interface), i controlli dei riquadri ridimensionabili, le finestre di dialogo modali e le finestre della Guida di tipo fumetto.

Nel presente argomento sono contenute le seguenti sezioni.

Linee guida e convenzioni per l'implementazione
Membri obbligatori per IWindowProvider
Eccezioni
Argomenti correlati

Linee guida e convenzioni per l'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 tramite automazione interfaccia utente, un controllo deve implementare ITransformProvider oltre a IWindowProvider.
I controlli che contengono barre del titolo ed elementi della barra del titolo che consentono lo spostamento, il ridimensionamento, l'ingrandimento, la riduzione o la chiusura del controllo devono in genere implementare IWindowProvider.
I controlli come ad esempio popup di descrizione comandi e elenchi a discesa di caselle combinate o menu non implementano in genere IWindowProvider.
Le finestre della Guida di tipo fumetto sono distinte dai popup di descrizione comandi di base tramite il provisioning di un pulsante Chiudi simile a quello delle finestre.
La modalità a schermo intero non è supportata da IWindowProvider in quanto è specifica delle funzionalità di un'applicazione e non è un comportamento tipico di finestra.

Membri obbligatori per IWindowProvider

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

Membro obbligatorio	Tipo di membro	Note
InteractionState	Proprietà	Nessuna
IsModal	Proprietà	Nessuna
IsTopmost	Proprietà	Nessuna
Maximizable	Proprietà	Nessuna
Minimizable	Proprietà	Nessuna
VisualState	Proprietà	Nessuna
Close	Metodo	Nessuna
SetVisualState	Metodo	Nessuna
WaitForInputIdle	Metodo	Nessuna
WindowClosedEvent	Evento	Nessuna
WindowOpenedEvent	Evento	Nessuna
WindowInteractionState	Evento	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.

InvalidOperationException

SetVisualState