다음을 통해 공유

winrt::observable_vector_base 구조체 템플릿(C++/WinRT)

  • 아티클

사용자 지정 관찰 가능한 벡터를 구현하기 위해 파생할 수 있는 기본 클래스입니다. 자세한 정보 및 코드 예제는 C++/WinRT가 있는 컬렉션을 참조하세요.

구문

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

템플릿 매개 변수

typename D 파생 형식 이름입니다.

typename Tobservable_vector_base 요소의 형식입니다.

요구 사항

지원되는 최소 SDK: Windows SDK 버전 10.0.17763.0(Windows 10, 버전 1809)

네임스페이스: winrt

헤더: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h(기본적으로 포함)

멤버 함수

기능 설명
observable_vector_base::Append 함수 observable_vector_base 개체의 끝에 요소를 추가합니다.
observable_vector_base::Clear 함수 observable_vector_base 개체에서 모든 요소를 제거합니다.
observable_vector_base::First 함수 observable_vector_base 개체의 첫 번째 요소를 나타내는 IIterator를 검색합니다.
observable_vector_base::GetAt 함수 observable_vector_base 개체의 지정된 인덱스에서 요소를 검색합니다.
observable_vector_base::GetMany 함수 지정된 인덱스에서 시작하는 observable_vector_base 개체의 요소 컬렉션을 검색합니다.
observable_vector_base::GetView 함수 observable_vector_base 개체의 변경할 수 없는 보기를 검색합니다.
observable_vector_base::IndexOf 함수 observable_vector_base 개체에서 지정된 요소의 인덱스를 검색합니다.
observable_vector_base::InsertAt 함수 observable_vector_base 개체의 지정된 인덱스에 요소를 삽입합니다.
observable_vector_base::RemoveAt 함수 observable_vector_base 개체의 지정된 인덱스에 있는 요소를 제거합니다.
observable_vector_base::RemoveAtEnd 함수 observable_vector_base 개체에서 마지막 요소를 제거합니다.
observable_vector_base::ReplaceAll 함수 observable_vector_base 개체의 모든 요소를 지정된 요소로 바꿉니다.
observable_vector_base::SetAt 함수 observable_vector_base 개체의 지정된 인덱스에서 요소 값을 설정합니다.
observable_vector_base::Size 함수 observable_vector_base 개체의 요소 수를 검색합니다.
observable_vector_base::VectorChanged 함수 observable_vector_base 개체의 벡터 변경 이벤트를 처리하는 대리자를 등록하고 취소합니다.

반복기

observable_vector_base 범위이며 해당 범위는 표준 언어 기능과 호환되는 내부 자유 함수(각각 반복기를 검색)에 의해 정의됩니다. 이 때문에 범위 기반 for 문을 사용하여 observable_vector_base 개체의 요소를 열거할 수 있습니다.

observable_vector_base::First 함수에서 IIterator를 검색하고 이 함수를 사용하여 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 함수

observable_vector_base 개체의 끝에 요소를 추가합니다.

구문

void Append(T const& value);

매개 변수

value 추가할 요소입니다.

observable_vector_base::Clear 함수

observable_vector_base 개체에서 모든 요소를 제거합니다.

구문

void Clear() noexcept;

observable_vector_base::First 함수

observable_vector_base 개체의 첫 번째 요소를 나타내는 IIterator를 검색합니다.

구문

auto First();

반환 값

observable_vector_base 개체의 첫 번째 요소를 나타내는 IIterator입니다.

observable_vector_base::GetAt 함수

observable_vector_base 개체의 지정된 인덱스에서 요소를 검색합니다.

구문

T GetAt(uint32_t const index) const;

매개 변수

index 0부터 시작하는 요소 인덱스입니다.

반환 값

observable_vector_base 개체의 지정된 인덱스 요소입니다.

observable_vector_base::GetMany 함수

지정된 인덱스에서 시작하는 observable_vector_base 개체의 요소 컬렉션을 검색합니다.

구문

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

매개 변수

startIndex 시작할 0부터 시작하는 요소 인덱스입니다.

values 항목을 복사할 array_view .

반환 값

검색된 요소 수를 나타내는 값입니다.

observable_vector_base::GetView 함수

observable_vector_base 개체의 변경할 수 없는 보기를 검색합니다.

구문

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

반환 값

observable_vector_base 변경할 수 없는 보기를 포함하는 IVectorView입니다.

observable_vector_base::IndexOf 함수

observable_vector_base 개체에서 지정된 요소의 인덱스를 검색합니다.

구문

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

매개 변수

value찾을 observable_vector_base 개체의 요소입니다.

index 요소가 발견되면 요소의 인덱스(0부터 시작하는 인덱스)이고, 그렇지 않으면 observable_vector_base 개체의 요소 수입니다.

반환 값

true 요소가 있으면 이고, 그렇지 않으면 false.입니다.

observable_vector_base::InsertAt 함수

observable_vector_base 개체의 지정된 인덱스에 요소를 삽입합니다.

구문

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

매개 변수

index 요소를 삽입할 인덱스(0부터 시작하는 인덱스)입니다.

value 삽입할 요소입니다.

observable_vector_base::RemoveAt 함수

observable_vector_base 개체의 지정된 인덱스에 있는 요소를 제거합니다.

구문

void RemoveAt(uint32_t const index);

매개 변수

index 제거할 요소의 인덱스(0부터 시작하는 인덱스)입니다.

observable_vector_base::RemoveAtEnd 함수

observable_vector_base 개체에서 마지막 요소를 제거합니다.

구문

void RemoveAtEnd();

observable_vector_base::ReplaceAll 함수

observable_vector_base 개체의 모든 요소를 지정된 요소로 바꿉니다.

구문

void ReplaceAll(array_view<T const> value);

매개 변수

value 새 요소가 포함된 array_view .

observable_vector_base::SetAt 함수

observable_vector_base 개체의 지정된 인덱스에서 요소 값을 설정합니다.

구문

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

매개 변수

index 값을 설정할 요소의 인덱스(0부터 시작하는 인덱스)입니다.

value 설정할 요소 값입니다.

observable_vector_base::Size 함수

observable_vector_base 개체의 요소 수를 검색합니다.

구문

uint32_t Size() const noexcept;

반환 값

observable_vector_base 개체의 요소 수를 나타내는 값입니다.

observable_vector_base::VectorChanged 함수

observable_vector_base 개체의 벡터 변경 이벤트를 처리하는 대리자를 등록 및/또는 취소합니다.

구문

// 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;

반환 값

void등록된 대리자를 해지할 수 있는 winrt::event_token 또는 등록된 대리자를 해지할 수 있는 VectorChanged_revoker(winrt::event_revoker< IObservableVectorT<>>의 형식 별칭)입니다.

예제

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

참고 항목