Metodo ITfProperty::SetValue (msctf.h)

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

Vedi anche

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfProperty::SetValueStore

ITfRange