Identifier
Within Titan, each and every single item which has been programmed and assigned to a handle (button, fader or key) also has a location - the 'address' of the handle it is assigned to. While more intuitive for the human user, this is slightly more complicated in terms of programming: a location comprises of the handle group (i.e. which window or which section of faders/buttons), the page ( 0-based: number 0 is displayed as page #1), and the handle index (which button on that page, again 0-based):
"Location={string group_id},{int32 page},{int32 index}"
Thus, a location might look like “Location=Playbacks,2,1”
which denotes the 2nd button on the 3rd page of the Playbacks faders.
The entire Location string is then passed to the function which needs a handle identifier, and parsed according to some internal mechanics:
<step>CueLists.GoBack("Location=Playbacks,2,1")</step>
Regarding pages see http://forum.avolites.com/viewtopic.php?f=20&t=5786 - there are funtions which only accept a handle group and index, always refering to the current page:
These functions are for use in places like the Record menu where the user is selecting a physical button and as such are hard coded to use the current page.
Pages have the following properties:
* Index: The internal page index, starts from zero.
* DisplayIndex: The page number that is displayed to the user, normally starts from one except for the preset pages on the Pearl Expert.
* Name: The legend of the page.
* DisplayName: The legend of the page if it has been set otherwise the display index.
For an example of how to read the page index and put it in another property see Handles.PlaybackWindow.Page.Index
You can retrieve some locations from you show using web API, see Titan IDs.