Glue:Reference:States:State Categories

Introduction

State Categories can be thought of as folders for states. State Categories are used for a number of reasons:

  • To organize similar states into categories
  • To allow multiple states to be set at the same time (if not sharing variables between states)
  • To create multiple enumerations for more expressive code (if not sharing variables between states)

State categories will appear as folders in Glue which can contain any number of States. Categories cannot contain additional categories.

StateCategories.PNG

Adding a State Category

To add a state category:

  1. Expand a Screen or Entity that you want to add a category to
  2. Right-click on the States item
  3. Select “Add State Category”AddStateCategory.png
  4. Enter the name for the new category
  5. Click OK

SharesVariablesWithOtherCategories

The SharesVariablesWithOtherCategories controls whether the State Category shares variables with other categories. This value is false by default. If you set the value to, then the only purpose of the category is organizational in Glue – all states contained in the category will behave the same as if they were not contained in any category.

If this value is set to false, then the category will be treated separate from other categories and from uncategorized states. This means that the category:

  • Will create a separate enum value
  • Will create a separate property of this enum type in the given Screen/Entity
  • Will create InterpolateToState and InterpolateBetween functions for this enum type
  • Will allow exposing and tunneling of a new variable type in Glue
  • Will allow setting the new category state in GlueView