Compartir a través de

Método ITfProperty::SetValue (msctf.h)

  • Artículo

Establece el valor de la propiedad para un intervalo.

Sintaxis

HRESULT SetValue(
  [in] TfEditCookie  ec,
  [in] ITfRange      *pRange,
  [in] const 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 contiene el intervalo para el que está establecido el valor de la propiedad. Este parámetro no puede ser NULL. Este método producirá un error si pRange está vacío.

[in] pvarValue

Puntero a una estructura VARIANT que contiene el nuevo valor de propiedad. Solo se admiten valores de tipo VT_I4, VT_UNKNOWN, VT_BSTR y VT_EMPTY.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
 Método realizado correctamente.
E_INVALIDARG
 Uno o varios parámetros no son válidos.
E_OUTOFMEMORY
 Error de asignación de memoria.
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 lectura y escritura.
TF_E_READONLY
 El contexto de edición es de solo lectura.
TF_E_NOTOWNEDRANGE
 El administrador de TSF no posee el intervalo.

Comentarios

Los valores de propiedad establecidos con este método se descartarán cuando se modifique el texto que cubre el valor de propiedad. Para obtener un control personalizado sobre una respuesta de valor a las ediciones de texto, use ITfProperty::SetValueStore.

Los valores establecidos con este método se serializan, excepto los valores de tipo VT_UNKNOWN, que no se serializan. Si se debe serializar un valor de propiedad de tipo VT_UNKNOWN, use ITfProperty::SetValueStore en su lugar.

No se admiten los valores de propiedad superpuestos del mismo tipo.

Requisitos

Requisito Value
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

ITfProperty

ITfProperty::SetValueStore

ITfRange