<?xml version="1.0" encoding="Windows-1255" ?><Rule name="handleControlMapping" modifier="transactive" scope="public" sortGroup="true" id="core.gml2:handleControlMapping" sort="27" urn="core.gml2:rules.editing.handleControlMapping.xml" toc="\Rules\Editing rules"><Summary>Handles a field-control mapping.</Summary><Parameters signature="transactive rule::&lt;div style=&quot;padding:6 0 0 16&quot;&gt;&lt;b&gt;handleControlMapping&lt;/b&gt;(&lt;i&gt;unit&lt;/i&gt;, &lt;i&gt;board&lt;/i&gt;, &lt;i&gt;interactor&lt;/i&gt;, &lt;i&gt;mapping&lt;/i&gt;) &amp;rarr; Boolean&lt;/div&gt;"><Param name="unit" type="core.gml2:Unit!" typeRef="&lt;q ref=&quot;core.gml2:Unit&quot;&gt;Unit&lt;/q&gt;">The unit classifier.</Param><Param name="board" type="core.dev:IBoard!" typeRef="&lt;q ref=&quot;core.dev:IBoard&quot;&gt;IBoard&lt;/q&gt;">The board classifier.</Param><Param name="interactor" type="core.gml2:Interactor!" typeRef="&lt;q ref=&quot;core.gml2:Interactor&quot;&gt;Interactor&lt;/q&gt;">The interactor to define the mapping for.</Param><Param name="mapping" type="Object">Object representing mapping definition. See remarks for details.</Param></Parameters><Classifiers><Classifier name="unit" type="gml2:Unit" expr="unit"></Classifier><Classifier name="board" type="dev:IBoard" expr="board"></Classifier><Classifier name="interactor" type="gml2:Interactor" expr="interactor"></Classifier></Classifiers><Return type="Boolean">&lt;code&gt;true&lt;/code&gt; if the mapping was handled, &lt;code&gt;false&lt;/code&gt; otherwise.</Return><Remarks>&lt;h2&gt;Dependencies&lt;/h2&gt;&lt;div class=&quot;INSET&quot;&gt;None&lt;/div&gt;
		&lt;h2&gt;Behavior&lt;/h2&gt;
	   	The &lt;code&gt;mapping&lt;/code&gt; object has the following members:
	   	&lt;table class=&quot;VERT&quot;&gt;&lt;tr&gt;&lt;td class=&quot;H V&quot;&gt;Name &lt;/td&gt;&lt;td class=H&gt;Type &lt;/td&gt;&lt;td class=H&gt;Description &lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td class=V&gt;element &lt;/td&gt;&lt;td&gt;&lt;q ref=&quot;core.gml2:Interactor&quot;&gt;Interactor&lt;/q&gt; &lt;/td&gt;&lt;td&gt;element, for which this mapping is defined &lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td class=V&gt;map &lt;/td&gt;&lt;td&gt;Object &lt;/td&gt;&lt;td&gt;Object representing field to control mapping. See below for details. &lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td class=V&gt;removeControls &lt;/td&gt;&lt;td&gt;Boolean &lt;/td&gt;&lt;td&gt;Flag that defines what to do when the mapping is removed. Default is &lt;code&gt;false.&lt;/code&gt; &lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;
	   	
	   	The &lt;code&gt;map&lt;/code&gt; member of the &lt;code&gt;mapping&lt;/code&gt; object is a collection with Field ID as the key and items of the following structure:
	   	&lt;table class=&quot;VERT&quot;&gt;&lt;tr&gt;&lt;td class=&quot;H V&quot;&gt;Name &lt;/td&gt;&lt;td class=H&gt;Type &lt;/td&gt;&lt;td class=H&gt;Description &lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td class=V&gt;mapped &lt;/td&gt;&lt;td&gt;Boolean &lt;/td&gt;&lt;td&gt;&lt;code&gt;true&lt;/code&gt; if the field is mapped to a control, &lt;code&gt;false&lt;/code&gt; otherwise &lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td class=V&gt;control &lt;/td&gt;&lt;td&gt;QName &lt;/td&gt;&lt;td&gt;ID of the control if the field is mapped to a control &lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td class=V&gt;classname &lt;/td&gt;&lt;td&gt;String &lt;/td&gt;&lt;td&gt;class name of a control, to which the field is mapped or should be mapped &lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

		If the mapping is set to &lt;code&gt;true,&lt;/code&gt; the typical behavior is to create a controls and bind it to a field.
		If the mapping is set to &lt;code&gt;false,&lt;/code&gt; the typical behavior is to unbind or delete controls, depending on &lt;code&gt;removeControls&lt;/code&gt; flag.
		The behavior can be extended to define different mapping handling.</Remarks><Copyright>(c) SAP AG 2003-2006. All rights reserved.</Copyright>
<Topics>
</Topics>
</Rule>