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 |
|---|---|
|
Il metodo è stato eseguito correttamente. |
|
Uno o più parametri non sono validi. |
|
Si è verificato un errore di allocazione della memoria. |
|
Si è verificato un errore non specificato. |
|
Il contesto di modifica identificato da ec non ha un blocco di lettura/scrittura. |
|
Il contesto di modifica è di sola lettura. |
|
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 |