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의 위치가 변경됩니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

이 메서드를 사용하는 호출자는 ITextStoreAnchor::RequestLock 메서드를 호출하여 문서에 대한 읽기 전용 잠금이 있어야 합니다. 읽기 전용 잠금이 없으면 메서드가 실패하고 TF_E_NOLOCK 반환합니다.

애플리케이션은 내부적인 이유로 메서드 반환 값을 잘라낼 수 있습니다.

여러 GetText 호출로 텍스트를 빠르게 검사하기 위해 호출자는 fUpdateAnchor = TRUE를 사용합니다.

paStart와 paEnd 사이의 문자 수가 cchReq보다 작은 경우 복사된 실제 문자 수는 cchReq보다 작을 수 있습니다.

GetText의 동작은 반환된 텍스트가 적용되는 지역 경계의 영향을 받지 않습니다.

요구 사항

추가 정보

ITextStoreAnchor

ITextStoreAnchor::RequestLock

관리자 반환 값

TS_RUNINFO