Supporto di automazione interfaccia utente per il tipo di controllo Pane

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo Pane. In automazione interfaccia utente un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori delle proprietà di automazione interfaccia utente e i pattern di controllo.

Il tipo di controllo Pane viene utilizzato per rappresentare un oggetto all'interno di un frame o di una finestra di documento. Gli utenti possono spostarsi tra i controlli riquadro e all'interno del contenuto del riquadro corrente, ma non possono spostarsi tra gli elementi di riquadri diversi. Pertanto, i controlli riquadro rappresentano un livello di raggruppamento inferiore rispetto alle finestre o ai documenti, ma superiore a quello dei singoli controlli. L'utente si sposta tra riquadri premendo TAB, F6 o CTRL+TAB in base al contesto.

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo Pane. I requisiti di automazione interfaccia utente si applicano a tutti i controlli elenco, sia Windows Presentation Foundation (WPF)Win32 che Windows Form.

Nel presente argomento sono contenute le seguenti sezioni.

Struttura ad albero di automazione interfaccia utente obbligatoria
Proprietà di automazione interfaccia utente obbligatorie
Pattern di controllo di automazione interfaccia utente obbligatori
Eventi di automazione interfaccia utente obbligatori
Esempio di tipo di controllo Pane
Argomenti correlati

Struttura ad albero di automazione interfaccia utente obbligatoria

Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente ai controlli riquadro e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.

Visualizzazione controlli	Visualizzazione contenuto
Pane	Pane

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli riquadro. Per ulteriori informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di automazione interfaccia utente	Valore	Note
AutomationIdProperty()	Vedere le note.	Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.
BoundingRectangleProperty	Vedere le note.	Il rettangolo più esterno che contiene l'intero controllo.
IsKeyboardFocusableProperty	Vedere le note.	Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
NameProperty	Vedere le note.	Il valore per questa proprietà deve essere sempre un titolo chiaro, conciso e significativo.
ClickablePointProperty	Vedere le note.	Questa proprietà espone un punto selezionabile del controllo riquadro, tramite il quale lo stato attivo si sposta sul riquadro quando viene selezionato con un clic del mouse.
LabeledByProperty	Vedere le note.	I controlli riquadro non includono in genere un'etichetta statica. Se presente, un'etichetta di testo statica deve essere esposta tramite questa proprietà.
ControlTypeProperty	Pane	Questo valore è identico per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty	"riquadro"	Stringa localizzata che corrisponde al tipo di controllo Pane.
IsContentElementProperty	True	I controlli riquadro sono sempre inclusi nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente.
IsControlElementProperty	True	I controlli riquadro sono sempre inclusi nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente.
HelpTextProperty	""	Nel testo della Guida per i controlli riquadro è necessario descrivere lo scopo del frame e le relazioni con gli altri frame. Una descrizione è necessaria se lo scopo e le relazioni dei frame non risultano evidenti tramite il valore di NameProperty. ”
AccessKeyProperty	Vedere le note.	Se una combinazione di tasti specifica sposta lo stato attivo sul riquadro, tale informazione deve essere esposta tramite questa proprietà.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati i pattern di controllo di automazione interfaccia utente che devono essere supportati da tutti i controlli riquadro. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo/Proprietà pattern	Supporto/Valore	Note
ITransformProvider	A seconda dei casi	Implementare questo pattern di controllo se il controllo riquadro può essere spostato, ridimensionato o ruotato sullo schermo.
IWindowProvider	Mai	Se è necessario implementare questo pattern di controllo, il controllo deve essere basato sul tipo di controllo Window.
IDockProvider	A seconda dei casi	Implementare questo pattern di controllo se il controllo riquadro può essere ancorato.

Eventi di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli riquadro. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente	Supporto/Valore	Note
WindowClosedEvent	Mai	Nessuna
WindowOpenedEvent	Mai	Nessuna
AsyncContentLoadedEvent	Obbligatorio	Nessuna
Evento di proprietà modificata BoundingRectangleProperty.	Obbligatorio	Nessuna
Evento di proprietà modificata IsOffscreenProperty.	Obbligatorio	Nessuna
Evento di proprietà modificata IsEnabledProperty.	Obbligatorio	Nessuna
Evento di proprietà modificata HorizontallyScrollableProperty.	A seconda dei casi	Nessuna
Evento di proprietà modificata HorizontalScrollPercentProperty.	A seconda dei casi	Nessuna
Evento di proprietà modificata HorizontalViewSizeProperty.	A seconda dei casi	Nessuna
Evento di proprietà modificata VerticalScrollPercentProperty.	A seconda dei casi	Nessuna
Evento di proprietà modificata VerticallyScrollableProperty.	A seconda dei casi	Nessuna
Evento di proprietà modificata VerticalViewSizeProperty.	A seconda dei casi	Nessuna
Evento di proprietà modificata WindowVisualStateProperty.	Mai	Nessuna
AutomationFocusChangedEvent	Obbligatorio	Nessuna
StructureChangedEvent	Obbligatorio	Nessuna