Método ITextStoreACPSink::OnTextChange (textstor.h)

Artigo
03/05/2024

Chamado quando o texto de um documento é alterado.

Sintaxe

HRESULT OnTextChange(
  [in] DWORD               dwFlags,
  [in] const TS_TEXTCHANGE *pChange
);

Parâmetros

[in] dwFlags

Contém um conjunto de sinalizadores que especificam informações adicionais sobre a alteração de texto. Esse pode ser um ou mais dos valores a seguir.

Valor	Significado
0	O texto foi alterado.
TS_ST_CORRECTION	O texto é uma transformação (correção) do conteúdo existente e todas as informações especiais de marcação de texto (metadados) são mantidas, como .wav dados de arquivo ou um identificador de idioma. Esse sinalizador é usado para aplicativos que precisam preservar os dados associados ao texto original.

[in] pChange

Ponteiro para uma estrutura de TS_TEXTCHANGE que contém dados de alteração de texto.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	pChange é inválido.
E_OUTOFMEMORY	Ocorreu uma falha de alocação de memória.
TS_E_NOLOCK	O gerenciador do TSF mantém um bloqueio no documento. Isso normalmente indica que o método foi chamado de dentro de outro método ITextStoreACP , como ITextStoreACP::SetText.

Comentários

ITextStoreACPSink::OnTextChange nunca é chamado quando o texto é modificado por um dos métodos de interface ITextStoreACP , como ITextStoreACP::SetText ou ITextStoreACP::InsertTextAtSelection.

Ao chamar esse método, o aplicativo deve ser capaz de conceder um bloqueio de documento.

Requisitos

Requisito	Valor
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	textstor.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional