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

Artigo
08/24/2023

Define o valor da propriedade para um intervalo.

Sintaxe

HRESULT SetValue(
  [in] TfEditCookie  ec,
  [in] ITfRange      *pRange,
  [in] const VARIANT *pvarValue
);

Parâmetros

[in] ec

Contém um cookie de edição que identifica o contexto de edição. Isso é obtido de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] pRange

Ponteiro para uma interface ITfRange que contém o intervalo para o qual o valor da propriedade está definido. Esse parâmetro não pode ser NULL. Esse método falhará se pRange estiver vazio.

[in] pvarValue

Ponteiro para uma estrutura VARIANT que contém o novo valor da propriedade. Há suporte apenas para valores do tipo VT_I4, VT_UNKNOWN, VT_BSTR e VT_EMPTY.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_OUTOFMEMORY	Ocorreu uma falha de alocação de memória.
E_FAIL	Ocorreu um erro não especificado.
TF_E_NOLOCK	O contexto de edição identificado por ec não tem um bloqueio de leitura/gravação.
TF_E_READONLY	O contexto de edição é somente leitura.
TF_E_NOTOWNEDRANGE	O gerenciador do TSF não possui o intervalo.

Comentários

Os valores de propriedade definidos com esse método serão descartados quando o texto que o valor da propriedade abrange for modificado. Para obter controle personalizado sobre uma resposta de valor a edições de texto, use ITfProperty::SetValueStore.

Os valores definidos com esse método são serializados, exceto os valores do tipo VT_UNKNOWN, que não são serializados. Se um valor de propriedade do tipo VT_UNKNOWN precisar ser serializado, use ITfProperty::SetValueStore .

Não há suporte para valores de propriedade sobrepostos do mesmo tipo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional