[S/W 접근성] TextPattern

TextPattern

 

 TextPattern은 텍스트 박스처럼 내부에 텍스트를 갖을 수 있는 컨트롤의 패턴입니다.

 

 TextPattern 클래스에서는 텍스트 범위와 선택 영역 지원 형식을 가져오는 속성을 제공합니다.

public TextPatternRange DocumentRange { get; };

public SupportedTextSelection SupportedTextSelection { get; };

 

 TextPatternRange 클래스는 텍스트의 범위를 나타내는 형식입니다. TextPatternRange 클래스에서는 다양한 메서드를 제공합니다.

public void AddToSelection();

public bool Compare(      TextPatternRange range);

public int CompareEndpoints(TextPatternRangeEndpoint endpoint,

         TextPatternRange targetRange,TextPatternRangeEndpoint targetEndpoint);

public void ExpandToEnclosingUnit(TextUnit unit);

public TextPatternRange FindAttribute(AutomationTextAttribute attribute,

         Object value, bool backward );

public TextPatternRange FindText( string text, bool backward, bool ignoreCase );

public Object GetAttributeValue(     AutomationTextAttribute attribute );

public Rect[] GetBoundingRectangles();

public AutomationElement[] GetChildren();

public AutomationElement GetEnclosingElement();

public string GetText(       int maxLength );

public int Move( TextUnit unit, int count );

public void MoveEndpointByRange(TextPatternRangeEndpoint endpoint,

         TextPatternRange targetRange, TextPatternRangeEndpoint targetEndpoint );

public int MoveEndpointByUnit(TextPatternRangeEndpoint endpoint,

         TextUnit unit, int count );

public void RemoveFromSelection();

public void ScrollIntoView( bool alignToTop );

public void Select()

 

메서드 명	설명
AddToSelection	선택 컬렉션에 추가
Compare	텍스트의 범위가 같은지 비교
CompareEndpoints	두 텍스트 범위의 끝점 비교
ExpandToEnclosingUnit	텍스트 범위 확장
FindAttribute	특정 특성 값을 갖는 텍스트 범위의 하위 집합 찾기
FindText	특정 텍스트를 포함하는 텍스트 범위의 하위 집합 찾기
GetAttributeValue	특정 특성의 값 구하기
GetBoundingRectangles	텍스트 범위의 각 텍스트의 경계 사각형 컬렉션 구하기
GetChildren	텍스트 범위 안에 포함된 자식 컬렉션 구하기
GetEnclosingElement	텍스트 범위를 포함하는 가장 안쪽의 자동화 요소 구하기
GetText	텍스트 구하기
Move	지정된 텍스트 단위만큼 텍스트 범위를 이동
MoveEndpointByRange	첫 번째 끝점을 두 번째 텍스트 범위의 끝점으로 이동
MoveEndpointByUnit	첫 번째 끝점을 지정한 TextUnit 수만큼 이동
RemoveFromSelection	강조 표시된 텍스트 섹션을 제거
ScrollIntoView	텍스트 범위가 보일 때까지 스크롤
Select	텍스트를 선택(강조 표시)

[표] TextPatternRange 클래스 멤버 메서드

 

 SuportedTextSelection 형식은 None, Single, Mutiple 멤버로 구성된 열거형입니다.

 

열거형 멤버	설명
None	선택할 수 없음
Single	단일 선택 지원
Multiple	다중 선택 지원

[표] RangeValuePatternInformation 구조체 속성

  

 TextPattern 클래스에서는 다양한 조건으로 TextPatternRange 개체를 구하는 메서드를 제공합니다.

public TextPatternRange[] GetSelection();

public TextPatternRange[] GetVisibleRanges();

public TextPatternRange RangeFromChild( AutomationElement childElement );

public TextPatternRange RangeFromPoint( Point screenLocation );

 

메서드 명	설명
GetSelection	선택한 영역의 TextPatternRange 컬렉션 구하기
GetVisibleRanges	시각적으로 보이는 TextPatternRange 컬렉션 구하기
RangeFromChild	자식 요소를 둘러싸는 TextPatternRange 개체 구하기
RangeFromPoint	좌표에 가장 가까운 빈 영역 TextPatternRange 개체 구하기

[표] TextPattern 클래스의 멤버 메서드

 

 이 외에도 TextPattern 클래스에서는 다양한 정적 멤버 필드를 제공합니다.

public static readonly AutomationTextAttribute AnimationStyleAttribute;

public static readonly AutomationTextAttribute BackgroundColorAttribute;

public static readonly AutomationTextAttribute BulletStyleAttribute;

public static readonly AutomationTextAttribute CapStyleAttribute;

public static readonly AutomationTextAttribute CultureAttribute;

public static readonly AutomationTextAttribute FontNameAttribute;

public static readonly AutomationTextAttribute FontSizeAttribute;

public static readonly AutomationTextAttribute FontWeightAttribute;

public static readonly AutomationTextAttribute ForegroundColorAttribute;

public static readonly AutomationTextAttribute HorizontalTextAlignmentAttribute;

public static readonly AutomationTextAttribute IndentationFirstLineAttribute;

public static readonly AutomationTextAttribute IndentationLeadingAttribute;

public static readonly AutomationTextAttribute IndentationTrailingAttribute;

public static readonly AutomationTextAttribute IsHiddenAttribute;

public static readonly AutomationTextAttribute IsItalicAttribute;

public static readonly AutomationTextAttribute IsReadOnlyAttribute;

public static readonly AutomationTextAttribute IsSubscriptAttribute;

public static readonly AutomationTextAttribute IsSuperscriptAttribute;

public static readonly AutomationTextAttribute MarginBottomAttribute;

public static readonly AutomationTextAttribute MarginLeadingAttribute;

public static readonly AutomationTextAttribute MarginTopAttribute;

public static readonly AutomationTextAttribute MarginTrailingAttribute;

public static readonly Object MixedAttributeValue;

public static readonly AutomationTextAttribute OutlineStylesAttribute;

public static readonly AutomationTextAttribute OverlineColorAttribute;

public static readonly AutomationTextAttribute OverlineStyleAttribute;

public static readonly AutomationPattern Pattern;

public static readonly AutomationTextAttribute StrikethroughColorAttribute;

public static readonly AutomationTextAttribute StrikethroughStyleAttribute;

public static readonly AutomationTextAttribute TabsAttribute;

public static readonly AutomationEvent TextChangedEvent;

public static readonly AutomationTextAttribute TextFlowDirectionsAttribute;

public static readonly AutomationEvent TextSelectionChangedEvent;

public static readonly AutomationTextAttribute UnderlineColorAttribute;

public static readonly AutomationTextAttribute UnderlineStyleAttribute;