ITextRangeProvider.Move(TextUnit, Int32) 메서드

정의

네임스페이스:
System.Windows.Automation.Provider
어셈블리:
UIAutomationProvider.dll
어셈블리:
UIAutomationProvider.dll, UIAutomationTypes.dll
어셈블리:
UIAutomationTypes.dll

텍스트 범위를 지정된 수의 텍스트 단위로 이동합니다.

public:
 int Move(System::Windows::Automation::Text::TextUnit unit, int count);
public int Move(System.Windows.Automation.Text.TextUnit unit, int count);
abstract member Move : System.Windows.Automation.Text.TextUnit * int -> int
Public Function Move (unit As TextUnit, count As Integer) As Integer

매개 변수

unit
TextUnit

텍스트 단위 경계입니다.

count
Int32

이동할 텍스트 단위의 수입니다.

양수 값은 텍스트 범위를 앞으로 이동하고 음수 값은 텍스트 범위를 뒤로 이동하며 0은 영향을 주지 않습니다.

반품

Int32

실제로 이동된 단위 수입니다. 새 텍스트 범위 엔드포인트 중 하나가 엔드포인트보다 크거나 작은 경우 요청된 수보다 작을 DocumentRange 수 있습니다.

설명

텍스트 범위의 콘텐츠를 탐색해야 할 때 Move 메서드가 성공적으로 실행되도록 하기 위해 백그라운드에서 여러 단계가 수행됩니다.

  1. 텍스트 범위가 정규화됩니다. 즉, 텍스트 범위가 Start 엔드포인트에서 단일화된 범위로 축소되어 End 엔드포인트가 불필요하게 됩니다. 이 단계는 텍스트 범위가 경계에 걸쳐 unit 있는 상황에서 모호성을 제거하는 데 필요합니다. 예를 들어 "{{" 및 "}"이 텍스트 범위 엔드포인트인 경우 "{U}RL https://www.microsoft.com/ 이 텍스트에 포함됩니다."

  2. 결과 범위는 요청된 DocumentRange 경계의 시작 부분으로 unit 뒤로 이동합니다.

  3. DocumentRange에서 요청된 수의 unit 경계를 따라 범위를 앞으로 또는 뒤로 이동합니다.

  4. 요청된 End 경계에 따라 unit 엔드포인트를 이동하여 퇴행성 범위 상태에서 범위를 확장합니다.

Move 및 ExpandToEnclosingUnit에 의한 Move 및 ExpandToEnclosingUnit Move() 및 ExpandToEnclosingUnit()에 대해 텍스트 범위를 조정하는 방법의 예

텍스트 컨테이너 및 포함된 개체(예: 하이퍼링크 또는 테이블 셀)의 텍스트 내용(또는 내부 텍스트)은 UI 자동화 트리의 컨트롤 뷰와 콘텐츠 뷰에서 지속적인 단일 텍스트 스트림으로 노출됩니다. 개체 경계는 무시됩니다.

포함된 개체에 의해 확장되는 텍스트 범위입니다. 포함된 개체 및 범위 범위가 있는 텍스트 스트림의 예

Move 는 숨겨진 텍스트와 표시되는 텍스트를 모두 적용합니다.

Move지정된 컨트롤에서 지원되지 않는 경우 TextUnit 지원되는 다음으로 가장 TextUnit 큰 값으로 지연합니다.

가장 작은 단위에서 가장 큰 단위로 순서가 아래에 나열되어 있습니다.

텍스트는 어떤 방식으로도 변경되지 않으며 텍스트 범위는 텍스트의 다른 부분에만 적용됩니다.

적용 대상