WRL и BindableAttribute

в 15:24, , рубрики: c++, MIDL, windows runtime, WRL, разработка под windows, разработка под windows phone

Основным паттерном при разработке UI приложений для Windows Runtime является MVVM. В документации говорится, что объектом привязки может быть объект CLR, объект пользовательского интерфейса, объект среды выполнения Windows Runtime(если у него есть атрибут BindableAttribute или если он реализует ICustomPropertyProvider).
Наиболее простым сценарием при разработке приложений является добавление атрибута BindableAttribute к классу ViewModel и реализация интерфейса INotifyPropertyChanged. Если интересно, как это сделать с помощью MIDL, C++ и WRL, то добро пожаловать под кат.

Описание интерфейсов

Создадим idl файл и опишем интерфейсы.

import "inspectable.idl";
import "windows.ui.xaml.customattributes.idl";
import "windows.ui.xaml.data.idl";

#define VERSION 0x00000001

namespace DataBinding
{
	interface INumber;
	
	interface INumberFactory;

	runtimeclass Number;
}

namespace DataBinding
{
	[exclusiveto(Number)]
	[uuid(5b197688-2f57-4d01-92cd-a888f10dcd90)]
	[version(VERSION)]
	interface INumber : IInspectable
	{
		[propget]
		HRESULT Value([out, retval] INT32* value);

		[propput]
		HRESULT Value([in] INT32 value);
	}
	
	[exclusiveto(Number)]
	[uuid(baec017b-23ec-46d3-8d67-78bf0af1a9f1)]
	[version(VERSION)]
	interface INumberFactory : IInspectable
	{
	};

	[activatable(1.0)]
	[bindable]
	[marshaling_behavior(agile)]
	[threading(both)]
	[version(VERSION)]
	runtimeclass Number
	{
		[default] interface INumber;
		interface Windows.UI.Xaml.Data.INotifyPropertyChanged;
	}
}

В пространстве имен DataBinding мы определяем несколько объектов. Первый — это эксклюзивный интерфейс для класса. Данный интерфейс имеет единственное целочисленное свойство Value, доступное для чтения и записи. Второй — это интерфейс фабрики для создания объекта класса. Третий- это класс объекта, который реализует два интерфейса. Атрибут activatable класса Number указывают, что объект данного класса может быть создан без передачи параметров фабрике. Атрибут bindable — это как раз тот самый BindableAttribute, который необходим для работы механизма привязки данных. Описание данного атрибута содержится в файле «windows.ui.xaml.customattributes.idl», поэтому данный файл импортируется во второй строчке кода. Скомпилировав файл, получим заголовочный файл, который потом необходимо будет подключить в нашем файле с кодом.

Реализация интерфейсов

Большую часть работы по описанию интерфейсов за нас выполняет MIDL компилятор при создании заголовочного файла, а использование WRL упрощает реализацию заданных интерфейсов за счёт определения макросов и шаблонных классов. Допустимый код может выглядеть так:

#include <wrl.h>
#include <wrl/wrappers/corewrappers.h>
#include <wrl/event.h>
#include "DataBinding_h.h"

using ABI::DataBinding::INumber;
using ABI::DataBinding::INumberFactory;
using ABI::Windows::UI::Xaml::Data::IPropertyChangedEventArgsFactory;
using ABI::Windows::UI::Xaml::Data::INotifyPropertyChanged;
using ABI::Windows::UI::Xaml::Data::IPropertyChangedEventHandler;
using ABI::Windows::UI::Xaml::Data::IPropertyChangedEventArgs;
using ABI::Windows::UI::Xaml::Data::PropertyChangedEventArgs;
using Microsoft::WRL::RuntimeClassFlags;
using Microsoft::WRL::RuntimeClassType;
using Microsoft::WRL::EventSource;
using Microsoft::WRL::Make;
using Microsoft::WRL::RuntimeClass;
using Microsoft::WRL::ActivationFactory;
using Microsoft::WRL::ComPtr;
using Microsoft::WRL::Wrappers::HStringReference;

class Number sealed : public RuntimeClass < RuntimeClassFlags<RuntimeClassType::WinRt>, INumber, INotifyPropertyChanged >
{
	InspectableClass(RuntimeClass_DataBinding_Number, BaseTrust);
private:
	INT32 _value;
	EventSource<IPropertyChangedEventHandler> _notifyEventSource;
	ComPtr<IPropertyChangedEventArgs> _valueChangedEventArgs;
public:

	Number()
		: _value(0)
	{
		ComPtr<IPropertyChangedEventArgsFactory> propertyChangedEventArgsFactory;
		RoGetActivationFactory(
			HStringReference(RuntimeClass_Windows_UI_Xaml_Data_PropertyChangedEventArgs).Get(),
			ABI::Windows::UI::Xaml::Data::IID_IPropertyChangedEventArgsFactory,
			reinterpret_cast<void**>(propertyChangedEventArgsFactory.GetAddressOf()));

		ComPtr<IInspectable> inner;
		propertyChangedEventArgsFactory->CreateInstance(
			HStringReference(L"Value").Get(),
			nullptr,
			reinterpret_cast<IInspectable**>(_valueChangedEventArgs.GetAddressOf()),
			_valueChangedEventArgs.GetAddressOf());
	}

	virtual HRESULT STDMETHODCALLTYPE get_Value(INT32* value) override
	{
		*value = _value;
		return S_OK;
	}

	virtual HRESULT STDMETHODCALLTYPE put_Value(INT32 value) override
	{
		_value = value;
		_notifyEventSource.InvokeAll(reinterpret_cast<IInspectable*>(this), _valueChangedEventArgs.Get());
		return S_OK;
	}

	virtual HRESULT STDMETHODCALLTYPE add_PropertyChanged(IPropertyChangedEventHandler* handler, EventRegistrationToken* token) override
	{
		return _notifyEventSource.Add(handler, token);
	}

	virtual HRESULT STDMETHODCALLTYPE remove_PropertyChanged(EventRegistrationToken token) override
	{
		return _notifyEventSource.Remove(token);
	}
};

class NumberFactory : public ActivationFactory < INumberFactory >
{
	InspectableClassStatic(RuntimeClass_DataBinding_Number, BaseTrust);

public:

	virtual HRESULT STDMETHODCALLTYPE ActivateInstance(IInspectable** instance) override
	{
		*instance = reinterpret_cast<IInspectable*>(Make<Number>().Detach());
		return nullptr != *instance ? S_OK : E_OUTOFMEMORY;
	}
};

ActivatableClassWithFactory(Number, NumberFactory);

Данный код определяет два класса. Первый — тот самый runtime class Number. Реализует интерфейсы INumber и INotifyPropertyChanged, переопределяя pure virtual методы интерфейсов. Второй — класс фабрики, для создания объектов класса Number. Для успешной компиляции кода необходимо существования заголовочного файла «windows.ui.xaml.customattributes.h», так как директива его включения автоматически вставляется MIDL компилятором в подключаемый заголовочный файл(но можно и вручную удалить эту директиву из кода h-файла). Я его создал в директории $(WindowsSDK_MetadataPath).

Проверка

Скомпилировав код компонента, можно его использовать в любом проекте для Windows Runtime. Я тестировал в C# проекте. Создал простое представление, отображающие значение свойства Value объекта с помощью DataBinding, и изменил значение свойства объекта по таймеру(3 секунды, чтобы элемент успел отобразиться с начальным значением свойства).

Автор: altk

Источник

* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js