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

Artigo
08/24/2023

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

Share via