스타일 컨트롤 패턴

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

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

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

구현 지침 및 규칙

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

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

IStylesProvider에 필요한 멤버

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

필요한 멤버 멤버 형식 참고
ExtendedProperties 속성 없음
FillColor 속성 없음
FillPatternColor 속성 없음
FillPatternStyle 속성 없음
모양 속성 없음
StyleId 속성 없음
StyleName 속성 없음

 

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

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

UI 자동화 컨트롤 패턴 개요

UI 자동화 트리 개요