Metodo ITfEditRecord::GetTextAndPropertyUpdates (msctf.h)

Articolo
08/24/2023

Ottiene un enumeratore che contiene una raccolta di oggetti intervallo che coprono le proprietà e/o il testo specificati modificati durante la sessione di modifica.

Sintassi

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

Parametri

[in] dwFlags

Contiene una combinazione dei valori seguenti che specificano il comportamento di questo metodo.

Valore	Significato
0	Specifica che il metodo otterrà una raccolta di oggetti intervallo che coprono le proprietà specificate modificate durante la sessione di modifica. prgProperties non può essere NULL e cProperties deve essere maggiore di zero.
TF_GTP_INCL_TEXT	Specifica che il metodo otterrà la raccolta di oggetti intervallo che coprono il testo modificato durante la sessione di modifica.

[in] prgProperties

Puntatore a una matrice di valori GUID che identificano le proprietà per cui cercare le modifiche. Questo metodo cerca le proprietà modificate durante la sessione di modifica e, se la proprietà è contenuta in questa matrice, un oggetto range che copre la proprietà modificata viene aggiunta a ppEnum.

Questa matrice deve essere di almeno gli elementi cProperties di dimensioni.

Questo parametro viene ignorato se dwFlags contiene TF_GTP_INCL_TEXT e cProperties è zero.

[in] cProperties

Specifica il numero di elementi nella matrice prgProperties .

Questo parametro può essere zero se dwFlags contiene TF_GTP_INCL_TEXT. Ciò indica che non vengono ottenute modifiche alle proprietà.

[out] ppEnum

Puntatore a un puntatore all'interfaccia IEnumTfRanges che riceve l'oggetto enumeratore.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	Uno o più parametri non sono validi.
E_OUTOFMEMORY	Si è verificato un errore di allocazione della memoria.

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

IEnumTfRanges

ITfEditRecord

Condividi tramite