IVector<T> Interface

  • Referência

Definição

Namespace:
Windows.Foundation.Collections
Editar

Representa uma coleção de elementos de acesso aleatório.

.NET Essa interface aparece no código .NET como System.Collections.Generic.IList<T> devido à projeção de linguagem .NET. Em qualquer caso em que um tipo de Windows Runtime implementou o IVector<T>, o código .NET pode usar as APIs de IList<T>.

public interface class IVector : IIterable<T>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
template <typename T>
struct IVector : IIterable<T>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
public interface IList<T> : IEnumerable<T>
Public Interface IList(Of T)
Implements IEnumerable(Of T)

Parâmetros de tipo

T
Atributos
ContractVersionAttribute GuidAttribute
Implementações
IIterable<T> IEnumerable<T>

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (introduzida na v1.0)

Comentários

Ao programar com o .NET, essa interface fica oculta e os desenvolvedores devem usar a interface System.Collections.Generic.IList<T> se quiserem implementar um tipo de vetor/lista. Em qualquer caso em que um tipo de Windows Runtime implementou o IVector<T>, o código .NET pode usar as APIs de IList<T>. Isso inclui todas as API de Windows Runtime existentes e também cenários como o uso de APIs de componentes Windows Runtime originalmente implementados em extensões de componente do Visual C++ (C++/CX) de um aplicativo C# ou Visual Basic.

A interface IVector<T> representa uma coleção de objetos de um tipo especificado que podem ser acessados individualmente pelo índice. Propriedades e métodos do IVector<T> dão suporte à funcionalidade de tipo de lista, como obter o tamanho da coleção e adicionar e remover itens em locais especificados na coleção. Além disso, o método GetView fornece um instantâneo do vetor cujo estado observável não é alterado. O instantâneo é útil quando você precisa de uma exibição da coleção a ser referenciada em operações subsequentes que envolvem IVector<T>.

Funções de extensão C++/WinRT

Observação

Existem funções de extensão nos tipos de projeção C++/WinRT para determinadas APIs Windows Runtime. Por exemplo, winrt::Windows::Foundation::IAsyncAction é o tipo de projeção C++/WinRT para IAsyncAction. As funções de extensão não fazem parte da superfície da ABI (interface binária do aplicativo) dos tipos de Windows Runtime reais, portanto, não são listadas como membros das APIs Windows Runtime. Mas você pode chamá-los de dentro de qualquer projeto C++/WinRT. Confira Funções do C++/WinRT que estendem apIs de Windows Runtime.

auto begin() const;

Retorna um iterador para o primeiro elemento da coleção, para uso em algoritmos C++, como loops baseados em for intervalo.

auto end() const;

Retorna um iterador para um após o último elemento da coleção, para uso em algoritmos C++, como loops baseados em for intervalo.

Herança de interface

IVector herda IIterable. Os tipos que implementam o IVector também implementam os membros da interface IIterable. Da mesma forma, se você estiver usando o .NET, haverá suporte para IEnumerable<T>.

Propriedades

Size

Obtém o número de itens no vetor.

Métodos

Append(T)

Acrescenta um item ao final do vetor.
Clear()

Remove todos os itens do vetor.
GetAt(UInt32)

Retorna o item no índice especificado no vetor.
GetMany(UInt32, T[])

Recupera vários itens do vetor começando no índice fornecido.

C++/WinRT A sintaxe correta para a projeção de linguagem C++/WinRT é uint32_t GetMany(uint32_t startIndex, winrt::array_view<T> items);.
GetView()

Retorna uma exibição imutável do vetor.
IndexOf(T, UInt32)

Recupera o índice de um item especificado no vetor.
InsertAt(UInt32, T)

Insere um item em um índice especificado no vetor.
RemoveAt(UInt32)

Remove o item no índice especificado no vetor.
RemoveAtEnd()

Remove o último item do vetor.
ReplaceAll(T[])

Substitui todos os itens no vetor pelos itens especificados.
SetAt(UInt32, T)

Define o valor no índice especificado no vetor.

Aplica-se a

Confira também