IUIAutomationTextRange::ExpandToEnclosingUnit 메서드(uiautomationclient.h)
지정된 텍스트 단위로 텍스트 범위를 정규화합니다. 범위가 지정된 단위보다 작으면 확장되거나 지정된 단위보다 길면 줄입니다.
구문
HRESULT ExpandToEnclosingUnit(
[in] TextUnit textUnit
);
매개 변수
[in] textUnit
형식: TextUnit
줄 또는 단락과 같은 텍스트 단위입니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.
설명
화면 읽기 프로그램과 같은 클라이언트 애플리케이션은 이 메서드를 사용하여 삽입 지점 또는 캐리트 위치에 있는 전체 단어, 문장 또는 단락을 검색합니다.
이름에도 불구하고 ExpandToEnclosingUnit 메서드가 반드시 텍스트 범위를 확장할 필요는 없습니다. 대신 범위가 지정된 텍스트 단위를 포함하도록 엔드포인트를 이동하여 텍스트 범위를 "정규화"합니다. 범위가 지정된 단위보다 작으면 확장되거나 지정된 단위보다 길면 줄입니다. 범위가 이미 지정된 단위의 정확한 수량인 경우 변경되지 않은 상태로 유지됩니다. 다음 다이어그램에서는 ExpandToEnclosingUnit이 범위의 엔드포인트를 이동하여 텍스트 범위를 정규화하는 방법을 보여 줍니다.
ExpandToEnclosingUnit 전후 엔드포인트를 보여 주는 다이어그램
ExpandToEnclosingUnit은 지정된 텍스트 단위가 컨트롤에서 지원되지 않는 경우 지원되는 다음으로 큰 텍스트 단위로 기본 설정됩니다.
가장 작은 단위에서 가장 큰 단위로의 순서는 다음과 같습니다.
- 문자
- 서식
- Word
- 줄
- Paragraph
- 페이지
- 문서
ExpandToEnclosingUnit은 표시되는 텍스트와 숨겨진 텍스트를 모두 존중합니다.
단위가 인 경우의 범위 동작TextUnit::Format
TextUnit::Format단위 값으로 텍스트 범위의 경계를 배치하여 범위 내에서 텍스트의 공유 텍스트 특성(또는 형식)에 따라 범위를 확장하거나 이동합니다. 그러나 텍스트 단위는 Format 이미지 또는 하이퍼링크와 같은 포함된 개체의 경계를 넘어 텍스트 범위를 이동하거나 확장하지 않습니다. 자세한 내용은 텍스트 단위 UI 자동화 또는 텍스트콘텐츠에 대한 UI 자동화 지원을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트, WINDOWS XP SP3 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트, Windows Server 2003 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | uiautomationclient.h(UIAutomation.h 포함) |