다음을 통해 공유


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

참고참고

이 문서는 System.Windows.Automation 네임스페이스에 정의된 관리되는 UI Automation 클래스를 사용하려는 .NET Framework 개발자를 위해 작성되었습니다.UI Automation에 대한 최신 정보는 Windows Automation API: UI Automation을 참조하십시오.

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

DockPattern 컨트롤 패턴은 도킹 컨테이너 내에서 컨트롤의 도킹 속성을 노출하는 데 사용됩니다. 도킹 컨테이너는 여러 자식 요소를 가로와 세로로 배열할 수 있게 해 주는 컨트롤입니다. 이 컨트롤 패턴을 구현하는 컨트롤 예제를 보려면 UI 자동화 클라이언트에 대한 컨트롤 패턴 매핑을 참조하십시오.

"클래스 뷰" 창이 DockPosition.Right이고 "오류 목록" 창이 DockPosition.Bottom인 Visual Studio의 도킹 예제

두 개의 자식이 도킹된 도킹 컨테이너

이 항목에는 다음 단원이 포함되어 있습니다.

  • 구현 지침 및 규칙
  • IDockProvider의 필수 멤버
  • 예외
  • 관련 항목

구현 지침 및 규칙

Dock 컨트롤 패턴을 구현하는 경우 다음 지침 및 규칙을 따르십시오.

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

  • 컨트롤은 현재 Z 순서에 따라 다른 요소에 상대적인 위치에 도킹되며 Z 순서 위치가 높을수록 지정된 도킹 컨테이너의 가장자리에서 멀리 배치됩니다.

  • 도킹 컨테이너의 크기를 조정하면 컨테이너 안에 도킹된 모든 컨트롤은 원래 도킹되었던 가장자리에 접하여 위치가 재조정됩니다. 또한 도킹된 컨트롤은 DockPosition의 도킹 동작에 따라 컨테이너 안의 공간을 가득 채우도록 크기 조정됩니다. 예를 들어 Top을 지정하면 컨트롤의 왼쪽과 오른쪽이 확장되어 사용 가능한 전체 공간을 가득 채웁니다. Fill을 지정하면 컨트롤의 네 측면이 확장되어 사용 가능한 모든 공간을 채웁니다.

  • 다중 모니터 시스템에서는 컨트롤을 현재 모니터의 왼쪽 또는 오른쪽에 도킹해야 합니다. 이렇게 할 수 없는 경우에는 가장 왼쪽 모니터의 왼쪽 또는 가장 오른쪽 모니터의 오른쪽에 도킹해야 합니다.

IDockProvider의 필수 멤버

IDockProvider 인터페이스 구현에 필요한 속성 및 메서드는 다음과 같습니다.

필수 멤버

멤버 형식

참고

DockPosition

Property

없음

SetDockPosition

메서드

없음

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

예외

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

예외 형식

조건

InvalidOperationException

SetDockPosition

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

참고 항목

작업

UI 자동화 공급자의 컨트롤 패턴 지원

UI 자동화의 캐싱 사용

개념

UI 자동화 컨트롤 패턴 개요

클라이언트용 UI 자동화 컨트롤 패턴

UI 자동화 트리 개요