Example

====== Pages - Change All Playback Pages ======

^ by: | Menno Appelhof, Aug. 2016  |
^ published: | http://forum.avolites.com/viewtopic.php?f=20&t=4775 |
^ description: | Macros to change all playback pages on main sections, static playbacks and the wings. |
^ remarks: | Code below is shortened for better overview. Find full version (for all pages) at the [[http://forum.avolites.com/viewtopic.php?f=20&t=4775|original post]]. |

{{tag>change handle page playback group}}
==== functions ====
  * [[macros:function:handles.playbacks.changepage]]
  * [[macros:function:handles.staticplaybacks.changepage]]
  * [[macros:function:handles.mobilewingaplaybacks.changepage]]
  * [[macros:function:handles.mobilewingaexecutor.changepage]]
  * [[macros:function:handles.sapphirewingatop.changepage]]
  * [[macros:function:handles.sapphirewingabottom.changepage]]
  * [[macros:function:handles.sapphirewingbtop.changepage]]
  * [[macros:function:handles.sapphirewingbbottom.changepage]]


===== Code =====

Code below is shortened for better overview. Find full version (for all pages) at the [[http://forum.avolites.com/viewtopic.php?f=20&t=4775|original post]].

<code xml ChangeAllPlaybacksMacros.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="Avolites.Menus.xsd" >

<!--Macros to change all playback pages on main sections, static playbacks and the wings. August 2016 Menno Appelhof menno@fairlight.nl -->

  <macro name="Playbacks Page 1" id="Avolites.Macros.ChangeToPage1">
    <description>Changes all pages to page 1.</description>
    <sequence>
	<step>Handles.Playbacks.ChangePage(0)</step>
	<step>Handles.StaticPlaybacks.ChangePage(0)</step>
	<step>Handles.MobileWingAPlaybacks.ChangePage(0)</step>
        <step>Handles.MobileWingAExecutor.ChangePage(0)</step>
	<step>Handles.SapphireWingATop.ChangePage(0)</step>
	<step>Handles.SapphireWingABottom.ChangePage(0)</step>
	<step>Handles.SapphireWingBTop.ChangePage(0)</step>
	<step>Handles.SapphireWingBBottom.ChangePage(0)</step>
    </sequence>
  </macro>

<!-- add macros for pages 2~59 here -->

  <macro name="Playbacks Page 60" id="Avolites.Macros.ChangeToPage60">
    <description>Changes all pages to page 60.</description>
    <sequence>
	<step>Handles.Playbacks.ChangePage(59)</step>
	<step>Handles.StaticPlaybacks.ChangePage(59)</step>
	<step>Handles.MobileWingAPlaybacks.ChangePage(59)</step>
        <step>Handles.MobileWingAExecutor.ChangePage(59)</step>
	<step>Handles.SapphireWingATop.ChangePage(59)</step>
	<step>Handles.SapphireWingABottom.ChangePage(59)</step>
	<step>Handles.SapphireWingBTop.ChangePage(59)</step>
	<step>Handles.SapphireWingBBottom.ChangePage(59)</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 changes all hardware handles to a particular page by calling the respective ChangePage() function. Please note that the page number is a 0-based index.

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

  - [[macros:deploying|make this macro available]]
  - If you copy this macro to a hardware button this will vanish when changing its page. Consider setting its properties to ''Handle Paging Locked'' in playback options.


~~DISCUSSION~~