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

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.

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

Confira também

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfProperty::SetValueStore

ITfRange