Example

====== Select particular Timeline ======

^ by: | Diego Lopehandía, Mar 2022 |
^ published: | here |
^ description: | selects a particular timeline\\ e.g. in conjunction with [[macros:example:opentimelinewindow|]] |

{{tag>select context timeline}}

==== functions ====
  * [[:macros:function:Editor.Timelines.SetContextTimeline]]
 
===== Code =====
<code xml selectTimeline.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>

<!-- Selects Timeline with user number 1 -->
  <macro id="Wiki.TLSetContext1">
    <name>Timeline Set Context UN=1</name>
    <sequence>	  
      <step pause="0">Editor.Timelines.SetContextTimeline(handle:"timelineHandleUN=1")</step>      
    </sequence>
  </macro>
  
<!-- Selects Timeline at location 1 on the current playback page -->
  <macro id="Wiki.TLSetContextLocation1curr">
    <name>Timeline Set Context Location 1</name>
    <sequence>	  
      <step pause="0">Editor.Timelines.SetContextTimeline("Location=Playbacks,1")</step>      
    </sequence>
  </macro>
  
<!-- Selects Timeline at location 1 of playback page 1 -->
  <macro id="Wiki.TLSetContextLocation1p1">
    <name>Timeline Set Context Location 1 p. 1</name>
    <sequence>	  
      <step pause="0">Editor.Timelines.SetContextTimeline("Location=Playbacks,1,1")</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]]

Most likely selecting by user number is the more common way as you can easily implement your own system of user numbers. However this example shows the use of [[macros:identifier:location|]] refering to the current as well as a particular other page.

Edit the macros to suit your needs regarding userNumber and location.

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

  - [[:macros:deploying|make this macro available]]
  - fire the macros to select a specific timeline


~~DISCUSSION~~