Modello di controllo finestra

Vengono descritte linee guida e convenzioni per l'implementazione di IWindowProvider, incluse informazioni sulle proprietà, sui metodi e sugli eventi. Il modello di controllo Finestra supporta i controlli che forniscono funzionalità fondamentali basate su finestre all'interno di un'interfaccia utente tradizionale.

Esempi di controlli che devono implementare questo modello di controllo includono finestre dell'applicazione di primo livello, finestre figlio dell'interfaccia a più documenti, controlli riquadro di suddivisione ridimensionabili, dialoghi modali e finestre della Guida a palloncini. Per esempi di controlli che implementano questo pattern di controllo, vedere Control Pattern Mapping for UI Automation Clients.

In questo argomento sono contenute le sezioni seguenti.

Linee guida e convenzioni di implementazione

Quando si implementa il modello di controllo Finestra , prendere nota delle linee guida e delle convenzioni seguenti:

  • Per supportare la possibilità di modificare sia le dimensioni della finestra che la posizione dello schermo usando Microsoft 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, ridimensionare, massimizzare, ridurre al minimo o chiudere, sono in genere necessari per implementare IWindowProvider.
  • I controlli, ad esempio i popup della descrizione comando e le caselle combinate o i menu a discesa, non implementano in genere IWindowProvider.
  • Le finestre della Guida del palloncino sono differenziate dai popup della descrizione comando di base tramite il provisioning di un pulsante Chiudi simile a una finestra.
  • La modalità a 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 implementare l'interfaccia IWindowProvider sono necessarie le proprietà, i metodi e gli eventi seguenti.

Membri obbligatori Tipo di membro Note
WindowInteractionState Proprietà Non è garantito essere WindowInteractionState_ReadyForUserInteraction
IsModal Proprietà Nessuno
IsTopmost Proprietà Nessuno
CanMaximize Proprietà Nessuno
CanMinimize Proprietà Nessuno
WindowVisualState Proprietà Nessuno
Chiudi Metodo Nessuno
SetVisualState Metodo Nessuno
WaitForInputIdle Metodo Nessuno
UIA_Window_WindowClosedEventId Evento Nessuno
UIA_Window_WindowOpenedEventId Evento Nessuno

 

Informazioni concettuali

Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente

Mapping dei pattern di controllo per i client di automazione interfaccia utente

Panoramica dell'albero di automazione dell'interfaccia utente