탭 컨트롤 유형
이 항목에서는 Tab 컨트롤 형식에 대한 Microsoft UI 자동화 지원에 대한 정보를 제공합니다.
탭 컨트롤은 노트북의 구분선 또는 파일 캐비닛의 레이블과 유사합니다. 애플리케이션은 탭 컨트롤을 사용하여 창 또는 대화 상자의 동일한 영역에 대해 여러 페이지를 정의할 수 있습니다.
다음 섹션에서는 Tab 컨트롤 형식에 필요한 UI 자동화 트리 구조, 속성, 컨트롤 패턴 및 이벤트를 정의합니다. UI 자동화 요구 사항은 UI 프레임워크/플랫폼이 컨트롤 형식 및 컨트롤 패턴에 대한 UI 자동화 지원을 통합하는 모든 탭 컨트롤에 적용됩니다.
이 항목에는 다음과 같은 섹션이 포함되어 있습니다.
일반적인 트리 구조
다음 표에서는 탭 컨트롤과 관련된 UI 자동화 트리의 일반적인 컨트롤 및 콘텐츠 뷰를 설명하고 각 보기에 포함될 수 있는 내용을 설명합니다. UI 자동화 트리에 대한 자세한 내용은 UI 자동화 트리 개요를 참조하세요.
컨트롤 뷰 | 콘텐츠 뷰 |
---|---|
|
|
Tab 컨트롤에는 TabItem 컨트롤 형식에 따라 자식 UI 자동화 요소가 있습니다. 탭 항목이 그룹화되면(예: Microsoft Office 응용 프로그램에서와 같이) Tab 컨트롤 형식은 다음 트리 구조와 같이 그룹화된 탭 항목에 대한 그룹 컨트롤 형식을 호스트할 수도 있습니다.
컨트롤 뷰 | 콘텐츠 뷰 |
---|---|
|
|
관련 속성
다음 표에서는 값 또는 정의가 탭 컨트롤과 특히 관련된 UI 자동화 속성을 나열합니다. UI 자동화 속성에 대한 자세한 내용은 UI 자동화 요소에서 속성 검색을 참조하세요.
UI 자동화 속성 | 값 | 참고 |
---|---|---|
UIA_AutomationIdPropertyId | 메모를 참조하세요. | 이 속성의 값은 UI 자동화 트리의 원시 뷰에 있는 모든 피어 요소에서 고유해야 합니다. |
UIA_BoundingRectanglePropertyId | 메모를 참조하세요. | 전체 컨트롤이 포함된 가장 바깥쪽 사각형입니다. |
UIA_ClickablePointPropertyId | No | 탭 컨트롤에 클릭 가능한 점이 없습니다. |
UIA_ControlTypePropertyId | Tab | |
UIA_IsContentElementPropertyId | TRUE | Tab 컨트롤이 UI 자동화 트리의 콘텐츠 뷰에 항상 포함됩니다. |
UIA_IsControlElementPropertyId | TRUE | Tab 컨트롤이 UI 자동화 트리의 컨트롤 뷰에 항상 포함됩니다. |
UIA_IsKeyboardFocusablePropertyId | TRUE | Tab 컨트롤 형식은 키보드 포커스를 받을 수 있어야 합니다. 일반적으로 UI 자동화 클라이언트는 탭 컨트롤에서 IUIAutomationElement::SetFocus를 호출하고 해당 항목 중 하나는 키보드 포커스를 탭 컨트롤로 전달합니다. 포커스가 항목 중 하나로 설정되지 않아도 일부 탭 컨테이너에서 포커스를 받을 수 있습니다. |
UIA_LabeledByPropertyId | 메모를 참조하세요. | 탭 컨트롤에는 일반적으로 이 속성을 통해 노출되는 정적 텍스트 레이블이 있습니다. |
UIA_LocalizedControlTypePropertyId | 메모를 참조하세요. | Tab 컨트롤 형식에 해당하는 지역화된 문자열입니다. 기본값은 en-US 또는 영어(미국)의 경우 "tab"입니다. |
UIA_NamePropertyId | 메모를 참조하세요. | 탭 컨트롤에는 Name 속성이 거의 필요하지 않습니다. |
UIA_OrientationPropertyId | 메모를 참조하세요. | 탭 컨트롤은 항상 가로 또는 세로로 배치되어 있는지 나타내야 합니다. |
필수 컨트롤 패턴
다음 표에서는 모든 Tab 컨트롤에서 지원되는 데 필요한 UI 자동화 컨트롤 패턴을 나열하여 보여 줍니다. 컨트롤 패턴에 대한 자세한 내용은 UI Automation Control Patterns Overview를 참조하세요.
컨트롤 패턴/패턴 속성 | 지원/값 | 참고 |
---|---|---|
ISelectionProvider | 필수 | 모든 탭 컨트롤은 선택 컨트롤 패턴을 지원해야 합니다. |
IsSelectionRequired | TRUE | 탭 컨트롤에 항상 선택 항목이 있어야 합니다. |
CanSelectMultiple | FALSE | 탭 컨트롤은 항상 단일 선택 컨테이너입니다. |
IScrollProvider | 개체 | 탭 컨트롤에 탭 항목 집합을 스크롤할 수 있는 위젯이 있는 경우 스크롤 컨트롤 패턴을 지원해야 합니다. |
필요한 이벤트
다음 표에서는 탭 컨트롤이 지원하는 데 필요한 UI 자동화 이벤트를 나열합니다. 이벤트에 대한 자세한 내용은 UI Automation Events Overview를 참조하세요.
UI 자동화 이벤트 | 참고 |
---|---|
UIA_AutomationFocusChangedEventId | |
속성 변경 이벤트를 UIA_BoundingRectanglePropertyId. | |
속성 변경 이벤트를 UIA_IsEnabledPropertyId. | 컨트롤이 IsEnabled 속성을 지원하는 경우 이 이벤트를 지원해야 합니다. |
속성 변경 이벤트를 UIA_IsOffscreenPropertyId. | 컨트롤이 IsOffscreen 속성을 지원하는 경우 이 이벤트를 지원해야 합니다. |
속성 변경 이벤트를 UIA_ScrollHorizontallyScrollablePropertyId. | 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다. |
속성 변경 이벤트를 UIA_ScrollHorizontalScrollPercentPropertyId. | 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다. |
속성 변경 이벤트를 UIA_ScrollHorizontalViewSizePropertyId. | 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다. |
속성 변경 이벤트를 UIA_ScrollVerticallyScrollablePropertyId. | 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다. |
속성 변경 이벤트를 UIA_ScrollVerticalScrollPercentPropertyId. | 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다. |
속성 변경 이벤트를 UIA_ScrollVerticalViewSizePropertyId. | 컨트롤이 스크롤 컨트롤 패턴을 지원하는 경우 이 이벤트를 지원해야 합니다. |
UIA_StructureChangedEventId |
관련 항목