Condividi tramite

Tipo di controllo riquadro

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Pane.

Il tipo di controllo Pane è destinato a aree potenzialmente scorrevoli con contenuto diverso. Viene utilizzato per rappresentare un oggetto all'interno di una cornice o di una finestra del documento. Gli utenti possono spostarsi tra i controlli del riquadro e il contenuto del riquadro corrente. I controlli riquadro rappresentano un livello di raggruppamento inferiore a finestre o documenti, ma al di sopra dei singoli controlli. L'utente si sposta tra i riquadri premendo TAB, F6 o CTRL+TAB, a seconda del contesto.

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

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici della struttura ad albero Automazione interfaccia utente relativa ai controlli riquadro e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Riquadro
  • Riquadro

 

Un controllo riquadro viene sempre visualizzato nelle visualizzazioni controllo e contenuto. Non esporre un oggetto layout come riquadro nel controllo o nella visualizzazione contenuto se l'oggetto viene utilizzato solo per la presentazione visiva.

Proprietà pertinenti

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

Proprietà di automazione interfaccia utente Valore Note
UIA_AccessKeyPropertyId Vedere le note. Se una combinazione di tasti specifica fornisce lo stato attivo al riquadro, tali informazioni devono essere esposte tramite questa proprietà.
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. Questa proprietà espone un punto selezionabile del controllo riquadro che fa sì che il riquadro assuma lo stato attivo quando viene selezionato.
UIA_ControlTypePropertyId Riquadro
UIA_HelpTextPropertyId Vedere le note. Il testo della Guida per i controlli riquadro deve spiegare lo scopo della cornice e il modo in cui è correlato ad altri fotogrammi. Una descrizione è necessaria se lo scopo e la relazione dei frame non sono chiari dal valore della proprietà UIA_NamePropertyId .
UIA_IsContentElementPropertyId TRUE Il controllo riquadro è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo riquadro è 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 Vedere le note. I controlli riquadro in genere non hanno un'etichetta statica. Se è presente un'etichetta di testo statico, l'etichetta deve essere esposta tramite questa proprietà.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Pane . Il valore predefinito è "pane" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il valore di questa proprietà deve essere sempre un titolo chiaro, conciso e significativo.

 

Pattern di controllo obbligatori

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

Pattern di controllo Supporto Note
IDockProvider Dipende da Implementare il pattern di controllo Dock se il controllo riquadro può essere ancorato.
IScrollProvider Dipende da Implementare il pattern di controllo Scroll se è possibile scorrere il controllo riquadro.
ITransformProvider Dipende da Implementare il pattern di controllo Transform se il controllo riquadro può essere spostato, ridimensionato o ruotato sullo schermo.
IWindowProvider Mai Se l'elemento deve implementare il pattern di controllo Window , il controllo deve essere basato sul tipo di controllo Window .

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare i controlli del riquadro. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

evento Automazione interfaccia utente Note
UIA_AsyncContentLoadedEventId
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_IsOffscreenPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
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

 

Esempio di tipo di controllo Pane

L'immagine seguente illustra un controllo che implementa il tipo di controllo Pane .

screenshot che mostra l'esempio di un controllo riquadro

albero Automazione interfaccia utente- Visualizzazione controllo albero Automazione interfaccia utente: visualizzazione contenuto
  • Riquadro
    • Tree (pattern Scroll)
      • TreeItem
      • ...
  • Riquadro
    • Modifica (motivo di scorrimento)
  • Riquadro
    • Tree (pattern Scroll)
      • TreeItem
      • ...
    • Riquadro
      • Modifica (motivo di scorrimento)

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente