Modello di controllo dock

Vengono descritte le linee guida e le convenzioni per l'implementazione di IDockProvider, incluse informazioni sulle proprietà e sui metodi. Il pattern di controllo Dock 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. L'immagine seguente mostra un contenitore di ancoraggio con due elementi figlio. Per esempi di controlli che implementano questo pattern di controllo, vedere Tipi di controllo e i relativi pattern di controllo supportati.

screenshot che mostra il contenitore di ancoraggio con due elementi figlio ancorati

In questo argomento sono contenute le sezioni seguenti.

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 alcuna proprietà del contenitore di ancoraggio o le proprietà dei controlli ancorati adiacenti 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 ridimensionati anche per riempire qualsiasi spazio all'interno del contenitore in base al comportamento di ancoraggio della proprietà DockPosition . Ad esempio, se viene specificato DockPosition_Top , i lati sinistro e destro del controllo si espanderanno per riempire qualsiasi spazio disponibile. Se si specifica DockPosition_Fill , tutti e quattro i lati del controllo si espanderanno per riempire qualsiasi 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

Per implementare l'interfaccia IDockProvider sono necessari i metodi e le proprietà seguenti.

Membri obbligatori Tipo di membro Note
DockPosition Proprietà Nessuno
SetDockPosition Metodo Nessuno

 

Questo pattern di controllo non è associato a eventi.

Tipi di controllo e modelli di controllo supportati

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

Panoramica dell'albero di automazione dell'interfaccia utente