Trabalhando com interfaces de coleção de OM XPS

Artigo
05/12/2022
2 minutos para o fim da leitura

Descreve como usar os métodos comuns das interfaces de coleção.

Sumário

Os métodos descritos nesta seção são mostrados na lista a seguir. Nem todas as interfaces de coleção dão suporte a cada um desses métodos, e algumas interfaces também dão suporte a métodos que não são descritos nesta página. Para obter a lista de métodos compatíveis com uma interface específica, consulte a descrição da descrição dessa interface.

Método Append
Método GetAt
Método GetCount
Método InsertAt
Método RemoveAt
Método SetAt

Consulte também

Método Append

Acrescenta um objeto ao final da coleção.

Sintaxe genérica

HRESULT Append(
  [in]  Object *object
);

Descrição

Ao final da coleção, esse método acrescenta um objeto que é passado na lista de parâmetros, conforme mostrado no diagrama a seguir.

a figure that shows how append adds an entry to the collection

Método GetAt

Obtém um objeto de um local especificado na coleção.

Sintaxe genérica

HRESULT GetAt(
  [in]           UINT32 index,
  [out, retval]  Object **object
);

Descrição

Grava o objeto armazenado no local da coleção especificado pelo índice na variável referenciada por objeto. Essa ação não altera o conteúdo da coleção. O diagrama a seguir ilustra esse processo.

a figure that shows how getat retrieves an entry from the collection

Método GetCount

Obtém o número de objetos armazenados na coleção.

Sintaxe genérica

HRESULT GetCount(
  [out, retval]  UINT32 *count
);

Descrição

Grava o número de objetos armazenados atualmente na coleção na variável referenciada por contagem. Essa ação não altera o conteúdo da coleção. O diagrama a seguir ilustra esse processo.

a figure that shows how getcount gets the number of entries in the collection

Método InsertAt

Insere um objeto em um local especificado da coleção.

Sintaxe genérica

HRESULT InsertAt(
  [in]  UINT32 index,
  [in]  Object *object
);

Descrição

O objeto que é passado no objeto é inserido na coleção no local especificado pelo índice. Antes de inserir o novo objeto, esse método move por 1 o objeto que anteriormente ocupou o local no índice e move todos os ponteiros de interface subsequentes ao índice. O diagrama a seguir ilustra esse processo.

a figure that shows how insertat adds an entry to the collection

Método RemoveAt

Remove o objeto de um local especificado na coleção.

Sintaxe genérica

HRESULT RemoveAt(
  [in]  UINT32 index
);

Descrição

Esse método libera o objeto do local especificado pelo índice e compacta a coleção reduzindo em 1 o índice de cada ponteiro subsequente ao índice. O diagrama a seguir ilustra esse processo.

a figure that shows how removeat removes an entry from the collection

Método SetAt

Substitui o objeto em um local especificado na coleção.

Sintaxe genérica

HRESULT SetAt(
  [in]  UINT32 index,
  [in]  Object *object
);

Descrição

Esse método primeiro libera o objeto no local referenciado pelo índice e, em seguida, substitui esse objeto pelo que é passado no objeto. O diagrama a seguir ilustra esse processo.

a figure that shows how setat replaces an entry in the collection

Consulte Também