프로그래밍 기술/소프트웨어 접근성, UI 자동화

[S/W 접근성] TextPattern

언제나휴일 2016. 4. 26. 08:01
반응형

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;

반응형