Método ITfReadOnlyProperty::GetValue (msctf.h)

Obtiene el valor de la propiedad para un intervalo de texto.

Sintaxis

HRESULT GetValue(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pRange,
  [out] VARIANT      *pvarValue
);

Parámetros

[in] ec

Contiene una cookie de edición que identifica el contexto de edición. Esto se obtiene de ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] pRange

Puntero a una interfaz ITfRange que especifica el intervalo para el que se va a obtener la propiedad .

[out] pvarValue

Puntero a un valor VARIANT que recibe el valor de propiedad. El propietario de la propiedad define el tipo de datos y el contenido de este valor y el autor de la llamada debe reconocerlo para usar este valor. El autor de la llamada debe liberar estos datos, cuando ya no es necesario, pasando este valor a variantClear API.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
S_FALSE	El intervalo no está cubierto por la propiedad o el intervalo contiene más de un valor de propiedad. pvarValue recibe un valor de VT_EMPTY.
E_INVALIDARG	Uno o varios parámetros no son válidos.
E_FAIL	Se ha producido un error no especificado.
TF_E_NOLOCK	El contexto de edición identificado por ec no tiene un bloqueo de solo lectura o de lectura y escritura.

Comentarios

Si la propiedad no tiene ningún valor sobre pRange, pRange contiene más de un valor para la propiedad o la propiedad no cubre completamente pRange, pvarValue recibe un valor de VT_EMPTY y el método devuelve S_FALSE.

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->||<-

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|    |<-

COLOR:      RR      GGGGGGGG
TEXT:  this is some colored text
    range-->|             |<-

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional

Consulte también

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfReadOnlyProperty