UI 자동화 Dock 컨트롤 패턴 구현
참고 항목
이 설명서는 System.Windows.Automation 네임스페이스에 정의된 관리되는 UI 자동화 클래스를 사용하려는 .NET Framework 개발자를 위한 것입니다. UI 자동화에 대한 최신 정보는 Windows 자동화 API: UI 자동화를 참조하세요.
이 항목에서는 속성에 대한 정보를 포함하여 IDockProvider를 구현하기 위한 지침 및 규칙을 제공합니다. 추가 참조에 대한 링크는 항목 끝에 나열되어 있습니다.
DockPattern 컨트롤 패턴은 도킹 컨테이너 내에서 컨트롤의 도킹 속성을 노출하는 데 사용 됩니다. 도킹 컨테이너는 자식 요소를 서로 맞춰 가로 또는 세로로 정렬할 수 있는 컨트롤입니다. 이 컨트롤 패턴을 구현하는 컨트롤의 예제를 보려면 Control Pattern Mapping for UI Automation Clients을 참조하세요.
Visual Studio에서 "클래스 뷰" 창이 DockPosition.Right이고 "오류 목록" 창이 DockPosition.Bottom인 도킹의 예
구현 지침 및 규칙
Dock 컨트롤 패턴을 구현할 때는 다음 지침 및 규칙에 유의하세요.
IDockProvider 는 도킹 컨테이너의 속성 또는 도킹 컨테이너 내에 있는 현재 컨트롤에 인접하여 도킹된 컨트롤의 속성을 노출하지 않습니다.
컨트롤은 현재 z-순서에 따라 서로 맞춰가며 도킹됩니다. z-순서 배치가 높을수록 도킹 컨테이너의 지정된 가장자리에서 멀리 배치됩니다.
도킹 컨테이너의 크기가 조정되는 경우, 컨테이너 내의 모든 도킹된 컨트롤은 원래 도킹되었던 가장자리와 같은 수준의 위치로 재조정됩니다. 또한 도킹된 컨트롤의 크기가 조정되어 DockPosition의 도킹 동작에 따라 컨테이너 내의 모든 공간을 채웁니다. 예를 들어, Top 이 지정된 경우 컨트롤의 왼쪽과 오른쪽이 확장되어 사용 가능한 모든 공간을 채웁니다. Fill 이 지정된 경우 컨트롤의 상/하/좌/우 모두 확장되어 사용 가능한 모든 공간을 채웁니다.
다중 모니터 시스템에서, 컨트롤은 현재 모니터의 왼쪽 또는 오른쪽에 도킹해야 합니다. 그렇지 않을 경우, 가장 왼쪽에 있는 모니터의 왼쪽이나 가장 오른쪽에 있는 모니터의 오른쪽에 도킹해야 합니다.
IDockProvider에 필요한 멤버
IDockProvider 인터페이스를 구현하려면 다음과 같은 속성 및 메서드가 필요합니다.
| 필수 멤버 | 멤버 형식 | 주의 |
|---|---|---|
| DockPosition | 속성 | None |
| SetDockPosition | 메서드 | None |
이 컨트롤 패턴에 연결된 이벤트가 없습니다.
예외
공급자는 다음과 같은 예외를 throw해야 합니다.
| 예외 종류 | 조건 |
|---|---|
| InvalidOperationException | SetDockPosition - 컨트롤이 요청된 도킹 스타일을 실행할 수 없는 경우. |