CommandFusion Wiki

Documentation Resources

User Tools

Site Tools


Sidebar

software:gui-designer:tokens

This is an old revision of the document!


Tokens

A token is basically a variable that you can store data in or retrieve data from at runtime in your guiDesigner projects. A token is given a name and a value.

Token Naming

Suggested Syntax: [name]

A token can be named anything you like, but we suggest you follow the syntax above, including the square brackets in your token names. By doing this, it makes it easier to see where your token is actually being used within command values, etc.

Types of Tokens

There are three types of tokens:

  1. Global Tokens
  2. Predefined Tokens
  3. Object Tokens

Global Tokens

As the name suggests, a global token is available to be used globally throughout your guiDesigner project.
Global tokens are defined in Project Properties > Global Token Manager.
A global token is the only type of token that can be set to persist its data across launches of iViewer, so you can store state data and retrieve it again the next time iViewer is opened.

Predefined Tokens

There are a number of tokens that are predefined for you in certain cases, depending where the token is being used.

Attached to every GUI object

  • [join] - The join number and join type of the object, e.g. 'd10' for a digital join of a button, 's4' for the serial join of an image object, 'a12' for the analog join of a slider object.

Attached to all Objects within Lists

Any object within a list (button, slider, image, etc) will automatically have the following tokens attached to it:

  • [list_join] - The join number of the list that the object resides in
  • [item_index] - The list index (zero based) of the list item that the object resides in.
  • [count] - The total number of items the list contains.
  • [visible] - The total number of items that are currently visible within the list.
  • [top] - The index of the first visible item within the list.
  • [scrolloffset] - The scroll position of the list in pixels.

Object Tokens

Tokens can be assigned to any object via its join number at runtime. These tokens can be set and retrieved at runtime only. For example, you can store the state state of something in a token applied to a button. Then when that button is pressed, use the token value as part of the command that the button sends, or even use the token within a math expression or JavaScript function that the button calls.

Using Tokens

Tokens can be used throughout your guiDesigner project in a number of ways:

  • Via our JavaScript API
  • Within command values
  • In feedback processing
  • Within math expressions
software/gui-designer/tokens.1356062558.txt.gz · Last modified: 2012/12/21 04:02 by jarrod