Share via

ITextRangeProvider::ExpandToEnclosingUnit 메서드(uiautomationcore.h)

  • 아티클

지정된 텍스트 단위로 텍스트 범위를 정규화합니다. 범위가 지정된 단위보다 작으면 확장되거나 지정된 단위보다 길면 줄입니다.

구문

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit unit
);

매개 변수

[in] unit

형식: TextUnit

문자, 단어, 단락 등과 같은 텍스트 단위의 형식입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

화면 읽기 프로그램과 같은 클라이언트 애플리케이션은 이 메서드를 사용하여 삽입 지점 또는 캐리트 위치에 있는 전체 단어, 문장 또는 단락을 검색합니다.

이름에도 불구하고 ITextRangeProvider::ExpandToEnclosingUnit 메서드가 반드시 텍스트 범위를 확장할 필요는 없습니다. 대신 범위가 지정된 텍스트 단위를 포함하도록 엔드포인트를 이동하여 텍스트 범위를 "정규화"합니다. 범위가 지정된 단위보다 작으면 확장되거나 지정된 단위보다 길면 줄입니다. 범위가 이미 지정된 단위의 정확한 수량인 경우 변경되지 않은 상태로 유지됩니다. ExpandToEnclosingUnit 메서드는 항상 일관된 방식으로 텍스트 범위를 정규화하는 것이 중요합니다. 그렇지 않으면 텍스트 단위에 의한 텍스트 범위 조작의 다른 측면을 예측할 수 없습니다. 다음 다이어그램에서는 ExpandToEnclosingUnit 이 범위의 엔드포인트를 이동하여 텍스트 범위를 정규화하는 방법을 보여 줍니다.

지정한 텍스트 단위가 컨트롤에서 지원되지 않는 경우 ExpandToEnclosingUnitExpandToEnclosingUnit 호출 전후의 엔드포인트 위치를 보여 주는 다이어그램 가장 작은 단위에서 가장 큰 단위로의 순서는 다음과 같습니다.
  • 문자
  • 형식
  • Word
  • 선
  • Paragraph
  • 호출
  • Document
ExpandToEnclosingUnit 은 표시되는 텍스트와 숨겨진 텍스트를 모두 존중합니다.

단위가 인 경우의 범위 동작TextUnit::Format

TextUnit::Format단위 값이 텍스트 범위의 경계를 배치하여 범위 내에서 텍스트의 공유 텍스트 특성(형식)에 따라 범위를 확장하거나 이동할 수 있습니다. 그러나 서식 텍스트 단위를 사용하면 이미지 또는 하이퍼링크와 같은 포함된 개체의 경계를 넘어 텍스트 범위를 이동하거나 확장해서는 안 됩니다. 자세한 내용은 UI 자동화 텍스트 단위 또는 텍스트 및 TextRange 컨트롤 패턴을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 uiautomationcore.h(UIAutomation.h 포함)

추가 정보

개념

ITextProvider

ITextRangeProvider

참조

텍스트 및 TextRange 컨트롤 패턴

UI 자동화 공급자 개요