Condividi tramite

Implementazione del pattern di controllo dock dell'automazione dell'interfaccia utente

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

Questo argomento presenta linee guida e convenzioni per l'implementazione IDockProviderdi , incluse le informazioni sulle proprietà. Alla fine della panoramica sono elencati collegamenti ad altro materiale di riferimento.

Il DockPattern pattern di controllo viene usato per esporre le proprietà di docking di un controllo all'interno di un contenitore di docking. Un contenitore di ancoraggio è un controllo che consente di disporre gli elementi figlio orizzontalmente e verticalmente, rispetto l'uno all'altro. Per esempi di controlli che implementano questo pattern di controllo, vedere Mapping dei criteri di controllo per i client di automazione interfaccia utente.

Ancoraggio del contenitore con due elementi figlio ancorati. Esempio di ancoraggio da Visual Studio in cui la finestra "Visualizzazione classi" è DockPosition.Right e la finestra "Elenco errori" è 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 alcuna proprietà del contenitore di ancoraggio o delle proprietà dei controlli ancorati adiacenti al controllo corrente all'interno del contenitore di ancoraggio.

  • I controlli vengono ancorati l'uno rispetto all'altro in base al relativo ordine z corrente; più alto è il posizionamento dell'ordine z, più lontano vengono posizionati dal bordo specificato del contenitore di ancoraggio.

  • Se il contenitore di ancoraggio viene ridimensionato, tutti i controlli ancorati all'interno del contenitore verranno riposizionati nello 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 del relativo DockPositionoggetto . Ad esempio, se Top viene specificato, i lati sinistro e destro del controllo si espanderanno per riempire qualsiasi spazio disponibile. Se Fill viene specificato, tutti e quattro i lati del controllo si espanderanno per riempire qualsiasi spazio disponibile.

  • In un sistema multi-monitor, i controlli devono ancorare a sinistra o a destra del monitor corrente. Se ciò non è possibile, devono ancorare sul lato sinistro del monitor più a sinistra o sul lato destro del monitor più a 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.

Eccezioni

I provider devono sollevare le eccezioni seguenti.

Tipo di eccezione Condizione
InvalidOperationException SetDockPosition

- Quando un controllo non è in grado di eseguire lo stile di ancoraggio richiesto.

Vedere anche

  • Last updated on