Compartilhar via


Método ITfRange::GetText (msctf.h)

O método ITfRange::GetText obtém o conteúdo coberto por esse intervalo de texto.

Sintaxe

HRESULT GetText(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [out] WCHAR        *pchText,
  [in]  ULONG        cchMax,
  [out] ULONG        *pcch
);

Parâmetros

[in] ec

Edite o cookie que identifica o contexto de edição obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] dwFlags

Campos de bits que especificam o comportamento opcional.

Valor Significado
TF_TF_MOVESTART
A âncora inicial do intervalo é avançada para a posição após o último caractere retornado.
TF_TF_IGNOREEND
O método tenta preencher pchText com o número máximo de caracteres, em vez de interromper a cópia na posição ocupada pela âncora final do intervalo.

[out] pchText

Ponteiro para um buffer para receber o texto no intervalo.

[in] cchMax

Tamanho máximo do buffer de texto.

[out] pcch

Ponteiro para um ULONG que representa o número de caracteres gravados no buffer de texto pchText .

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido.
E_FAIL
Ocorreu um erro não especificado.
E_INVALIDARG
Um ou mais parâmetros são inválidos.
TF_E_NOLOCK
O valor do parâmetro ec é um cookie inválido ou o chamador não tem um bloqueio somente leitura.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msctf.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

constantes TF_TF_*

Repositórios de Texto