Metodo ITfProperty::SetValueStore (msctf.h)

Articolo
03/08/2023

Imposta il valore della proprietà per un intervallo di testo usando un oggetto archivio proprietà.

Sintassi

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

Parametri

[in] ec

Contiene un cookie di modifica che identifica il contesto di modifica. Questa operazione viene ottenuta da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] pRange

Puntatore a un'interfaccia ITfRange che contiene l'intervallo impostato per il valore della proprietà. Questo parametro non può essere NULL. Questo metodo ha esito negativo se pRange è vuoto.

[in] pPropStore

Puntatore a un'interfaccia ITfPropertyStore che ottiene i dati delle proprietà.

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_FAIL	Si è verificato un errore non specificato.
TF_E_NOLOCK	Il contesto di modifica identificato da ec non ha un blocco di lettura/scrittura.

Commenti

I valori delle proprietà impostati con ITfProperty::SetValue verranno eliminati quando viene modificato il testo che copre il valore della proprietà. Per ottenere il controllo su cosa accade a un valore di proprietà quando il testo viene modificato, usare ITfProperty::SetValueStore .

I valori impostati con ITfProperty::SetValue verranno serializzati, ad eccezione dei valori di tipo VT_UNKNOWN, che non vengono serializzati. Se un valore di proprietà di tipo VT_UNKNOWN deve essere serializzato, usare invece ITfProperty::SetValueStore .

I valori delle proprietà sovrapposti dello stesso tipo non sono supportati.

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