Compartir a través de

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

  • Artículo

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