Compartilhar via


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

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

Confira também

Bloqueios de documento

Itextstoreacp

ITextStoreACP::InsertTextAtSelection

ITextStoreACP::RequestLock

ITextStoreACP::SetText

ITextStoreACPSink

Constantes diversas do repositório de texto

TS_TEXTCHANGE