다음을 통해 공유


UI 자동화 Dock 컨트롤 패턴 구현

비고

이 설명서는 System.Windows.Automation 네임스페이스에 정의된 관리되는 UI 자동화 클래스를 사용하려는 .NET Framework 개발자를 위한 것입니다. UI 자동화에 대한 최신 정보는 Windows Automation API: UI 자동화참조하세요.

이 항목에서는 속성에 대한 정보를 포함하여 구현하기 IDockProvider위한 지침 및 규칙을 소개합니다. 추가 참조에 대한 링크는 항목 끝에 나열되어 있습니다.

DockPattern 컨트롤 패턴은 도킹 컨테이너 내에서 컨트롤의 도킹 속성을 노출하는 데 사용됩니다. 도킹 컨테이너는 자식 요소를 서로 상대적으로 가로 및 세로로 정렬할 수 있는 컨트롤입니다. 이 컨트롤 패턴을 구현하는 컨트롤의 예제는 UI 자동화 클라이언트 대한컨트롤 패턴 매핑을 참조하세요.

두 개의 도킹된 자식이 있는 도킹 컨테이너입니다. "클래스 뷰" 창이 DockPosition.Right이고 "오류 목록" 창이 DockPosition.Bottom인 Visual Studio의 도킹 예제

구현 지침 및 규칙

Dock 컨트롤 패턴을 구현할 때 다음 지침 및 규칙을 확인합니다.

  • IDockProvider 도킹 컨테이너의 속성 또는 도킹 컨테이너 내의 현재 컨트롤에 인접한 도킹된 컨트롤의 속성을 노출하지 않습니다.

  • 컨트롤은 현재 z 순서에 따라 서로 상대적으로 도킹됩니다. z 순서 배치가 높을수록 도킹 컨테이너의 지정된 가장자리에서 더 멀리 배치됩니다.

  • 도킹 컨테이너의 크기가 조정되면 컨테이너 내의 도킹된 컨트롤의 위치가 원래 도킹된 것과 동일한 가장자리로 플러시됩니다. 또한 도킹된 컨트롤의 도킹 동작 DockPosition에 따라 컨테이너 내의 모든 공간을 채우기 위해 크기가 조정됩니다. 예를 들어 지정된 경우 Top 컨트롤의 왼쪽과 오른쪽이 확장되어 사용 가능한 공간을 채웁니다. 지정된 경우 Fill 컨트롤의 네 면이 모두 확장되어 사용 가능한 모든 공간을 채웁니다.

  • 다중 모니터 시스템에서 컨트롤은 현재 모니터의 왼쪽 또는 오른쪽에 도킹되어야 합니다. 가능하지 않은 경우 가장 왼쪽 모니터의 왼쪽 또는 가장 오른쪽 모니터의 오른쪽에 도킹해야 합니다.

IDockProvider에 필요한 멤버

IDockProvider 인터페이스를 구현하려면 다음 속성과 메서드가 필요합니다.

필수 멤버 멤버 형식 비고
DockPosition 재산 없음
SetDockPosition 메서드 없음

이 컨트롤 패턴에 연결된 이벤트가 없습니다.

예외

공급자는 다음 예외를 반드시 throw해야 합니다.

예외 유형 조건
InvalidOperationException SetDockPosition

- 컨트롤이 요청된 도크 스타일을 실행할 수 없는 경우

참고하십시오