Partager via


winrt::observable_vector_base modèle de struct (C++/WinRT)

Classe de base à partir de laquelle vous pouvez dériver pour implémenter votre propre vecteur observable personnalisé. Pour plus d’informations et des exemples de code, consultez Collections avec C++/WinRT.

Syntax

template <typename D, typename T>
struct observable_vector_base : vector_base<D, T>

Paramètres de modèle

typename D Nom de votre type dérivé.

typename T Type des éléments dans le observable_vector_base.

Spécifications

Kit de développement logiciel (SDK) pris en charge minimum : Windows SDK version 10.0.0.17763.0 (Windows 10, version 1809)

Espace de noms : winrt

En-tête : %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (inclus par défaut)

Fonctions Membre

Fonction Description
observable_vector_base::Append, fonction Ajoute un élément à la fin de l’objet observable_vector_base .
observable_vector_base::Clear, fonction Supprime tous les éléments de l’objet observable_vector_base .
observable_vector_base::First, fonction Récupère un IIterator représentant le premier élément de l’objet observable_vector_base .
observable_vector_base::GetAt, fonction Récupère l’élément à l’index spécifié dans l’objet observable_vector_base .
observable_vector_base::GetMany, fonction Récupère une collection d’éléments dans l’objet observable_vector_base commençant à l’index donné.
observable_vector_base::GetView, fonction Récupère une vue immuable de l’objet observable_vector_base .
observable_vector_base::IndexOf, fonction Récupère l’index d’un élément spécifié dans l’objet observable_vector_base .
observable_vector_base::InsertAt, fonction Insère un élément à l’index spécifié dans l’objet observable_vector_base .
observable_vector_base::RemoveAt, fonction Supprime l’élément à l’index spécifié dans l’objet observable_vector_base .
observable_vector_base::RemoveAtEnd, fonction Supprime le dernier élément de l’objet observable_vector_base .
observable_vector_base::ReplaceAll, fonction Remplace tous les éléments de l’objet observable_vector_base par les éléments spécifiés.
observable_vector_base::SetAt, fonction Définit la valeur de l’élément à l’index spécifié dans l’objet observable_vector_base .
observable_vector_base::Size, fonction Récupère le nombre d’éléments de l’objet observable_vector_base .
observable_vector_base::VectorChanged, fonction Inscrit et révoque un délégué qui gère l’événement de modification vectorielle de l’objet observable_vector_base .

Iterators

Un observable_vector_base est une plage et cette plage est définie par des fonctions libres internes (chacune d’elles récupère un itérateur) compatibles avec les fonctionnalités de langage standard. En raison de cela, vous pouvez énumérer les éléments d’un objet observable_vector_base avec une instruction basée sur for une plage.

Vous pouvez également récupérer un IIterator à partir de la fonction observable_vector_base::First et l’utiliser pour itérer dans les éléments d’un objet observable_vector_base .

...
#include <iostream>
using namespace winrt;
using namespace Windows::Foundation::Collections;
...
struct MyObservableVector :
    implements<MyObservableVector, IObservableVector<float>, IVector<float>, IVectorView<float>, IIterable<float>>,
    winrt::observable_vector_base<MyObservableVector, float>
{
    auto& get_container() const noexcept
    {
        return m_values;
    }

    auto& get_container() noexcept
    {
        return m_values;
    }

private:
    std::vector<float> m_values{ 0.1f, 0.2f, 0.3f };
};
...
IObservableVector<float> coll{ winrt::make<MyObservableVector>() };

for (auto const& el : coll)
{
    std::wcout << el << std::endl;
}

IIterator<float> it{ coll.First() };
while (it.HasCurrent())
{
    std::wcout << it.Current() << std::endl;
    it.MoveNext();
}

observable_vector_base::Append, fonction

Ajoute un élément à la fin de l’objet observable_vector_base .

Syntaxe

void Append(T const& value);

Paramètres

value Élément à ajouter.

observable_vector_base::Clear, fonction

Supprime tous les éléments de l’objet observable_vector_base .

Syntax

void Clear() noexcept;

observable_vector_base::First, fonction

Récupère un IIterator représentant le premier élément de l’objet observable_vector_base .

Syntaxe

auto First();

Valeur de retour

IIterator représentant le premier élément de l’objet observable_vector_base.

observable_vector_base::GetAt, fonction

Récupère l’élément à l’index spécifié dans l’objet observable_vector_base .

Syntaxe

T GetAt(uint32_t const index) const;

Paramètres

index Index d’élément de base zéro.

Valeur retournée

Élément à l’index spécifié dans l’objet observable_vector_base .

observable_vector_base::GetMany, fonction

Récupère une collection d’éléments dans l’objet observable_vector_base commençant à l’index donné.

Syntaxe

uint32_t GetMany(uint32_t const startIndex, array_view<T> values) const;

Paramètres

startIndex Index d’élément de base zéro à démarrer.

values Un array_view pour copier les éléments dans.

Valeur retournée

Valeur représentant le nombre d’éléments récupérés.

observable_vector_base::GetView, fonction

Récupère une vue immuable de l’objet observable_vector_base .

Syntaxe

winrt::Windows::Foundation::Collections::IVectorView<T> GetView() const noexcept;

Valeur de retour

IVectorView contenant une vue immuable du observable_vector_base.

observable_vector_base::IndexOf, fonction

Récupère l’index d’un élément spécifié dans l’objet observable_vector_base .

Syntaxe

bool IndexOf(T const& value, uint32_t& index) const noexcept;

Paramètres

value Élément, dans l’objet observable_vector_base , à rechercher.

index Index de base zéro de l’élément si l’élément est trouvé, sinon le nombre d’éléments dans l’objet observable_vector_base .

Valeur retournée

true si l’élément est trouvé, sinon false.

observable_vector_base::InsertAt, fonction

Insère un élément à l’index spécifié dans l’objet observable_vector_base .

Syntaxe

void InsertAt(uint32_t const index, T const& value);

Paramètres

index Index de base zéro auquel insérer l’élément.

value Élément à insérer.

observable_vector_base::RemoveAt, fonction

Supprime l’élément à l’index spécifié dans l’objet observable_vector_base .

Syntaxe

void RemoveAt(uint32_t const index);

Paramètres

index Index de base zéro de l’élément à supprimer.

fonction observable_vector_base::RemoveAtEnd

Supprime le dernier élément de l’objet observable_vector_base .

Syntax

void RemoveAtEnd();

fonction observable_vector_base::ReplaceAll

Remplace tous les éléments de l’objet observable_vector_base par les éléments spécifiés.

Syntaxe

void ReplaceAll(array_view<T const> value);

Paramètres

value Un array_view contenant les nouveaux éléments.

fonction observable_vector_base::SetAt

Définit la valeur de l’élément à l’index spécifié dans l’objet observable_vector_base .

Syntaxe

void SetAt(uint32_t const index, T const& value);

Paramètres

index Index de base zéro de l’élément dont la valeur doit être définie.

value Valeur de l’élément à définir.

fonction observable_vector_base::Size

Récupère le nombre d’éléments dans l’objet observable_vector_base .

Syntaxe

uint32_t Size() const noexcept;

Valeur de retour

Valeur représentant le nombre d’éléments dans l’objet observable_vector_base .

fonction observable_vector_base::VectorChanged

Inscrit et/ou révoque un délégué qui gère l’événement de modification vectorielle de l’objet observable_vector_base .

Syntaxe

// Register
winrt::event_token VectorChanged(winrt::Windows::Foundation::Collections::VectorChangedEventHandler<T> const& handler);

// Revoke with event_token
void VectorChanged(winrt::event_token const cookie);

// Revoke with event_revoker
VectorChanged_revoker VectorChanged(winrt::auto_revoke_t, winrt::Windows::Foundation::Collections::VectorChangedEventHandler<T> const& handler) const;

Valeur de retour

Soitvoid, un winrt::event_token avec lequel vous pouvez révoquer un délégué inscrit, soit un VectorChanged_revoker (alias de type pour un winrt::event_revoker< IObservableVectorT<>>) avec lequel vous pouvez révoquer un délégué inscrit.

Exemple

winrt::event_revoker<IObservableVector<float>> m_event_revoker;
...
m_event_revoker = coll.VectorChanged(winrt::auto_revoke, [this](IObservableVector<float> const&, IVectorChangedEventArgs const&)
{
    ...
});

Voir aussi