Compartir a través de


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

Establece el valor de la propiedad para un intervalo de texto mediante un objeto de almacén de propiedades.

Sintaxis

HRESULT SetValueStore(
  [in] TfEditCookie     ec,
  [in] ITfRange         *pRange,
  [in] ITfPropertyStore *pPropStore
);

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 se establece el valor de la propiedad. Este parámetro no puede ser NULL. Este método produce un error si pRange está vacío.

[in] pPropStore

Puntero a una interfaz ITfPropertyStore que obtiene los datos de propiedad.

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_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.

Comentarios

Los valores de propiedad establecidos con ITfProperty::SetValue se descartarán cuando se modifique el texto que cubre el valor de la propiedad. Para obtener control sobre lo que sucede con un valor de propiedad cuando se modifica el texto, use ITfProperty::SetValueStore .

Los valores establecidos con ITfProperty::SetValue se serializarán, 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

   
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::SetValue

ITfPropertyStore

ITfRange