스타일 컨트롤 패턴

속성 및 메서드에 대한 정보를 포함하여 IStylesProvider 구현에 대한 지침 및 규칙을 설명합니다. 스타일 컨트롤 패턴은 특정 스타일, 채우기 색, 채우기 패턴 또는 도형이 있는 UI 요소를 설명하는 데 사용됩니다.

스타일 컨트롤 패턴은 이러한 스타일이 자주 있는 문서의 요소를 설명하는 데 특히 유용합니다. 스타일은 일반적으로 장애가 있는 고객에게 유용한 정보를 전달합니다. 예를 들어 스타일은 특정 문자열을 문서의 제목으로 설명하거나 특정 순서도 개체를 다이아몬드 또는 원으로 설명할 수 있습니다. 이 컨트롤 패턴을 구현하는 컨트롤의 예제는 컨트롤 형식 및 지원되는 컨트롤 패턴을 참조하세요.

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

• 구현 지침 및 규칙
• IStylesProvider에 필요한 멤버
• 관련 항목

구현 지침 및 규칙

스타일 컨트롤 패턴을 구현할 때 다음 지침 및 규칙을 확인합니다.

• UIAutomationClient.h 헤더 파일은 몇 가지 일반적인 스타일을 식별하는 데 사용되는 명명된 상수 값 집합을 정의합니다. 자세한 내용은 스타일 식별자를 참조하세요.
• StyleId_Custom 사용하는 경우 IStylesProvider::StyleName 속성을 구현하여 클라이언트가 스타일 이름을 검색할 수 있도록 해야 합니다. Microsoft UI 자동화 기본 이름을 제공하므로 표준 스타일에 대해 StyleName 속성을 구현할 필요는 없지만 기본 이름을 재정의해야 하는 경우 구현할 수 있습니다.
• 스타일 패턴의 다른 속성은 선택 사항입니다. 공급자는 지원되지 않는 속성에 대한 UIA_E_NOTSUPPORTED 반환할 수 있습니다.
• 텍스트 범위의 스타일은 다음 텍스트 특성을 통해 나타낼 수 있습니다.
  • StyleId 텍스트 특성에 대한 요청에 응답할 때 텍스트 범위는 스타일 식별자에 설명된 스타일 식별자 중 하나를 반환해야 합니다.
  • StyleId_Custom 사용하는 경우 클라이언트가 스타일 이름을 검색할 수 있도록 텍스트 범위는 StyleName 텍스트 특성에 대한 문자열 값을 반환해야 합니다.
  • 제목 및 일반 텍스트와 같이 여러 스타일이 있는 텍스트 범위는 StyleId 및 StyleName 속성 모두에 대한 특수 UI 자동화 ReservedMixedAttributeValue 속성을 반환해야 합니다. 이 응답을 수신하는 클라이언트는 텍스트 범위를 세분화하여 스타일이 시작되고 끝나는 위치를 찾을 수 있습니다.
• 애플리케이션은 다양한 스타일을 사용하여 개체를 설명할 수 있지만 UI 자동화 가장 일반적인 스타일만 나타냅니다. 테두리 색과 같은 추가 스타일 특성을 나타내기 위해 공급자는 ExtendedProperties 속성에 추가 특성 목록을 반환할 수 있습니다. 기본적으로 확장 속성 집합이 있는 속성 모음입니다(예: "BorderColor=0xFF0000; BorderStyle=dotted". 확장 속성의 값은 애플리케이션별로 다를 수 있습니다.

IStylesProvider에 필요한 멤버

IStylesProvider 인터페이스를 구현하려면 다음 속성이 필요합니다.

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

관련 항목

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

UI 자동화 컨트롤 패턴 개요

UI 자동화 트리 개요