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

Artigo
08/28/2023

Acrescenta uma interface IXpsOMShareable junto com sua chave até o final do dicionário.

Sintaxe

HRESULT Append(
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Parâmetros

[in] key

A chave a ser usada para essa entrada.

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

[in] entry

Um ponteiro para a interface IXpsOMShareable que deve ser acrescentada ao dicionário.

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.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
XPS_E_NO_CUSTOM_OBJECTS	A entrada não aponta para uma implementação de interface reconhecida. Não há suporte para a implementação personalizada de interfaces de API de Documento XPS.

Comentários

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 IXpsOMShareable::GetType .

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

Uma figura que mostra como Append adiciona uma entrada ao dicionário

Requisitos


Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	xpsobjectmodel.h