ITextStoreAnchor::GetText 메서드(textstor.h)
ITextStoreAnchor::GetText 메서드는 지정된 앵커 위치에 있는 텍스트에 대한 정보를 반환합니다. 이 메서드는 표시 및 숨겨진 텍스트를 반환하고 포함된 데이터가 텍스트에 연결되어 있는지를 나타냅니다.
구문
HRESULT GetText(
[in] DWORD dwFlags,
[in] IAnchor *paStart,
[in] IAnchor *paEnd,
[out] WCHAR *pchText,
[in] ULONG cchReq,
[out] ULONG *pcch,
[in] BOOL fUpdateAnchor
);
매개 변수
[in] dwFlags
사용되지 않음; 0이어야 합니다.
[in] paStart
시작 앵커 위치를 지정합니다.
[in] paEnd
끝 앵커 위치를 지정합니다. NULL인 경우 텍스트 스트림의 맨 끝에 있는 앵커인 것처럼 처리됩니다.
[out] pchText
텍스트를 받을 버퍼를 지정합니다. cchReq = 0인 경우에만 NULL일 수 있습니다.
[in] cchReq
pchText 버퍼 크기를 문자로 지정합니다.
[out] pcch
pchText 버퍼에 복사된 문자 수를 받습니다.
[in] fUpdateAnchor
TRUE이면 pchText에 복사된 마지막 문자 바로 뒤에 paStart의 위치가 변경됩니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
메서드가 paStart 및/또는 paEnd에 대한 유효한 인터페이스 포인터를 가져올 수 없습니다. |
|
paStart 또는 paEnd 앵커는 문서 텍스트 외부에 있습니다. |
|
호출자에게 문서에 대한 읽기 전용 잠금이 없습니다. |
설명
이 메서드를 사용하는 호출자는 ITextStoreAnchor::RequestLock 메서드를 호출하여 문서에 대한 읽기 전용 잠금이 있어야 합니다. 읽기 전용 잠금이 없으면 메서드가 실패하고 TF_E_NOLOCK 반환합니다.
애플리케이션은 내부적인 이유로 메서드 반환 값을 잘라낼 수 있습니다.
여러 GetText 호출로 텍스트를 빠르게 검사하기 위해 호출자는 fUpdateAnchor = TRUE를 사용합니다.
paStart와 paEnd 사이의 문자 수가 cchReq보다 작은 경우 복사된 실제 문자 수는 cchReq보다 작을 수 있습니다.
GetText의 동작은 반환된 텍스트가 적용되는 지역 경계의 영향을 받지 않습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | textstor.h |
| DLL | Msctf.dll |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |