Metodo ITfReadOnlyProperty::GetValue (msctf.h)

Articolo
03/08/2023

Ottiene il valore della proprietà per un intervallo di testo.

Sintassi

HRESULT GetValue(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pRange,
  [out] 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 specifica l'intervallo per cui ottenere la proprietà .

[out] pvarValue

Puntatore a un valore VARIANT che riceve il valore della proprietà. Il tipo di dati e il contenuto di questo valore sono definiti dal proprietario della proprietà e devono essere riconosciuti dal chiamante per usare questo valore. Il chiamante deve rilasciare questi dati, quando non è più necessario, passando questo valore all'API VariantClear .

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	L'intervallo non è coperto dalla proprietà o l'intervallo contiene più di un valore della proprietà. pvarValue riceve un valore VT_EMPTY.
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 sola lettura o di lettura/scrittura.

Commenti

Se la proprietà non ha alcun valore su pRange, pRange contiene più di un valore per la proprietà o la proprietà non copre completamente pRange, pvarValue riceve un valore VT_EMPTY e il metodo restituisce S_FALSE.


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range--&gt;||&lt;-


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range--&gt;|    |&lt;-


COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range--&gt;|             |&lt;-

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

Vedi anche

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfReadOnlyProperty

Condividi tramite