다음을 통해 공유


그리드 컨트롤 패턴

속성 및 메서드에 대한 정보를 포함하여 IGridProvider구현하기 위한 지침 및 규칙을 설명합니다. Grid 컨트롤 패턴은 자식 요소 컬렉션의 컨테이너 역할을 하는 컨트롤을 지원하는 데 사용됩니다.

이 요소의 자식은 IGridItemProvider 구현하고 행과 열로 트래버스할 수 있는 2차원 논리 좌표계로 구성되어야 합니다. 이 컨트롤 패턴을 구현하는 컨트롤의 예제는 컨트롤 형식 및 지원되는 컨트롤 패턴참조하세요.

이 항목에는 다음 섹션이 포함되어 있습니다.

구현 지침 및 규칙

Grid 컨트롤 패턴을 구현하는 경우 다음 지침 및 규칙을 확인합니다.

  • 그리드 좌표는 좌표(0,0)가 있는 왼쪽 위(또는 로캘에 따라 오른쪽 위 셀)가 있는 0부터 시작하는 것입니다.

  • 셀이 비어 있는 경우 해당 셀에 대한 IGridItemProvider::ContainingGrid 속성을 지원하려면 Microsoft UI Automation 요소가 여전히 반환되어야 합니다. 그리드에 있는 자식 요소의 레이아웃이 비정형 배열과 유사할 때 가능합니다(아래 예제 참조).

    빈 좌표가 있는 그리드 컨트롤의 예는

  • 단일 항목이 있는 그리드는 논리적으로 그리드로 간주되는 경우 IGridProvider 구현해야 합니다. 그리드의 자식 항목 수는 비물질입니다.

  • 공급자 구현에 따라 숨겨진 행과 열은 UI 자동화 트리에 로드될 수 있으므로 IGridProvider::RowCountColumnCount 속성반영됩니다. 숨겨진 행과 열이 아직 로드되지 않은 경우 계산되지 않아야 합니다.

  • IGridProvider 그리드의 활성 조작을 사용하도록 설정하지 않습니다. 이 기능을 사용하려면 ITransformProvider 구현해야 합니다.

  • IUIAutomationStructureChangedEventHandler 사용하여 추가, 제거 또는 병합된 셀과 같은 그리드의 구조적 또는 레이아웃 변경 내용을 수신 대기합니다.

  • IUIAutomationFocusChangedEventHandler 사용하여 그리드의 항목 또는 셀을 통한 순회를 추적합니다.

IGridProvider 필요한 멤버

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

필수 멤버 멤버 형식 노트
RowCount 재산 없음
ColumnCount 재산 없음
GetItem 메서드 없음

 

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

컨트롤 형식 및 지원되는 컨트롤 패턴

GridItem 컨트롤 패턴

UI 자동화 컨트롤 패턴 개요

UI 자동화 트리 개요