.. index:: pair: struct; EE::UI::UIValueConverter
.. _doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter:

template struct EE::UI::UIValueConverter
========================================

.. toctree::
	:hidden:

Overview
~~~~~~~~

Binding-independent conversion between a typed value and a widget property string. :ref:`More...<details-struct_e_e_1_1_u_i_1_1_u_i_value_converter>`


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

	#include <uivalueconverter.hpp>
	
	template <typename T>
	struct UIValueConverter {
		// typedefs
	
		typedef std::function<:ref:`UIValueResult<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_result>`<T>(const :ref:`CSS::PropertyDefinition<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_property_definition>`*, const std::string&)> :target:`ToValue<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1ab90ee5faa57aa554b7f68b8c40e61045>`;
		typedef std::function<:ref:`UIValueResult<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_result>`<std::string>(const :ref:`CSS::PropertyDefinition<doxid-class_e_e_1_1_u_i_1_1_c_s_s_1_1_property_definition>`*, const T&)> :target:`FromValue<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1a2b79f4c801d5a096184f3e81f192d195>`;

		// fields
	
		:ref:`ToValue<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1ab90ee5faa57aa554b7f68b8c40e61045>` :target:`toValue<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1a690f0ccf6d93b862d2441f7f1e371af4>`;
		:ref:`FromValue<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1a2b79f4c801d5a096184f3e81f192d195>` :target:`fromValue<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1a6c722ac8eae4962c45697b9d55e73796>`;

		// construction
	
		:target:`UIValueConverter<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1a6fc9bb4458c47afc7b259fad1cf146eb>`();
		:target:`UIValueConverter<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1ae7d8af19bdf825213940c23d1ea80cc7>`(:ref:`ToValue<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1ab90ee5faa57aa554b7f68b8c40e61045>` toValue, :ref:`FromValue<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1a2b79f4c801d5a096184f3e81f192d195>` fromValue);

		// methods
	
		static UIValueConverter :target:`converterDefault<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1ae9cf163c1ea47968c25b32bf36464304>`();
		static UIValueConverter :target:`converterString<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1a23424658cf7089b1309078565fcdd82c>`();
		static UIValueConverter :target:`converterBool<doxid-struct_e_e_1_1_u_i_1_1_u_i_value_converter_1af49aa04e6361bf4921f09b80b9607f4e>`();
	};
.. _details-struct_e_e_1_1_u_i_1_1_u_i_value_converter:

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

Binding-independent conversion between a typed value and a widget property string.

:ref:`UIDataBind <doxid-class_e_e_1_1_u_i_1_1_u_i_data_bind>` and :ref:`UIValueBinding <doxid-class_e_e_1_1_u_i_1_1_u_i_value_binding>` share this policy type, so custom conversions do not depend on either ownership model. The PropertyDefinition describes the widget property being synchronized and can be used for CSS-aware parsing.

.. ref-code-block:: cpp

	auto converter = UIValueConverter<MyEnum>(
	    []( const CSS::PropertyDefinition*, const std::string& text ) {
	        MyEnum value;
	        return enumFromString( value, text ) ? UIValueResult<MyEnum>::success( value )
	                                              : UIValueResult<MyEnum>::error( 1 );
	    },
	    []( const CSS::PropertyDefinition*, const MyEnum& value ) {
	        return UIValueResult<std::string>::success( enumToString( value ) );
	    } );