.. index:: pair: class; EE::UI::Models::ObservableListModel
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model:

template class EE::UI::Models::ObservableListModel
==================================================

.. toctree::
	:hidden:

Overview
~~~~~~~~

One-column model adapter for an :ref:`ObservableVector <doxid-class_e_e_1_1_observable_vector>`. :ref:`More...<details-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	#include <observablelistmodel.hpp>
	
	template <typename T>
	class ObservableListModel: public :ref:`EE::UI::Models::Model<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model>` {
	public:
		// typedefs
	
		typedef std::function<:ref:`Variant<doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>`(const T&, :ref:`ModelRole<doxid-namespace_e_e_1_1_u_i_1_1_models_1a2742d6c7b5e2769c1af78e9200883529>`)> :ref:`Formatter<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a3e161f014d54e6afa865fea618bf6384>`;
		typedef std::function<bool(const T&)> :ref:`Predicate<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a8dd3e764f532e406287709cbf8b2a2b4>`;

		// construction
	
		:ref:`ObservableListModel<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a04b8ad877618c3c37fdfe0bbb2c5fe19>`(:ref:`ObservableVector<doxid-class_e_e_1_1_observable_vector>`<T>& source, :ref:`Formatter<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a3e161f014d54e6afa865fea618bf6384>` formatter = {});
		:target:`~ObservableListModel<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a474e54d79bdcc5378f14b9f263908c8d>`();

		// methods
	
		static std::shared_ptr<ObservableListModel> :ref:`create<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1ab8c344590492b831475e78b430f7b16e>`(:ref:`ObservableVector<doxid-class_e_e_1_1_observable_vector>`<T>& source);
		static std::shared_ptr<ObservableListModel> :ref:`create<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aa2f3c60b5e75fab7c23db52fd4467426>`(:ref:`ObservableVector<doxid-class_e_e_1_1_observable_vector>`<T>& source, :ref:`Formatter<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a3e161f014d54e6afa865fea618bf6384>` formatter);
		virtual size_t :ref:`rowCount<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a204044875261e1537859e8f9368890f5>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const;
		virtual size_t :ref:`columnCount<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1af817ad935ceaf460e7c7c4d5a854cbc2>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const;
		virtual :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` :ref:`index<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aa5c472f781face45990dbaa144fcb893>`(int row, int column = 0, const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& parent = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const;
		virtual :ref:`Variant<doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>` :ref:`data<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aaef7bc6988921afaa781e5f08b974568>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& index, :ref:`ModelRole<doxid-namespace_e_e_1_1_u_i_1_1_models_1a2742d6c7b5e2769c1af78e9200883529>` role = :ref:`ModelRole::Display<doxid-namespace_e_e_1_1_u_i_1_1_models_1a2742d6c7b5e2769c1af78e9200883529ab9987a246a537f4fe86f1f2e3d10dbdb>`) const;
		void :ref:`setFilter<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a784286e3caae69e1d425d966bf1a3b33>`(:ref:`Predicate<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a8dd3e764f532e406287709cbf8b2a2b4>` predicate);
		void :ref:`clearFilter<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aaeda3d3e07bf73f6edf832bec821c298>`();
		std::optional<std::size_t> :ref:`sourceRow<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1acf17f4742f202d3e2c2c7ca2f7e7bd65>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& index) const;
		const T* :ref:`at<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aa4143a36be897ba4f2ca2d43f30ff415>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& index) const;
	};

Inherited Members
-----------------

.. ref-code-block:: cpp
	:class: doxyrest-overview-inherited-code-block

	public:
		// typedefs
	
		typedef std::function<:ref:`Variant<doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`&, const void*:ref:`data<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ab7713f9e61cad28e48a7ec9fa086401c>`)> :ref:`ModelStyler<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a5e25ec1fb8e3c6faf95e0b10414d306e>`;

		// enums
	
		enum :ref:`UpdateFlag<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1abbfe01bee639f7b18467d7dfba3f2254>`;

		// structs
	
		struct :ref:`Operation<doxid-struct_e_e_1_1_u_i_1_1_models_1_1_model_1_1_operation>`;

		// classes
	
		class :ref:`Client<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1_1_client>`;

		// methods
	
		virtual bool :ref:`hasChildren<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a477142066137b61e23c91447bbcafd4b>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& modelIndex = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const;
		virtual size_t :ref:`rowCount<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1aaf6201dc8fe80da9d1bfb3d0524eb096>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const = 0;
		virtual size_t :ref:`columnCount<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ae2ab889c682684e28e37ea2395576c70>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const = 0;
		virtual std::string :ref:`columnName<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ac8727d7e7c88a48e98687be18a8969e4>`(const size_t&) const;
		virtual std::string :ref:`rowName<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a855e03cc6875b476c84ecb944eb52394>`(const size_t&) const;
		virtual :ref:`Variant<doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>` :ref:`data<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ab7713f9e61cad28e48a7ec9fa086401c>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`&, :ref:`ModelRole<doxid-namespace_e_e_1_1_u_i_1_1_models_1a2742d6c7b5e2769c1af78e9200883529>` = :ref:`ModelRole::Display<doxid-namespace_e_e_1_1_u_i_1_1_models_1a2742d6c7b5e2769c1af78e9200883529ab9987a246a537f4fe86f1f2e3d10dbdb>`) const = 0;
		virtual void :ref:`update<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ae273e3ac1980aadd46fbb573198ec8b9>`();
		virtual :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` :ref:`parentIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a08586eaf0a08704878274ac079e93c8c>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`&) const;
		virtual :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` :ref:`index<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a0b854860cf6b6b02ec411335ac488471>`(int row, int column = 0, const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const;
		virtual :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` :ref:`sibling<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a06cd3398c41ea10971fc574baac7812f>`(int row, int column, const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& parent) const;
		virtual void :ref:`setData<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a3e494a0cd87f9003c7b50b83ba56d50d>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`&, const :ref:`Variant<doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>`&);
		virtual size_t :ref:`treeColumn<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a142f566b38464e098802f7f8f0536232>`() const;
		virtual bool :ref:`acceptsDrag<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a6bf70761cb92342e6e72fc4c6e2eab84>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`&, const std::string& dataType);
		virtual bool :ref:`isColumnSortable<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a5e2a4adf0399d48fb30160ddfe07b1ff>`(const size_t&) const;
		virtual std::string :ref:`dragDataType<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a7ff5cabbb81769f52373799c9a615b82>`() const;
		virtual bool :ref:`isEditable<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a6d962f187a05e2953f725566cfe2b768>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`&) const;
		virtual bool :ref:`isValid<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a16d4ef81488e933fbce118f2951400de>`(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& index) const;
		virtual int :ref:`keyColumn<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ab7ff9c50797fe5c844bd75a2d733cadb>`() const;
		virtual :ref:`SortOrder<doxid-namespace_e_e_1_1_u_i_1_1_models_1a477e7aca7d5b86041f8266ffa84d303f>` :ref:`sortOrder<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a7bf576dfec6468e778f7d0372454acc3>`() const;
		virtual bool :ref:`isSortable<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a020e255fc889743d918b45f0735bc306>`();
		virtual void :ref:`sort<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1afd536b2c987dfccb0519b7b9484b3210>`(const size_t&, const :ref:`SortOrder<doxid-namespace_e_e_1_1_u_i_1_1_models_1a477e7aca7d5b86041f8266ffa84d303f>`&);
		virtual bool :ref:`classModelRoleEnabled<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a7b0b30c2313126ae9668ecfe978e8aaa>`();
		virtual bool :ref:`tooltipModelRoleEnabled<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a0995ec55dfc238e713571eabd78c3939>`();
		void :ref:`registerView<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a049dd72e112e0c3dc80b4aa807ca58c7>`(:ref:`UIAbstractView<doxid-class_e_e_1_1_u_i_1_1_abstract_1_1_u_i_abstract_view>`*);
		void :ref:`unregisterView<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a02e311cc0841532158d30e3d586f0951>`(:ref:`UIAbstractView<doxid-class_e_e_1_1_u_i_1_1_abstract_1_1_u_i_abstract_view>`*);
		void :ref:`registerClient<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a6936554c42ec04443f56da2be4dd44f7>`(:ref:`Client<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1_1_client>`*);
		void :ref:`unregisterClient<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a2255caf2c6bb2b82d923c45f4acd8d48>`(:ref:`Client<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1_1_client>`*);
		void :ref:`refreshView<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a7fb7f05643208c3ed277545da2aff9bc>`() const;
		void :ref:`setOnUpdate<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a15433ecfa6f66bda5c5f323c3758d170>`(const std::function<void()>& onUpdate);
		virtual void :ref:`invalidate<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a128f8d3162885db64163ee9c015089d8>`(unsigned int flags = Model::UpdateFlag::InvalidateAllIndexes);
		std::weak_ptr<:ref:`PersistentHandle<doxid-class_e_e_1_1_u_i_1_1_models_1_1_persistent_handle>`> :ref:`registerPersistentIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ae0dc096fd85542f1b4139ee1a3c67245>`(:ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const&);
		void :ref:`beginInsertRows<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1aecd016af644630e90e36b786ef7127a8>`(:ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const& parent, int first, int last);
		void :ref:`beginInsertColumns<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a9c6375df6840a66bd5fa027f236e5b02>`(:ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const& parent, int first, int last);
		void :ref:`beginMoveRows<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a1fe50c5e9ae899234118c85f473f0d76>`(:ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const& sourceParent, int first, int last, :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const& targetParent, int target_index);
		void :ref:`beginMoveColumns<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1abf27e189143864467ed5e9c8dab3f07b>`(:ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const& sourceParent, int first, int last, :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const& targetParent, int target_index);
		bool :ref:`beginDeleteRows<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ade2db874df9544e956abef81c3a5789d>`(:ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const& parent, int first, int last);
		bool :ref:`beginDeleteRows<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ac404b1401fd57e94e81f027f775f3132>`(:ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const& index);
		bool :ref:`beginDeleteColumns<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1aea66b68bd82959e2460aa52f164552c8>`(:ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` const& parent, int first, int last);
		void :ref:`endInsertRows<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ac7bb7a1416d1d4606984362f1c1f9249>`();
		void :ref:`endInsertColumns<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1aeee01dd992b40a9379fa81289bc85dfd>`();
		void :ref:`endMoveRows<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a45fd0d47011a5ebcae98f7d6de95ceba>`();
		void :ref:`endMoveColumns<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1aac0f22337ed56ba5d40ee29cab7d9b62>`();
		void :ref:`endDeleteRows<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a595bf86f87ec09922e7160b2e6a11bfe>`();
		void :ref:`endDeleteColumns<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1aa43d177f17d23d9ba541d763c9197aa6>`();
		:ref:`Mutex<doxid-class_e_e_1_1_system_1_1_mutex>`& :ref:`resourceMutex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1af6c045b1b944f20c4c6d5cf11ce4bd66>`();
		void :ref:`acquireResourceMutex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ac45c4306811df3999ec62e4e633932c4>`();
		void :ref:`releaseResourceMutex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a42701a9c31d9726b3ad50a5c8f4f0acb>`();
		:ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>` :ref:`subscribeModelStyler<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ac6dc975f0aedaec3f18cd75a32176a31>`(const :ref:`ModelStyler<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1a5e25ec1fb8e3c6faf95e0b10414d306e>`& styler);
		void :ref:`unsubscribeModelStyler<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_1ab9eaa2741dce2682977868bb092d6e17>`(:ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>` id);

.. _details-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

One-column model adapter for an :ref:`ObservableVector <doxid-class_e_e_1_1_observable_vector>`.

Unfiltered sources preserve incremental model notifications. A filtered projection rebuilds its row mapping when source membership can change. Custom formatters allow domain types to remain independent from :ref:`Variant <doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>`. The model retains the source storage, so it remains safe when a view outlives the :ref:`ObservableVector <doxid-class_e_e_1_1_observable_vector>` wrapper. Mutations naturally stop when that wrapper is destroyed.

Filtering changes model row numbers. Use :ref:`sourceRow() <doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1acf17f4742f202d3e2c2c7ca2f7e7bd65>` or :ref:`at() <doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aa4143a36be897ba4f2ca2d43f30ff415>` before mutating the source from a selection in the filtered view.

.. ref-code-block:: cpp

	ObservableVector<Person> people;
	auto model = ObservableListModel<Person>::create(
	    people, []( const Person& person, ModelRole role ) {
	        return role == ModelRole::Display ? Variant( person.name ) : Variant{};
	    } );
	model->setFilter( []( const Person& person ) { return person.active; } );

Typedefs
--------

.. index:: pair: typedef; Formatter
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a3e161f014d54e6afa865fea618bf6384:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	typedef std::function<:ref:`Variant<doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>`(const T&, :ref:`ModelRole<doxid-namespace_e_e_1_1_u_i_1_1_models_1a2742d6c7b5e2769c1af78e9200883529>`)> Formatter

Converts one source item and role into model data.

.. index:: pair: typedef; Predicate
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a8dd3e764f532e406287709cbf8b2a2b4:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	typedef std::function<bool(const T&)> Predicate

Returns true when a source item belongs in the visible projection.

Construction
------------

.. index:: pair: function; ObservableListModel
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a04b8ad877618c3c37fdfe0bbb2c5fe19:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	ObservableListModel(:ref:`ObservableVector<doxid-class_e_e_1_1_observable_vector>`<T>& source, :ref:`Formatter<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a3e161f014d54e6afa865fea618bf6384>` formatter = {})

Creates an adapter over ``source``, optionally using ``formatter`` for all roles.

The source storage is retained for the model's lifetime.

Methods
-------

.. index:: pair: function; create
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1ab8c344590492b831475e78b430f7b16e:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	static std::shared_ptr<ObservableListModel> create(:ref:`ObservableVector<doxid-class_e_e_1_1_observable_vector>`<T>& source)

Creates a one-column adapter using :ref:`Variant <doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>` 's standard conversion for Display data.

.. index:: pair: function; create
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aa2f3c60b5e75fab7c23db52fd4467426:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	static std::shared_ptr<ObservableListModel> create(:ref:`ObservableVector<doxid-class_e_e_1_1_observable_vector>`<T>& source, :ref:`Formatter<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a3e161f014d54e6afa865fea618bf6384>` formatter)

Creates a one-column adapter whose :ref:`data() <doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aaef7bc6988921afaa781e5f08b974568>` is supplied by ``formatter``.

.. index:: pair: function; rowCount
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a204044875261e1537859e8f9368890f5:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	virtual size_t rowCount(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const



.. rubric:: Returns:

The number of visible rows in the current projection.

.. index:: pair: function; columnCount
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1af817ad935ceaf460e7c7c4d5a854cbc2:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	virtual size_t columnCount(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const



.. rubric:: Returns:

One; :ref:`ObservableListModel <doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model>` is a flat, one-column model.

.. index:: pair: function; index
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aa5c472f781face45990dbaa144fcb893:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	virtual :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>` index(int row, int column = 0, const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& parent = :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`()) const



.. rubric:: Returns:

A valid index for a visible row in column zero, or an invalid index.

.. index:: pair: function; data
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aaef7bc6988921afaa781e5f08b974568:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	virtual :ref:`Variant<doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>` data(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& index, :ref:`ModelRole<doxid-namespace_e_e_1_1_u_i_1_1_models_1a2742d6c7b5e2769c1af78e9200883529>` role = :ref:`ModelRole::Display<doxid-namespace_e_e_1_1_u_i_1_1_models_1a2742d6c7b5e2769c1af78e9200883529ab9987a246a537f4fe86f1f2e3d10dbdb>`) const



.. rubric:: Returns:

Formatted data for ``index`` and ``role``, or an empty :ref:`Variant <doxid-class_e_e_1_1_u_i_1_1_models_1_1_variant>` when unavailable.

.. index:: pair: function; setFilter
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a784286e3caae69e1d425d966bf1a3b33:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void setFilter(:ref:`Predicate<doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1a8dd3e764f532e406287709cbf8b2a2b4>` predicate)

Replaces the visible filter and invalidates all model indexes.

An empty predicate is equivalent to no filter. While filtered, source mutations rebuild the projection and invalidate indexes instead of emitting incremental row notifications.

.. index:: pair: function; clearFilter
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aaeda3d3e07bf73f6edf832bec821c298:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void clearFilter()

Removes the active filter and exposes all source rows.

.. index:: pair: function; sourceRow
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1acf17f4742f202d3e2c2c7ca2f7e7bd65:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	std::optional<std::size_t> sourceRow(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& index) const



.. rubric:: Returns:

The :ref:`ObservableVector <doxid-class_e_e_1_1_observable_vector>` row represented by ``index``, or std::nullopt for an invalid or foreign index.

.. index:: pair: function; at
.. _doxid-class_e_e_1_1_u_i_1_1_models_1_1_observable_list_model_1aa4143a36be897ba4f2ca2d43f30ff415:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	const T* at(const :ref:`ModelIndex<doxid-class_e_e_1_1_u_i_1_1_models_1_1_model_index>`& index) const

.. warning::

	The pointer is invalidated by mutations that reallocate or remove vector elements.



.. rubric:: Returns:

The source item represented by ``index``, or nullptr for an invalid or foreign index.