UI 자동화 컨트롤 패턴 개요
컨트롤 패턴은 컨트롤 기능의 특정 측면을 Microsoft UI 자동화 클라이언트 애플리케이션에 노출하는 인터페이스 구현입니다. 클라이언트는 컨트롤 패턴을 통해 노출되는 속성 및 메서드를 사용하여 컨트롤의 특정 기능에 대한 정보를 검색하거나 컨트롤 동작의 특정 측면을 조작합니다. 예를 들어 테이블 형식 인터페이스를 제공하는 컨트롤은 Grid 컨트롤 패턴을 사용하여 테이블의 행과 열 수를 노출하고 클라이언트가 테이블에서 항목을 검색할 수 있도록 합니다.
UI 자동화는 컨트롤 패턴을 사용하여 공통된 컨트롤 동작을 나타냅니다. 예를 들어 단추와 같이 호출할 수 있는 컨트롤에 대해 Invoke 컨트롤 패턴을 사용하고 목록 상자, 목록 보기 또는 콤보 상자와 같은 스크롤 막대가 있는 컨트롤의 스크롤 컨트롤 패턴을 사용합니다. 각 컨트롤 패턴은 별도의 기능을 나타내기 때문에 컨트롤 패턴을 결합하여 특정 컨트롤에서 지원하는 전체 기능 집합을 설명할 수 있습니다.
참고
집계 컨트롤은 부모에 의해 노출되는 기능에 대한 사용자 인터페이스를 제공하는 자식 컨트롤을 사용하여 빌드되며, 부모는 일반적으로 자식 컨트롤과 연결된 모든 컨트롤 패턴을 구현해야 합니다. 따라서 이러한 동일한 컨트롤 패턴을 하위 컨트롤이 구현할 필요가 없습니다.
이 항목에는 다음과 같은 섹션이 포함되어 있습니다.
UI 자동화 컨트롤 패턴 구성 요소
컨트롤 패턴은 컨트롤에서 사용할 수 있는 개별 기능을 정의하는 데 필요한 메서드, 속성, 이벤트 및 관계를 지원합니다.
- 메서드는 UI 자동화 클라이언트가 컨트롤을 조작할 수 있도록 합니다.
- 속성 및 이벤트는 컨트롤의 기능 및 상태에 대한 정보를 제공합니다.
- UI 자동화 요소와 부모, 자식 및 형제 간의 관계는 UI 자동화 트리의 요소 구조를 설명합니다.
컨트롤 패턴은 인터페이스가 COM(구성 요소 개체 모델) 개체와 관련된 방식과 유사한 컨트롤과 관련이 있습니다. COM에서 개체를 쿼리하여 지원하는 인터페이스를 묻고 해당 인터페이스를 사용하여 기능에 액세스할 수 있습니다. UI 자동화 클라이언트는 지원하는 컨트롤 패턴을 컨트롤에 요청한 다음 지원되는 컨트롤 패턴에 의해 노출되는 속성, 메서드, 이벤트 및 구조를 통해 컨트롤과 상호 작용할 수 있습니다.
공급자 및 클라이언트의 컨트롤 패턴
UI 자동화 공급자는 컨트롤 패턴 인터페이스를 구현하여 컨트롤에서 지원하는 특정 기능에 대한 적절한 동작을 노출합니다. 이러한 인터페이스는 클라이언트에 직접 노출되지 않지만 UI 자동화 코어에서 다른 클라이언트 인터페이스 집합을 구현하는 데 사용됩니다. 예를 들어 공급자는 IScrollProvider를 통해 UI 자동화 스크롤 기능을 노출하고 UI 자동화 IUIAutomationScrollPattern을 통해 클라이언트에 기능을 노출합니다.
동적 컨트롤 패턴
일부 컨트롤에서는 동일한 컨트롤 패턴의 집합이 항상 지원되지는 않습니다. 예를 들어 여러 줄 편집 컨트롤은 볼 수 있는 영역에 표시할 수 있는 것보다 많은 텍스트 줄이 포함된 경우에만 세로 스크롤을 사용할 수 있습니다. 스크롤이 더 이상 필요하지 않을만큼 충분한 양의 텍스트가 제거되면 스크롤이 비활성화됩니다. 이 예제에서는 편집 상자에 있는 텍스트 양에 따라 IUIAutomationScrollPattern 이 동적으로 지원됩니다.
컨트롤 패턴 및 관련 인터페이스
다음 표에서는 UI 자동화 컨트롤 패턴에 대해 설명합니다. 또한 이 표에는 컨트롤 패턴을 구현하는 데 사용되는 공급자 인터페이스와 해당 패턴에 액세스하는 데 사용되는 클라이언트 인터페이스가 나열되어 있습니다.
| 속성 | 공급자 인터페이스 | 클라이언트 인터페이스 | 설명 |
|---|---|---|---|
| 주석 | IAnnotationProvider | IUIAutomationAnnotationPattern | 문서에서 주석의 속성을 노출하는 데 사용됩니다(예: 문서 텍스트에 연결된 여백의 주석). |
| Dock | IDockProvider | IUIAutomationDockPattern | 도킹 컨테이너에 도킹할 수 있는 컨트롤(예: 도구 모음 또는 도구 팔레트)에 사용됩니다. |
| 끌기 | IDragProvider | IUIAutomationDragPattern | 끌기 가능 컨트롤이나 끌기 가능 항목이 있는 컨트롤을 지원하는 데 사용됩니다. |
| DropTarget | IDropTargetProvider | IUIAutomationDropTargetPattern | 끌어서 놓기 작업의 대상이 될 수 있는 컨트롤을 지원하는 데 사용됩니다. |
| ExpandCollapse | IExpandCollapseProvider | IUIAutomationExpandCollapsePattern | 확장하거나 축소할 수 있는 컨트롤(예: 파일 메뉴와 같은 애플리케이션의 메뉴 항목)에 사용됩니다. |
| 그리드 | IGridProvider | IUIAutomationGridPattern | 크기 조정 및 지정된 셀로 이동과 같은 그리드 기능을 지원하는 컨트롤에 사용됩니다(예: Windows Explorer 큰 아이콘 보기 또는 Microsoft Office Word 단순 테이블). |
| GridItem | IGridItemProvider | IUIAutomationGridItemPattern | 표에 셀이 있는 컨트롤에 사용됩니다. 개별 셀은 GridItem 패턴(예: Windows Explorer 세부 정보 보기의 각 셀)을 지원해야 합니다. |
| Invoke | IInvokeProvider | IUIAutomationInvokePattern | 단추와 같이 호출할 수 있는 컨트롤에 사용됩니다. |
| ItemContainer | IItemContainerProvider | IUIAutomationItemContainerPattern | 다른 항목을 포함할 수 있는 컨트롤에 사용됩니다. |
| LegacyIAccessible | ILegacyIAccessibleProvider | IUIAutomationLegacyIAccessiblePattern | Microsoft Active Accessibility 속성 및 메서드를 UI 자동화 클라이언트에 노출하는 데 사용됩니다. |
| MultipleView | IMultipleViewProvider | IUIAutomationMultipleViewPattern | 같은 정보, 데이터 또는 자식 집합의 여러 표현 간에 전환할 수 있는 컨트롤(예: 썸네일, 타일, 아이콘, 목록 또는 세부 정보 보기에서 데이터를 사용할 수 있는 목록 보기 컨트롤)에 사용됩니다. |
| ObjectModel | IObjectModelProvider | IUIAutomationObjectModelPattern | 포인터를 문서의 기본 개체 모델에 표시하는 데 사용됩니다. 이 컨트롤 패턴을 사용하면 클라이언트가 UI 자동화 요소에서 기본 개체 모델로 이동할 수 있습니다. |
| RangeValue | IRangeValueProvider | IUIAutomationRangeValuePattern | 값 범위가 있는 컨트롤에 사용됩니다. 예를 들어 연도를 표시하는 회전자 컨트롤의 범위는 1900~2010일 수 있지만 월을 표시하는 회전자 컨트롤의 범위는 1~12입니다. |
| 스크롤 | IScrollProvider | IUIAutomationScrollPattern | 컨트롤의 볼 수 있는 영역에 표시할 수 있는 것보다 더 많은 정보가 있을 때 스크롤할 수 있는 컨트롤에 사용됩니다. |
| ScrollItem | IScrollItemProvider | IUIAutomationScrollItemPattern | 목록의 개별 항목이 스크롤되는 컨트롤(예: 콤보 상자 컨트롤의 목록 컨트롤)에 사용됩니다. |
| 선택 항목 | ISelectionProvider | IUIAutomationSelectionPattern | 선택 컨테이너 컨트롤(예: 목록 상자 및 콤보 상자)에 사용됩니다. |
| SelectionItem | ISelectionItemProvider | IUIAutomationSelectionItemPattern | 목록 상자 및 콤보 상자와 같은 선택 컨테이너 컨트롤의 개별 항목에 사용됩니다. |
| 스프레드시트 | ISpreadsheetProvider | IUIAutomationSpreadsheetPattern | 스프레드시트 또는 기타 그리드 기반 문서의 내용을 표시하는 데 사용됩니다. 스프레드시트 컨트롤 패턴을 구현하는 컨트롤도 Grid 컨트롤 패턴을 구현해야 합니다. |
| SpreadsheetItem | ISpreadsheetItemProvider | IUIAutomationSpreadsheetItemPattern | 스프레드시트 또는 기타 그리드 기반 문서에 있는 셀의 속성을 표시하는 데 사용됩니다. 또한 SpreadsheetItem 컨트롤 패턴을 구현하는 컨트롤은 GridItem 컨트롤 패턴을 구현해야 합니다. |
| 스타일 | IStylesProvider | IUIAutomationStylesPattern | 특정 스타일, 채우기 색, 채우기 패턴 또는 도형이 있는 UI 요소를 설명하는 데 사용됩니다. |
| SynchronizedInput | ISynchronizedInputProvider | IUIAutomationSynchronizedInputPattern | 키보드 또는 마우스 입력을 허용하는 컨트롤에 사용됩니다. |
| 테이블 | ITableProvider | IUIAutomationTablePattern | 그리드 및 헤더 정보가 있는 컨트롤에 사용됩니다. |
| TableItem | ITableItemProvider | IUIAutomationTableItemPattern | 테이블의 항목에 사용됩니다. |
| Text | ITextProvider | IUIAutomationTextPattern | 편집 컨트롤 및 텍스트 정보를 노출하는 문서에 사용됩니다. |
| TextEdit | ITextEditProvider | IUIAutomationTextEditPattern | 자동 수정을 수행하거나 입력 컴퍼지션을 사용하도록 설정하는 컨트롤과 같이 프로그래밍 방식으로 텍스트를 수정하는 편집 컨트롤에 사용됩니다. |
| TextChild | ITextChildProvider | IUIAutomationTextChildPattern | Text 컨트롤 패턴을 지원하는 요소의 가장 가까운 상위 항목에 액세스하는 데 사용됩니다. |
| TextRange | ITextRangeProvider | IUIAutomationTextRange | 편집 컨트롤 및 문서와 같은 텍스트 기반 컨트롤에서 텍스트 콘텐츠, 텍스트 특성 및 포함된 개체를 검색하는 데 사용됩니다. |
| Toggle | IToggleProvider | IUIAutomationTogglePattern | 상태를 전환할 수 있는 컨트롤(예: 검사 상자 및 확인 가능한 메뉴 항목)에 사용됩니다. |
| 변환 | ITransformProvider | IUIAutomationTransformPattern | 크기 조정, 이동 및 회전할 수 있는 컨트롤에 사용됩니다. Transform 컨트롤 패턴은 디자이너, 폼, 그래픽 편집기 및 그리기 애플리케이션에서 일반적으로 사용됩니다. |
| 값 | IValueProvider | IUIAutomationValuePattern | 지정된 범위 내에 있지 않은 값이 있는 컨트롤(예: 날짜-시간 선택기)에 사용됩니다. |
| VirtualizedItem | IVirtualizedItemProvider | IUIAutomationVirtualizedItemPattern | 가상 목록의 항목과 함께 작동하는 컨트롤에 사용됩니다. |
| 창 | IWindowProvider | IUIAutomationWindowPattern | 창에 사용됩니다. 예를 들어 최상위 애플리케이션 창, MDI(다중 문서 인터페이스) 자식 창 및 대화 상자가 있습니다. |
관련 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기