備註
本檔適用於想要使用 System.Windows.Automation 命名空間中定義的受控UI自動化類別的 .NET Framework 開發人員。 如需 UI 自動化的最新資訊，請參閱 Windows 自動化 API：使用者介面自動化。
本主題介紹實作 IDockProvider的指導方針和慣例，包括屬性的相關信息。 主題結尾會列出其他參考的連結。
控制項模式 DockPattern 用於揭露停駐容器內控制項的停駐屬性。 停駐容器是一個控件，可讓您相對於彼此水準和垂直排列子專案。 如需實作此控制項模式的控制項範例，請參閱 UI 自動化用戶端的控制項模式對應。
這是 Visual Studio 的停駐範例，其中 [Class View] 視窗為 DockPosition.Right，而 [錯誤清單] 視窗為 DockPosition.Bottom
實作指導方針和慣例
實作 Dock 控制項模式時，請注意下列指導方針和慣例：
IDockProvider 不會公開停駐容器的任何屬性，或停駐於目前控制項相鄰之其他控制項在該停駐容器內的任何屬性。
控件會根據其目前的迭置順序，彼此相對停駐;其迭置順序放置愈高，則較遠於停駐容器的指定邊緣。
如果停駐容器重設大小，容器內的任何停駐控件都會重新置放到原本停駐的相同邊緣。 停駐控件也會根據容器 DockPosition的停駐行為調整大小，以填滿容器內的任何空間。 例如，如果 Top 指定 ，控件的左右兩側將會展開以填滿任何可用空間。 如果 Fill 已指定，控件的所有四端都會展開以填滿任何可用空間。
在多監視器系統上，控件應該停駐在目前監視器的左側或右側。 如果不可能，它們應該停駐在最左邊監視器的左側或最右邊的監視器右側。
IDockProvider 的必要成員
實作 IDockProvider 介面需要下列屬性和方法。
| 必要成員 | 成員類型 | 註釋 |
|---|---|---|
| DockPosition | 房產 | 沒有 |
| SetDockPosition | 方法 | 沒有 |
此控制件模式沒有相關聯的事件。
例外狀況
提供者必須擲回下列例外狀況。
| 例外狀況類型 | 狀況 |
|---|---|
| InvalidOperationException | SetDockPosition - 當控件無法執行要求的停駐樣式時。 |