Tipo di controllo finestra

Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Window.

Il controllo finestra è costituito dalla cornice della finestra, che contiene oggetti figlio, ad esempio barra del titolo, oggetti client e altri oggetti.

Le sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i modelli di controllo e gli eventi necessari per il tipo di controllo Finestra. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli finestra in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli finestra e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Finestra
  • Finestra

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli finestra. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente Valore Note
UIA_AutomationIdPropertyId Vedere le note. Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Il controllo finestra deve avere un punto selezionabile che causa l'opzione selezionata o non selezionata dalla finestra.
UIA_ControlTypePropertyId Window Questo valore è uguale per tutti i framework dell'interfaccia utente.
UIA_IsContentElementPropertyId TRUE Il controllo finestra è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo finestra è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
UIA_LabeledByPropertyId NULL I controlli finestra non hanno un'etichetta di finestra statica.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Window . Il valore predefinito è "window" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il controllo finestra contiene sempre un elemento della finestra primaria che si riferisce a ciò che l'utente associa come identificatore semantico per l'elemento.

 

Modelli di controllo obbligatori

Nella tabella seguente sono elencati i modelli di controllo Automazione interfaccia utente necessari per essere supportati dai controlli finestra. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo/proprietà del pattern Supporto/valore Note
IDockProvider Condizionale Il modello di controllo Dock deve essere supportato se la finestra può essere ancorata.
ITransformProvider Necessario Il modello di controllo Trasforma consente di spostare, ridimensionare o ruotare la finestra sullo schermo. (Non si applica alle app di Windows Store).
IWindowProvider Necessario Il modello di controllo Finestra consente operazioni specifiche per la finestra.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli Finestra. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Automazione interfaccia utente evento Note
UIA_AsyncContentLoadedEventId
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento modificato dalla proprietà.
UIA_IsEnabledPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_LayoutInvalidatedEventId
UIA_NamePropertyId evento di modifica della proprietà.
UIA_ScrollHorizontallyScrollablePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento.
UIA_ScrollHorizontalScrollPercentPropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento.
UIA_ScrollHorizontalViewSizePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticallyScrollablePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticalScrollPercentPropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticalViewSizePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento.
UIA_StructureChangedEventId
UIA_Window_WindowClosedEventId
UIA_Window_WindowOpenedEventId
UIA_WindowWindowVisualStatePropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà WindowVisualState del pattern di controllo Window , questo evento deve essere supportato.

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente