Método IXpsOMDictionary::SetAt (xpsobjectmodel.h)

Substitui a entrada em um local especificado no dicionário.

Sintaxe

HRESULT SetAt(
  [in] UINT32          index,
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Parâmetros

[in] index

O índice baseado em zero no dicionário no qual uma entrada deve ser substituída.

[in] key

A chave a ser usada para a nova entrada.

A cadeia de caracteres referenciada por chave deve ser exclusiva no dicionário.

[in] entry

O ponteiro da interface IXpsOMShareable que substituirá o conteúdo atual no local especificado pelo índice.

Um dicionário não pode conter ponteiros de interface duplicados. Esse parâmetro deve conter um ponteiro de interface que ainda não esteja no dicionário.

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter informações sobre valores retornados da API de documento XPS que não estão listados nesta tabela, consulte Erros de documento XPS.

Comentários

No local especificado pelo índice, esse método libera a interface IXpsOMShareable referenciada pelo ponteiro existente e, em seguida, substitui-a pelo ponteiro de interface que é passado na entrada e atribui-lhe a chave passada na chave.

Os ponteiros de interface armazenados em um dicionário geralmente apontarão para interfaces, como IXpsOMBrush e IXpsOMVisual, derivadas da interface IXpsOMShareable . Para determinar o tipo de interface, chame o método GetType .

A figura a seguir ilustra como o dicionário é alterado pelo método SetAt .

Requisitos

Confira também

IXpsOMDictionary

IXpsOMShareable

Especificação de Papel XML

Erros de documento XPS