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

Artigo
08/26/2023

Chamado quando o texto no fluxo de texto é alterado.

Sintaxe

HRESULT OnTextChange(
  [in] DWORD   dwFlags,
  [in] IAnchor *paStart,
  [in] IAnchor *paEnd
);

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_TC_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 dados de arquivo .wav ou um identificador de idioma. Esse sinalizador é usado para aplicativos que precisam preservar os dados associados ao texto original.

[in] paStart

Ponteiro para uma âncora localizada no início do texto alterado.

[in] paEnd

Ponteiro para uma âncora localizada no final do texto alterado.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	O método não pôde criar âncoras clonadas para conter a alteração.
E_INVALIDARG	paStart ou paEnd é 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 ITextStoreAnchor , como ITextStoreAnchor::SetText.

Comentários

Esse método é chamado somente quando o aplicativo modifica seu próprio texto, não quando um cliente modifica o texto com um dos métodos ITextStoreAnchor , como ITextStoreAnchor::SetText ou ITextStoreAnchor::InsertTextAtSelection.

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

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