.. index:: pair: class; EE::UI::UIReadOnlyValueBinding
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding:

template class EE::UI::UIReadOnlyValueBinding
=============================================

.. toctree::
	:hidden:

	struct_EE_UI_UIReadOnlyValueBinding_State.rst

Overview
~~~~~~~~

Move-only one-way binding from a read-only observable to a widget property. :ref:`More...<details-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding>`


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

	#include <uivaluebinding.hpp>
	
	template <typename T>
	class UIReadOnlyValueBinding {
	public:
		// typedefs
	
		typedef :ref:`UIValueConverter<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter>`<T> :target:`Converter<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a70e3667900bd4711d44bc7b638c936ef>`;

		// structs
	
		struct :ref:`State<doxid-struct_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1_1_state>`;

		// construction
	
		:target:`UIReadOnlyValueBinding<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a2cb119b7c435d80d0b82ca1e1f6dcba7>`();
		:target:`UIReadOnlyValueBinding<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a22d2ee4b15d76a1ff226a29b886a491f>`(const UIReadOnlyValueBinding&);
		:target:`UIReadOnlyValueBinding<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1aa1f3d209073d147c5733fae1e7d771bb>`(UIReadOnlyValueBinding&&);
	
		template <typename Source>
		:ref:`UIReadOnlyValueBinding<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1ab5f0f30ecaabb197cf957ea0cdcb6b45>`(Source& source, :ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget, const :ref:`Converter<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a70e3667900bd4711d44bc7b638c936ef>`& converter = :ref:`Converter::converterDefault<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1ae9cf163c1ea47968c25b32bf36464304>`(), const std::string& propertyName = "value");

		// methods
	
		UIReadOnlyValueBinding& :target:`operator=<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a04d99737d04cdf61bcc80fb4396a4277>`(const UIReadOnlyValueBinding&);
		UIReadOnlyValueBinding& :target:`operator=<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1ae37d1f1e784d471814737b71545f2df9>`(UIReadOnlyValueBinding&&);
		void :ref:`disconnect<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a534f74508e39486047d316c43e06cb3f>`();
		:ref:`operator bool<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1aff6dfe88b41e85f38920036a45c39a72>`() const;
		bool :ref:`isValid<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1ae755ee369e617dc178667e6e62d4a761>`() const;
		const :ref:`UIValueValidationState<doxid-class_e_e_1_1_u_i_1_1_u_i_value_validation_state>`* :ref:`validationState<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a7359273c480fe4e69bbc11c3f97007f7>`() const;
	};
.. _details-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding:

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

Move-only one-way binding from a read-only observable to a widget property.

Sources must provide ValueType, get(), observe(), and an ObservableValue-compatible Connection. The binding applies the current source value immediately and retains neither endpoint. Use this for :ref:`ComputedValue <doxid-class_e_e_1_1_computed_value>` outputs or whenever widget edits must not update the source.

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

.. index:: pair: function; UIReadOnlyValueBinding
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1ab5f0f30ecaabb197cf957ea0cdcb6b45:

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

	template <typename Source>
	UIReadOnlyValueBinding(Source& source, :ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget, const :ref:`Converter<doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a70e3667900bd4711d44bc7b638c936ef>`& converter = :ref:`Converter::converterDefault<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1ae9cf163c1ea47968c25b32bf36464304>`(), const std::string& propertyName = "value")

Starts one-way synchronization from ``source`` to a property of ``widget``.

Methods
-------

.. index:: pair: function; disconnect
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a534f74508e39486047d316c43e06cb3f:

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

	void disconnect()

Stops synchronization. Calling this repeatedly is safe.

.. index:: pair: function; operator bool
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1aff6dfe88b41e85f38920036a45c39a72:

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

	operator bool() const



.. rubric:: Returns:

Whether the source connection and widget endpoint remain active.

.. index:: pair: function; isValid
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1ae755ee369e617dc178667e6e62d4a761:

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

	bool isValid() const



.. rubric:: Returns:

Whether formatting the most recent source value succeeded.

.. index:: pair: function; validationState
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_read_only_value_binding_1a7359273c480fe4e69bbc11c3f97007f7:

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

	const :ref:`UIValueValidationState<doxid-class_e_e_1_1_u_i_1_1_u_i_value_validation_state>`* validationState() const



.. rubric:: Returns:

Formatting validation state, or nullptr for an empty binding.