다음을 통해 공유

텍스트 특성 UI 자동화

  • 아티클

이 항목에서는 Microsoft UI 자동화 텍스트 콘텐츠의 형식 및 스타일 속성(텍스트 특성)을 노출하고 지원되는 텍스트 특성 목록을 제공하는 방법을 설명합니다.

UI 자동화 공급자는 TextRange 컨트롤 패턴의 GetAttributeValue 및 FindAttribute 메서드를 통해 텍스트 특성을 노출합니다. 클라이언트 애플리케이션은 IUIAutomationTextRange::GetAttributeValue 메서드를 사용하여 텍스트 범위에 대한 특정 텍스트 특성의 값을 검색합니다. 클라이언트는 IUIAutomationTextRange::FindAttribute 메서드를 사용하여 특정 특성이 있는 텍스트의 텍스트 범위를 검색할 수 있습니다. 일치하는 텍스트가 있으면 메서드는 일치하는 텍스트가 포함된 새 텍스트 범위를 만듭니다.

다음 목록의 텍스트 특성은 TextRange 컨트롤 패턴에서 지원됩니다. 특성 이름은 UI 자동화 텍스트 특성 식별자에서 파생됩니다. 예를 들어 AnimationStyle 특성은 클라이언트에서 UIA_AnimationStyleAttributeId (Uiautomationclient.h에 정의됨) 및 공급자에 의해 Text_AnimationStyle_Attribute_GUID (Uiautomationcoreapi.h에 정의됨)로 식별됩니다. 지원되는 각 텍스트 특성에 대한 자세한 내용은 텍스트 특성 식별자를 참조하세요.

참고

나열된 특성 중 일부는 Windows 8 부터 지원됩니다. 버전 지원에 대한 참고 사항은 텍스트 특성 식별자를 참조하세요.

 

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

주석 특성

주석 개체 및 주석 형식은 다음 특성을 통해 사용할 수 있습니다.

attribute ID
AnnotationObjects UIA_AnnotationObjectsAttributeId
AnnotationTypes UIA_AnnotationTypesAttributeId

 

글꼴 특성

글꼴의 이름, 크기 및 가중치는 다음 특성을 통해 사용할 수 있습니다.

attribute ID
FontName UIA_FontNameAttributeId
FontSize UIA_FontSizeAttributeId
FontWeight UIA_FontWeightAttributeId

 

언어 특성

텍스트의 언어에 대한 정보는 다음 특성을 통해 사용할 수 있습니다.

attribute ID
문화권 UIA_CultureAttributeId
TextFlowDirections UIA_TextFlowDirectionsAttributeId

 

다음 특성은 문서의 링크 대상인 텍스트 범위를 제공합니다.

attribute ID
링크 UIA_LinkAttributeId

 

페이지 여백 특성

텍스트 범위의 경계 사각형은 페이지에 있는 텍스트의 좌표를 노출하지 않습니다. 그러나 공급자는 다음 텍스트 특성을 사용하여 페이지 여백 정보를 노출할 수 있습니다.

attribute ID
MarginBottom UIA_MarginBottomAttributeId
MarginLeading UIA_MarginLeadingAttributeId
MarginTop UIA_MarginTopAttributeId
MarginTrailing UIA_MarginTrailingAttributeId

 

텍스트 맞춤 특성

들여쓰기, 탭 설정 및 가로 맞춤과 같은 텍스트 맞춤에 대한 정보는 다음 특성을 통해 사용할 수 있습니다.

attribute ID
HorizontalTextAlignment UIA_HorizontalTextAlignmentAttributeId
IndentationFirstLine UIA_IndentationFirstLineAttributeId
IndentationLeading UIA_IndentationLeadingAttributeId
들여쓰기트레일링 UIA_IndentationTrailingAttributeId
탭 UIA_TabsAttributeId

 

텍스트 색 특성

전경 및 배경 텍스트 색은 다음 텍스트 특성을 통해 사용할 수 있습니다. 두 색 모두 COLORREF 데이터 형식으로 지정됩니다.

attribute ID
BackgroundColor UIA_BackgroundColorAttributeId
ForegroundColor UIA_ForegroundColorAttributeId

 

텍스트 장식 특성

텍스트 장식에는 글머리 기호, 밑면 및 애니메이션과 같은 영역이 포함됩니다. 텍스트에 선행 글머리 기호 또는 숫자가 포함된 경우 글머리 기호 또는 숫자에 사용되는 기호 또는 텍스트가 텍스트 스트림에 포함되어야 합니다(해당하는 경우).

텍스트 장식에 대한 정보는 다음 특성을 통해 사용할 수 있습니다.

attribute ID
AnimationStyle UIA_AnimationStyleAttributeId
Bulletstyle UIA_BulletStyleAttributeId
OutlineStyles UIA_OutlineStylesAttributeId
OverlineColor UIA_OverlineColorAttributeId
OverlineStyle UIA_OverlineStyleAttributeId
StrikethroughColor UIA_StrikethroughColorAttributeId
StrikethroughStyle UIA_StrikethroughStyleAttributeId
UnderlineColor UIA_UnderlineColorAttributeId
UnderlineStyle UIA_UnderlineStyleAttributeId

 

텍스트 스타일 특성

텍스트 스타일에 대한 정보는 다음 특성을 통해 사용할 수 있습니다.

attribute ID
CapStyle UIA_CapStyleAttributeId
IsHidden UIA_IsHiddenAttributeId
IsItalic UIA_IsItalicAttributeId
IsReadOnly UIA_IsReadOnlyAttributeId
IsSuperscript UIA_IsSuperscriptAttributeId
IsSubscript UIA_IsSubscriptAttributeId

 

상호 작용 및 선택 특성

범위 및 포커스 상태의 현재 텍스트 선택에 대한 정보는 다음 특성을 통해 사용할 수 있습니다.

attribute ID
IsActive UIA_IsActiveAttributeId
SelectionActiveEnd UIA_SelectionActiveEndAttributeId
CaretPosition UIA_CaretPositionAttributeId
CaretBidiMode UIA_CaretBidiModeAttributeId

 

개념

UI 자동화 텍스트 및 TextRange 컨트롤 패턴 정보

텍스트 및 TextRange 컨트롤 패턴

텍스트 기반 컨트롤 작업