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

Artigo
08/24/2023

Define o valor da propriedade para um intervalo de texto usando um objeto de repositório de propriedades.

Sintaxe

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

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] pPropStore

Ponteiro para uma interface ITfPropertyStore que obtém os dados da propriedade.

Valor retornado

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

Comentários

Os valores de propriedade definidos com ITfProperty::SetValue serão descartados quando o texto que o valor da propriedade abrange for modificado. Para obter controle sobre o que acontece com um valor de propriedade quando o texto é modificado, use ITfProperty::SetValueStore .

Os valores definidos com ITfProperty::SetValue serão serializados, exceto pelos 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


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