Example

====== Fan - Grouping ======

^ by: | Alex del Bondio, January 2019 |
^ published: | http://forum.avolites.com/viewtopic.php?f=20&t=5962#p21516 |
^ description: | Macros to set the fan group options, to be put on buttons which also show the current selection |
^ remarks: |  |

{{tag>fan group active binding converter}}

==== functions ====

  * [[macros:function:actionscript.setproperty.enum|]]
  * [[macros:function:Math.EnumAsStringEqualityConverter]]

==== affected properties ====
  * [[:macros:property:Programmer.Editor.Fixtures.Fan.GroupOptions]]

==== specials ====
  * [[macros:active_binding|]]
 
===== Code =====
<code xml FanGroups.xml>
<?xml version="1.0" encoding="utf-8"?>

<avolites.macros>

  <macro id="adb.Macros.fan.ignoregroups" name="adb fan IgnoreGroups">
    <active binding="{propertyLink id='Programmer.Editor.Fixtures.Fan.GroupOptions' 
      converter='Math.EnumAsStringEqualityConverter' 
      converterParameter='IgnoreGroups'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Enum("Programmer.Editor.Fixtures.Fan.GroupOptions", "IgnoreGroups")</step>
    </sequence>
  </macro>
  
  <macro id="adb.Macros.fan.FanGroupAsFixture" name="adb fan FanGroupAsFixture">
    <active binding="{propertyLink id='Programmer.Editor.Fixtures.Fan.GroupOptions' 
      converter='Math.EnumAsStringEqualityConverter' 
      converterParameter='FanGroupAsFixture'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Enum("Programmer.Editor.Fixtures.Fan.GroupOptions", "FanGroupAsFixture")</step>
    </sequence>
  </macro>
  
  <macro id="adb.Macros.fan.FanWithinGroup" name="adb fan FanWithinGroup">
    <active binding="{propertyLink id='Programmer.Editor.Fixtures.Fan.GroupOptions' 
      converter='Math.EnumAsStringEqualityConverter' 
      converterParameter='FanWithinGroup'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Enum("Programmer.Editor.Fixtures.Fan.GroupOptions", "FanWithinGroup")</step>
    </sequence>
  </macro>
  
</avolites.macros>
</code>


===== Explanation =====

This explains the functional steps within the sequence. For all the other XML details please refer to [[:macros:formats_and_syntax#xml_format|Formats and syntax]]

Each macro sets the Fan Grouping property to a specific value. Additionally, each macro shows its selection state on its handle using [[macros:active_binding|]].

===== How to use it =====

  * [[:macros:deploying|make this macro available]]
  * copy the macros to buttons in order to quickly set the fan grouping


~~DISCUSSION~~