Méthode ITfProperty::SetValueStore (msctf.h)

Article
08/24/2023

Définit la valeur de la propriété pour une plage de texte à l’aide d’un objet de magasin de propriétés.

Syntaxe

HRESULT SetValueStore(
  [in] TfEditCookie     ec,
  [in] ITfRange         *pRange,
  [in] ITfPropertyStore *pPropStore
);

Paramètres

[in] ec

Contient un cookie de modification qui identifie le contexte de modification. Elle est obtenue à partir de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] pRange

Pointeur vers une interface ITfRange qui contient la plage pour laquelle la valeur de propriété est définie. Ce paramètre ne peut pas avoir la valeur NULL. Cette méthode échoue si pRange est vide.

[in] pPropStore

Pointeur vers une interface ITfPropertyStore qui obtient les données de propriété.

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_FAIL	Une erreur non spécifiée s'est produite.
TF_E_NOLOCK	Le contexte de modification identifié par ec n’a pas de verrou en lecture/écriture.

Notes

Les valeurs de propriété définies avec ITfProperty::SetValue sont ignorées lorsque le texte couvert par la valeur de la propriété est modifié. Pour contrôler ce qui arrive à une valeur de propriété lorsque le texte est modifié, utilisez ITfProperty::SetValueStore .

Les valeurs définies avec ITfProperty::SetValue seront sérialisées, à l’exception des valeurs de type VT_UNKNOWN, qui ne sont pas sérialisées. Si une valeur de propriété de type VT_UNKNOWN doit être sérialisée, utilisez plutôt ITfProperty::SetValueStore .

Les valeurs de propriété qui se chevauchent du même type ne sont pas prises en charge.

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