Método ITfEditRecord::GetTextAndPropertyUpdates (msctf.h)

Artigo
08/24/2023

Obtém um enumerador que contém uma coleção de objetos de intervalo que abrangem as propriedades especificadas e/ou texto que foram alterados durante a sessão de edição.

Sintaxe

HRESULT GetTextAndPropertyUpdates(
  [in]  DWORD         dwFlags,
  [in]  const GUID    **prgProperties,
  [in]  ULONG         cProperties,
  [out] IEnumTfRanges **ppEnum
);

Parâmetros

[in] dwFlags

Contém uma combinação dos valores a seguir que especificam o comportamento desse método.

Valor	Significado
0	Especifica que o método obterá uma coleção de objetos de intervalo que abrangem as propriedades especificadas alteradas durante a sessão de edição. prgProperties não podem ser NULL e cProperties devem ser maiores que zero.
TF_GTP_INCL_TEXT	Especifica que o método obterá a coleção de objetos de intervalo que abrangem o texto alterado durante a sessão de edição.

[in] prgProperties

Ponteiro para uma matriz de valores GUID que identificam as propriedades para pesquisar alterações. Esse método pesquisa as propriedades que foram alteradas durante a sessão de edição e, se a propriedade estiver contida nessa matriz, um objeto de intervalo que abrange a propriedade que foi alterada será adicionado ao ppEnum.

Essa matriz deve ter pelo menos elementos cProperties de tamanho.

Esse parâmetro será ignorado se dwFlags contiver TF_GTP_INCL_TEXT e cProperties for zero.

[in] cProperties

Especifica o número de elementos na matriz prgProperties .

Esse parâmetro poderá ser zero se dwFlags contiver TF_GTP_INCL_TEXT. Isso indica que nenhuma alteração de propriedade é obtida.

[out] ppEnum

Ponteiro para um ponteiro de interface IEnumTfRanges que recebe o objeto enumerador.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_OUTOFMEMORY	Ocorreu uma falha de alocação de memória.

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

IEnumTfRanges

ITfEditRecord

Compartilhar via