Metodo ITfProperty::SetValue (msctf.h)

Articolo
02/29/2024

Imposta il valore della proprietà per un intervallo.

Sintassi

HRESULT SetValue(
  [in] TfEditCookie  ec,
  [in] ITfRange      *pRange,
  [in] const VARIANT *pvarValue
);

Parametri

[in] ec

Contiene un cookie di modifica che identifica il contesto di modifica. Si ottiene da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] pRange

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

[in] pvarValue

Puntatore a una struttura VARIANT che contiene il nuovo valore della proprietà. Sono supportati solo i valori di tipo VT_I4, VT_UNKNOWN, VT_BSTR e VT_EMPTY.

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.
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.
TF_E_READONLY	Il contesto di modifica è di sola lettura.
TF_E_NOTOWNEDRANGE	Il gestore TSF non possiede l'intervallo.

Commenti

I valori delle proprietà impostati con questo metodo verranno eliminati quando viene modificato il testo che copre il valore della proprietà. Per ottenere il controllo personalizzato su una risposta di valore alle modifiche di testo, usare ITfProperty::SetValueStore.

I valori impostati con questo metodo vengono serializzati, ad eccezione dei valori di tipo VT_UNKNOWN, che non vengono serializzati. Se è necessario serializzare un valore di proprietà di tipo VT_UNKNOWN, usare invece ITfProperty::SetValueStore .

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

Requisiti

Requisito	Valore
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