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

Article
08/24/2023

Obtient un énumérateur qui contient une collection d’objets de plage qui couvrent les propriétés spécifiées et/ou le texte modifié pendant la session d’édition.

Syntaxe

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

Paramètres

[in] dwFlags

Contient une combinaison des valeurs suivantes qui spécifient le comportement de cette méthode.

Valeur	Signification
0	Spécifie que la méthode obtient une collection d’objets de plage qui couvrent les propriétés spécifiées modifiées pendant la session d’édition. prgProperties ne peut pas être NULL et cProperties doit être supérieur à zéro.
TF_GTP_INCL_TEXT	Spécifie que la méthode obtient la collection d’objets de plage qui couvrent le texte modifié pendant la session de modification.

[in] prgProperties

Pointeur vers un tableau de valeurs GUID qui identifient les propriétés pour laquelle rechercher des modifications. Cette méthode recherche les propriétés qui ont été modifiées pendant la session de modification et, si la propriété est contenue dans ce tableau, un objet de plage qui couvre la propriété modifiée est ajouté à ppEnum.

Ce tableau doit avoir au moins la taille des éléments cProperties .

Ce paramètre est ignoré si dwFlags contient TF_GTP_INCL_TEXT et si cProperties est égal à zéro.

[in] cProperties

Spécifie le nombre d’éléments dans le tableau prgProperties .

Ce paramètre peut être égal à zéro si dwFlags contient TF_GTP_INCL_TEXT. Cela indique qu’aucune modification de propriété n’est obtenue.

[out] ppEnum

Pointeur vers un pointeur d’interface IEnumTfRanges qui reçoit l’objet énumérateur.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
E_OUTOFMEMORY	Un échec d’allocation de mémoire s’est produit.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

IEnumTfRanges

ITfEditRecord

Partager via