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

Artículo
08/24/2023

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