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

Artículo
02/29/2024

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