비고
이 설명서는 System.Windows.Automation 네임스페이스에 정의된 관리되는 UI 자동화 클래스를 사용하려는 .NET Framework 개발자를 위한 것입니다. UI 자동화에 대한 최신 정보는 Windows Automation API: UI 자동화참조하세요.
이 항목에서는 속성, 메서드 및 이벤트에 대한 정보를 포함하여 구현하기 IWindowProviderWindowPattern 위한 지침 및 규칙을 소개합니다. 추가 참조에 대한 링크는 항목 끝에 나열되어 있습니다.
WindowPattern 컨트롤 패턴은 기존 GUI(그래픽 사용자 인터페이스) 내에서 기본 창 기반 기능을 제공하는 컨트롤을 지원하는 데 사용됩니다. 이 컨트롤 패턴을 구현해야 하는 컨트롤의 예로는 최상위 애플리케이션 창, MDI(다중 문서 인터페이스) 자식 창, 크기 조정 가능한 분할 창 컨트롤, 모달 대화 상자 및 풍선 도움말 창이 있습니다.
구현 지침 및 규칙
Window 컨트롤 패턴을 구현할 때는 다음 지침 및 규칙에 유의하세요.
UI 자동화를 사용하여 창 크기와 화면 위치를 모두 수정하는 기능을 지원하려면 컨트롤은 ITransformProvider 뿐만 아니라 IWindowProvider도 구현해야 합니다.
제목 표시줄과 제목 표시줄 요소가 포함되어 있어 컨트롤을 이동, 크기 조정, 최대화, 최소화 또는 닫을 수 있도록 하는 컨트롤은 일반적으로 IWindowProvider을 구현해야 합니다.
도구 설명 팝업, 콤보 상자 또는 메뉴 드롭다운과 같은 컨트롤은 일반적으로 IWindowProvider를 구현하지 않습니다.
풍선 도움말 창은 창과 유사한 닫기 단추를 프로비전하여 기본 도구 설명 팝업과 구별됩니다.
전체 화면 모드는 IWindowProvider에서 지원되지 않습니다. 이는 애플리케이션과 관련된 기능이며 일반적인 창 동작이 아니기 때문에 지원되지 않습니다.
IWindowProvider에 필요한 멤버
IWindowProvider 인터페이스에는 다음과 같은 속성, 메서드 및 이벤트가 필요합니다.
| 필수 멤버 | 멤버 형식 | 비고 |
|---|---|---|
| InteractionState | 재산 | 없음 |
| IsModal | 재산 | 없음 |
| IsTopmost | 재산 | 없음 |
| Maximizable | 재산 | 없음 |
| Minimizable | 재산 | 없음 |
| VisualState | 재산 | 없음 |
| Close | 메서드 | 없음 |
| SetVisualState | 메서드 | 없음 |
| WaitForInputIdle | 메서드 | 없음 |
| WindowClosedEvent | 이벤트 | 없음 |
| WindowOpenedEvent | 이벤트 | 없음 |
| WindowInteractionState | 이벤트 | 보장되지 않습니다. ReadyForUserInteraction |
예외
공급자는 다음 예외를 반드시 throw해야 합니다.
| 예외 유형 | 조건 |
|---|---|
| InvalidOperationException | SetVisualState - 컨트롤이 요청된 동작을 지원하지 않는 경우 |
| ArgumentOutOfRangeException | WaitForInputIdle - 매개 변수가 유효한 숫자가 아닌 경우 |