Condividi tramite


Implementazione del pattern di controllo Dock di automazione interfaccia utente

Nota

Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.

In questo argomento vengono presentate le linee guida e le convenzioni per l'implementazione di IDockProvider, incluse le informazioni relative alle proprietà. Alla fine della panoramica sono elencati collegamenti ad altro materiale di riferimento.

Il pattern di controllo DockPattern viene usato per esporre le proprietà di ancoraggio di un controllo all'interno di un contenitore di ancoraggio. Un contenitore di ancoraggio è un controllo che consente di disporre gli elementi figlio orizzontalmente e verticalmente, uno rispetto all'altro. Per esempi di controlli che implementano questo pattern di controllo, vedere Control Pattern Mapping for UI Automation Clients.

Docking container with two docked children. Esempio di ancoraggio da Visual Studio dove la finestra "Visualizzazione classi" è impostata su DockPosition.Right e la finestra "Elenco errori" è impostata su DockPosition.Bottom

Linee guida e convenzioni di implementazione

Quando si implementa il pattern di controllo Dock, tenere presenti le linee guida e le convenzioni seguenti:

  • IDockProvider non espone le proprietà del contenitore di ancoraggio o le proprietà dei controlli ancorati vicino al controllo corrente all'interno del contenitore di ancoraggio.

  • I controlli vengono ancorati reciprocamente in base al relativo ordine z corrente, ovvero più elevata è la posizione nell'ordine z, più lontano verrà inserito il controllo rispetto al bordo specificato del contenitore di ancoraggio.

  • Se il contenitore di ancoraggio viene ridimensionato, i controlli ancorati all'interno del contenitore verranno riposizionati e allineati allo stesso bordo a cui sono stati originariamente ancorati. I controlli ancorati verranno inoltre ridimensionati per riempire lo spazio all'interno del contenitore in base al comportamento di ancoraggio della relativa proprietà DockPosition. Ad esempio, se viene specificata la proprietà Top , i lati destro e sinistro del controllo verranno espansi in modo da riempire lo spazio disponibile. Se viene specificata la proprietà Fill , tutti e quattro i lati del controllo verranno espansi in modo da riempire lo spazio disponibile.

  • In un sistema con più monitor i controlli devono essere ancorati al lato sinistro o destro del monitor corrente. Se ciò non è possibile, devono essere ancorati al lato sinistro del monitor all'estrema sinistra o al lato destro del monitor all'estrema destra.

Membri obbligatori per IDockProvider

Le proprietà e i metodi seguenti sono obbligatori per l'implementazione dell'interfaccia IDockProvider.

Membri obbligatori Tipo di membro Note
DockPosition Proprietà None
SetDockPosition metodo None

Questo pattern di controllo non è associato a eventi.

Eccezioni

I provider devono generare le eccezioni seguenti.

Tipo di eccezione Condizione
InvalidOperationException SetDockPosition

- Un controllo non è in grado di implementare lo stile di ancoraggio richiesto.

Vedi anche