TextRange_ExpandToEnclosingUnit 함수(uiautomationcoreapi.h)

참고 이 함수는 더 이상 사용되지 않습니다. 클라이언트 애플리케이션은 Microsoft UI 자동화 COM(구성 요소 개체 모델) 인터페이스를 대신 사용해야 합니다.

텍스트 범위를 문자, Word, 선 또는 페이지와 같은 더 크거나 작은 단위로 확장합니다.

구문

HRESULT TextRange_ExpandToEnclosingUnit(
  [in] HUIATEXTRANGE hobj,
  [in] TextUnit      unit
);

[in] hobj

형식: HUIATEXTRANGE

텍스트 범위 개체입니다.

[in] unit

형식: TextUnit

공급자가 텍스트 범위를 확장해야 하는 단위입니다.

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

범위가 이미 지정된 단위의 정수인 경우 변경되지 않은 상태로 유지됩니다.

시작 엔드포인트가 TextUnit 경계에 없는 경우 경계에 도달될 때까지 뒤로 이동합니다. 그런 다음 끝 엔드포인트가 경계에 없거나 시작 엔드포인트와 동일한 경계에 있는 경우 끝 엔드포인트는 경계에 올 때까지 앞으로 이동합니다.

참고 화면 읽기 프로그램은 삽입 지점이나 가상 커서 위치에서 전체 단어, 전체 단락 등을 읽는 것이 일반적입니다.

TextRange_ExpandToEnclosingUnit 숨겨진 텍스트와 표시되는 텍스트를 모두 존중합니다. UI Automationclient는 텍스트 표시를 위해 숨김 특성(Text_IsHidden_Attribute_GUID)을 검사 수 있습니다.

TextRange_ExpandToEnclosingUnit 지정된 TextUnit 이 컨트롤에서 지원되지 않는 경우 지원되는 다음 TextUnit 까지 기본값입니다.