# View Editor

# Overview

**View Editor** is the feature set in SceneComposer for designing and managing <span style="color:rgb(230,126,35);">[**View**](https://doc3161en.candera.eu/books/view-editor/page/view)</span>s. You can compose screen-level Views by combining Scenes and existing Views, structure their transitions as a tree, and export the result as a Global State Machine asset. In addition, you can visually define event logic and screen transitions for each View as <span style="color:rgb(230,126,35);">[**Action Chains**](https://doc3161en.candera.eu/books/view-editor/page/action-chain-editor)</span> and reuse them as conditional processing based on input devices and the solution state by using the **ConditionOutputs** defined in ConditionBlocks created in the <span style="color:rgb(230,126,35);">[**Condition Editor**](https://doc3161en.candera.eu/books/view-editor/page/condition-editor)</span>.

This page provides the View Editor feature set used to work with them. The View Editor consists of the following four panels.

<p class="callout info">For details on Views, see the <span style="color:rgb(230,126,35);">[View overview page](https://doc3161en.candera.eu/books/view-editor/page/view)</span>.</p>

<table id="bkmrk-view-definition-edit" style="border-collapse:collapse;width:100%;height:257.835px;"><colgroup><col style="width:24.2208%;"></col><col style="width:75.8875%;"></col></colgroup><tbody><tr style="height:80.1136px;"><td style="height:80.1136px;"><span style="color:rgb(230,126,35);">[View Definition Editor](https://doc3161en.candera.eu/books/view-editor/page/view-definition-editor)</span></td><td style="height:80.1136px;">An editor for defining screen-level Views by combining Scenes and existing Views, and for managing screen composition information. Views defined here are referenced as the common screen unit from the **View Tree**, the state machine, and the **Action Chain Editor**.

</td></tr><tr style="height:80.1136px;"><td style="height:80.1136px;"><span style="color:rgb(230,126,35);">[View Tree](https://doc3161en.candera.eu/books/view-editor/page/view-tree)</span></td><td style="height:80.1136px;">An editor for arranging Views in the solution as a tree and designing screen transitions based on that structure. The structure you configure is exported as a Global State Machine and used as the candidate targets for the <span style="color:rgb(230,126,35);">[**JumpToView** Action behavior](https://doc3161en.candera.eu/link/582#bkmrk-jump-to-view)</span> configured in the **Action Chain Editor**.

</td></tr><tr style="height:62.3097px;"><td style="height:62.3097px;"><span style="color:rgb(230,126,35);">[Action Chain Editor](https://doc3161en.candera.eu/books/view-editor/page/action-chain-editor)</span></td><td style="height:62.3097px;">This editor lets you visually define event processing and screen transitions for a View as trigger-based flowcharts. For each View selected in the **View Tree**, you associate an Action Chain and use **ConditionOutputs** created in the **Condition Editor** as branch conditions.

</td></tr><tr style="height:35.2983px;"><td style="height:35.2983px;"><span style="color:rgb(230,126,35);">[Condition Editor](https://doc3161en.candera.eu/books/view-editor/page/condition-editor)</span></td><td style="height:35.2983px;">The Condition Editor is an editor for visually defining conditions that are evaluated in Action Chains or assigned to the Condition properties of behaviors/Fusion as **ConditionOutputs** inside ConditionBlocks. The created ConditionOutputs can be reused as branch conditions in the Action Chain Editor and referenced from multiple locations in the solution as shared conditional logic.

</td></tr></tbody></table>

Used together, these let you define View-based screen composition and transition logic in a consistent, unified way.

# View

A **View** is a hierarchically higher concept than a Scene. You can treat a single Scene as one screen, or combine multiple Views into a single screen state (**Composite View**). Each View represents a logical unit that defines what content is displayed and how on a specific screen, and is identified by a dedicated identifier type called **ViewIdentifier** on the engine side.

To use a Scene directly as a View, set the Scene's **IsView** property to **true**. A Scene with **IsView=true** can be referenced as is — as the transition target of **Jump to View**, as a component of a **Composite View**, and as a View output target during asset generation. The following two types are candidates that can be referenced as a **View**:

- **Composite View**: A structured View that combines multiple Views, created explicitly from the context menu of the Solution Explorer
- **Scene with IsView=true**: A Scene treated as a standalone View

The system handles View show/hide automatically as internal processing, so you do not need to configure display control elements directly. In the [**View Tree**](https://doc3161en.candera.eu/books/view-editor/page/view-tree), you define the transition structure of multiple Views as a tree, and the system outputs that information as a Global State Machine asset. By combining the **[Action Chain Editor](https://doc3161en.candera.eu/books/view-editor/page/action-chain-editor)** with the [**Condition Editor**](https://doc3161en.candera.eu/books/view-editor/page/condition-editor), you can design screen transitions and event logic per View based on input devices or solution states.

By introducing **Views** in this way, you can separate Scene-level layout definitions from screen-level transition and control logic, and organize and maintain the entire solution's screen composition consistently at the View level.

#### Creating a View (Using a Scene Directly as a View)

To use a Scene as a View on its own, set the Scene's **IsView** property to **true**. This makes the Scene referenceable as a View without going through a separate View object.

1. In the Solution Explorer, select the target Scene.
2. In the **Scene** category of the Properties panel, select the **IsView** checkbox. 
    - The Scene becomes referenceable as a **Jump To View** target, as a component of a **Composite View**, and as a View output target during asset generation.
    - The Scene name is used as the **View Identifier** as is.

With this method, the Scene itself is treated as a View. Because the Scene name and the View name match, you can keep the entire solution's namespace tidy.

#### Creating a View (Composite View)

To create a new **Composite View** that combines multiple Views, first create an empty View item, and then add the component Views inside the **View Definition Editor**.

1. In the Solution Explorer, open the context menu anywhere and select **Add &gt; New Item**.
2. In the left menu of the dialog, select **View**.
3. After configuring the required settings, click **OK**.
4. A new View is created in the Solution Explorer.
5. Double-click the created View to open the [**View Definition Editor**](https://doc3161en.candera.eu/books/view-editor/page/view-definition-editor), and add **Scenes with IsView=true** or other Views as components.

A Composite View created this way is a screen-level View that bundles multiple display elements, and can be referenced from the View Tree and Action Chain Editor.

# View Definition Editor

**View Definition Editor** lets you define “screen-level Views” by combining Scenes created in SceneComposer with existing [**<span style="color:rgb(230,126,35);">Views</span>**](https://doc3161en.candera.eu/books/view-editor/page/view), and make those definitions available to the **<span style="color:rgb(230,126,35);">[View Tree](https://doc3161en.candera.eu/books/view-editor/page/view-tree)</span>**, the **State Machine**, and the <span style="color:rgb(230,126,35);">[**Action Chain Editor**](https://doc3161en.candera.eu/books/view-editor/page/action-chain-editor)</span>.

Only **Views** appear as nodes in the tree of the **View Definition Editor** panel. A Scene with **IsView=true** can be referenced as a View on its own, so when you want to compose a screen from a single Scene, you can place that Scene directly as a View. When you want to build a screen that bundles multiple display elements, create a **Composite View** and combine **Scenes with IsView=true** or other Views as its components. For details, see <span style="color:rgb(230,126,35);">[**View composition**](#bkmrk-view-composition)</span> later in this document. With this structure, the state machine can consistently treat “which screen (View) to activate” at the View level, while still incorporating Scene-based content into the screen composition.

### View Definition Editor UI 

#### Panel layout

Double-click any **View** in **Solution Explorer** to open the **View Definition Editor** panel.

<div drawio-diagram="9003"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779257978.png" alt="drawing-4-1779257978.png"/></div>

<table id="bkmrk-ui-item-description-" style="width:800px;height:198.92px;border-collapse:collapse;"><thead><tr style="height:29.7017px;"><th style="width:276.009px;background-color:rgb(35,111,161);">**<span style="color:rgb(255,255,255);">UI item</span>**</th><th style="width:523.082px;background-color:rgb(35,111,161);">**<span style="color:rgb(255,255,255);">Description</span>**</th></tr></thead><tbody><tr style="height:46.5057px;"><td style="width:276.009px;height:46.5057px;">**View Composition pane** (orange frame in the figure above)

</td><td style="width:523.082px;height:46.5057px;">Lists which **Scenes/Views** the selected **View** is composed of. Add or remove Scenes and existing Views by **drag and drop**.

</td></tr><tr style="height:46.5057px;"><td style="width:276.009px;height:46.5057px;">**Preview area** (red frame in the figure above)

</td><td style="width:523.082px;height:46.5057px;">Displays preview images of the **Scenes/Views** associated with the View in the right pane, where you can also adjust their layout positions. Useful for improving visual identification when referencing this View from the **State Machine** or **View Tree**.

</td></tr></tbody></table>

<article class="text-token-text-primary w-full focus:outline-none [--shadow-height:45px] has-data-writing-block:pointer-events-none has-data-writing-block:-mt-(--shadow-height) has-data-writing-block:pt-(--shadow-height) [&amp;:has([data-writing-block])>*]:pointer-events-auto scroll-mt-[calc(var(--header-height)+min(200px,max(70px,20svh)))]" dir="auto" id="bkmrk-basic-operations-thi" tabindex="-1">### Basic operations

This section outlines common procedures for defining and editing Views with the **View Definition Editor**.

<p class="callout info">For instructions on creating a **View**, see the <span style="color:rgb(230,126,35);">[View feature overview page](https://doc3161en.candera.eu/books/view-editor/page/view)</span>.</p>

#### View composition

</article>In the **View Definition Editor** panel, you can use the tree structure to edit or delete child Views under the currently opened View. You can also review the entire tree rooted at that View on the tree, including the hierarchical relationships of its child Views and their descendant Views.

<p class="callout info">The composition editing described here applies to Views created as Composite Views. A Scene with IsView=true is treated as a standalone single-screen View, so you cannot edit its tree structure or add child elements in the View Definition Editor (it is always treated as a leaf node).</p>

1. In the Solution Explorer, double-click the **View** (Composite View) whose composition you want to edit.
2. In the View composition pane, edit the elements to include in the View. 
    - You can drag and drop a **Scene with IsView=true** or an existing View from the Solution Explorer to add it.
    - To remove an unnecessary element, select it and then select **Delete** from the context menu.

##### Behavior When You Drag and Drop a Scene with IsView=true

Only **Views** appear as nodes in the tree of the View Definition Editor panel. However, because a Scene with **IsView=true** is treated as a View on its own, you can add it directly to the tree.

- When you drag and drop a Scene with **IsView=true** from the Solution Explorer onto the composition pane of the Composite View open in the View Definition Editor, the Scene is added as a child element.
- A Scene with **IsView=false** is not included as a View candidate, so you cannot drag and drop it onto the composition pane. You must first select **IsView** in the Properties panel.

With this mechanism, the View Definition Editor tree can consistently treat the unit of screen transitions and visibility control as **Views**, while still allowing you to build Scene-based content within those Views.

##### Grandchild View

In the View Definition Editor panel, a single operation can add only "a child View one level below the View you have opened." To build structures with three or more levels — such as parent View &gt; child View &gt; grandchild View — start from a **Composite View** (a View that bundles multiple Views).

- Place **Composite Views** at the parent and intermediate levels (because they are not leaf nodes, they can hold child Views beneath them).
- A **Scene with IsView=true** is always treated as a leaf node and cannot be used as an intermediate node in a grandchild hierarchy.

Using a View that meets these requirements as the starting point, create a three-level structure (**Parent View &gt; Child View &gt; Grandchild View**) as follows:

1. Open the View you want to use as the parent level, and add a child View under it (**Parent View &gt; Child View**).
2. Double-click the View you added as the child View in step 1 to open it, and then add another View under it as its child (**Child View &gt; Grandchild View**).

After performing these steps, reopen the original parent View. You can then confirm in the tree that a three-level hierarchy (**Parent View &gt; Child View &gt; Grandchild View**) is displayed.

# View Tree

**View Tree** is the editor for arranging <span style="color:rgb(230,126,35);">[**View**](http://cgi316en.candera.eu/books/view-editor/page/view)</span> in the solution as a tree and composing screen transition logic based on that structure. When you define transition relationships between Views on the tree, that information is exported as the **Global State Machine** at asset generation and becomes available as destination candidates for the <span style="color:rgb(230,126,35);">[**JumpToView** action behavior](http://cgi316en.candera.eu/link/582#bkmrk-jump-to-view)</span>.

When you set a parent–child relationship between Views, the child View is activated in sync when the parent View becomes active, allowing you to manage groups of screen elements that should always be shown together. In addition, by associating an Action Chain created in the <span style="color:rgb(230,126,35);">[**Action Chain Editor**](http://cgi316en.candera.eu/books/view-editor/page/action-chain-editor)</span> with each View, you can define that View’s event logic and conditional transitions.

### View Tree panel UI

The **View Tree** panel is hidden by default. To show the panel, do either of the following:

- Select **View** &gt; **View Editor** &gt; **View Tree** from the toolbar menu.
- In **Solution Explorer**, double-click <span style="color:rgb(230,126,35);">[an existing **View Tree**](#bkmrk-create-a-new-conditi)</span>.

<div drawio-diagram="9004"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779258594.png" alt="drawing-4-1779258594.png"/></div>

<table id="bkmrk-1-zoom-icon-zooms-th" style="border-collapse:collapse;width:800px;border-width:1px;height:88.8px;"><colgroup><col style="width:5.72099%;"></col><col style="width:25.0266%;"></col><col style="width:69.2416%;"></col></colgroup><tbody><tr style="height:29.6px;"><td class="align-center" style="height:29.6px;">1</td><td style="height:29.6px;">**Expand/Collapse icon**</td><td style="height:29.6px;">Appears when parent-child Views exist in the View Tree. Clicking this icon shows or hides the child Views.</td></tr><tr style="height:29.6px;"><td class="align-center" style="height:29.6px;">2</td><td style="height:29.6px;">**Status indicator**</td><td style="height:29.6px;">An identifier icon displayed on a ViewTreeItem when an Action Chain or an OnEntry / OnExit behavior is assigned to it. The display updates automatically according to the behavior's configuration status.

</td></tr><tr style="height:29.6px;"><td class="align-center" style="height:29.6px;">3</td><td style="height:29.6px;">**Zoom**</td><td style="height:29.6px;">Enlarges or reduces the thumbnail display inside the View Tree.

In addition to clicking, you can also enter a value directly in the Zoom display area or use the mouse wheel on the panel to enlarge or reduce the display (this behavior is common to other SceneComposer editors).

</td></tr></tbody></table>

### Basic operations

#### Create a new View Tree

Follow these steps to create a new **View Tree**:

1. In **Solution Explorer**, open the context menu at the desired location.
2. Choose **Add &gt; New Item**.
    
    
    - The **Add New Item** dialog opens.
3. In the left menu of the dialog window, select **View Tree** and click the **OK** button.
    
    
    - **View** and **View Tree** in the left menu of the dialog appear with distinct icons, so you can visually distinguish between them before selecting.
    - The name set in **Name** becomes the name of the new View Tree.
4. A new View Tree is created in the Solution Explorer.
    
    
    - In the Solution Explorer, a **View Tree** appears with a dedicated icon distinct from that of a **View**.
5. When you double-click the newly created View Tree, the View Tree panel is selected.

<p class="callout info">For the View Tree you created, you can use <span style="color:rgb(230,126,35);">[the standard operations](http://cgi316en.candera.eu/link/46#bkmrk-copy%2C-clone%2C-rename-) </span>in **Solution Explorer** to **copy**, **duplicate**, **delete**, and **rename** it.</p>

#### Place Views  


Views defined in the <span style="color:rgb(230,126,35);">[**View Definition Editor**](http://cgi316en.candera.eu/books/view-editor/page/view-definition-editor)</span> are configured by dragging &amp; dropping them onto the View Tree panel. Depending on how you place them, the structural relationships between Views and their display behavior will differ.

**Vertical placement:** If you drop a View into an empty area below an existing View, it is placed as a View at the same hierarchy level. In this case, each View is controlled independently and does not affect the others.  
**Parent-child placement:** If you drop a View onto an existing View itself, a parent-child relationship is established. This relationship provides the following structural and behavioral benefits.

<div class="TyagGW_tableContainer" id="bkmrk-effect-description-s"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" style="width:800px;border-collapse:collapse;"><thead><tr><th style="width:22.3113%;background-color:rgb(35,111,161);"><span style="color:rgb(255,255,255);">Effect</span>

</th><th style="width:77.8067%;background-color:rgb(35,111,161);"><span style="color:rgb(255,255,255);">Description</span></th></tr></thead><tbody><tr><td style="width:22.3113%;">Show parent and child together</td><td style="width:77.8067%;">When the parent View becomes active, the child View is shown at the same time. This is suitable for elements that should always be visible, such as headers or navigation.</td></tr><tr><td style="width:22.3113%;">Event linkage</td><td style="width:77.8067%;">Actions configured for the parent View (in the Action Chain Editor) are automatically propagated to and triggered for the child View as well.</td></tr><tr><td style="width:22.3113%;">UI structuring</td><td style="width:77.8067%;">By placing multiple child Views, you can compose the screen by splitting it into multiple blocks (for example, a navigation area and a main view).</td></tr><tr><td style="width:22.3113%;">Visualized hierarchy</td><td style="width:77.8067%;">In the View Tree, the View above is visually shown as the parent and the View below as the child, making the structure easy to understand.</td></tr></tbody></table>

</div></div>In this way, placement in the View Tree directly defines the mechanism for display control and event propagation—it is not merely a visual arrangement. It is important to design the optimal placement relationship based on each View’s purpose and when it should be used.

#### Configuring in Action Chain Editor

You can configure event logic in the [<span style="color:rgb(230,126,35);">**Action Chain Editor**</span>](http://cgi316en.candera.eu/books/view-editor/page/action-chain-editor) for each View placed in the View Tree. To launch the Action Chain Editor, perform one of the following operations.

- Double-click the target View.
- Select the target View and select **Open Action Chain Editor** from the context menu.

A **status indicator** appears on the View Tree panel for any ViewTreeItem that has an **Action Chain** or an **OnEntry / OnExit** behavior assigned. This lets you tell which View has logic configured just by looking at the panel. The indicator updates automatically according to the behavior's configuration status.

#### Exported as a Global State Machine

The View hierarchy and transition logic configured in the View Tree panel are exported as a **Global State Machine** when generating assets. As a result, at application runtime, each View’s visibility state and transition behavior are automatically controlled based on the relationships defined in the View Tree. In particular, the View placed at the top level of the View Tree functions as the first View to be shown when the application starts or when the application transitions back to that View Tree. This information is also incorporated into the Global State Machine and is used as the initial view and as a transition target at runtime.

In addition, screen transitions between Views are controlled by actions defined in the Action Chain Editor and are output as state-transition definitions in the Global State Machine.

In this way, the View Tree and the Action Chain Editor work together as an integrated mechanism that governs both screen composition and behavioral control.

# Action Chain Editor

**Action Chain Editor** is a visual editor for composing a **<span style="color:rgb(230,126,35);">[View](https://doc3161en.candera.eu/books/view-editor/page/view)</span>**’s event logic on a per-trigger basis. You can also directly edit the **OnEntry / OnExit action arrays associated with a View** from the list view and diagram area of this editor. OnEntry / OnExit are handled as sequential action arrays, so you edit them in a dedicated display mode. For details, see OnEntry / OnExit Editing Mode. Starting from user input or system events, you can define transitions between Views, play animations, and build complex event-driven behaviors—visually and intuitively—as Action Chain diagrams composed of **Trigger**, **Action**, and **Condition** nodes.

<p class="callout info">Operations on the **Action Chain Editor** panel are available only after you have created a **View** in the <span style="color:rgb(230,126,35);">[**View Tree**](https://doc3161en.candera.eu/books/view-editor/page/view-tree)</span>.   
In the Action Chain Editor, a Condition node references the Condition Output created in the <span style="color:rgb(230,126,35);">**[Condition Editor](https://doc3161en.candera.eu/books/view-editor/page/condition-editor)**</span>. You must define a Condition Block—and within it the Condition Output that represents the evaluation result—beforehand.  
</p>

### Action Chain Editor panel UI

#### Panel layout

The Action Chain Editor consists primarily of the following two panes.

<p class="callout info">By default, the **Action Chain Editor** panel is hidden. To display it, choose **View &gt; View Editor &gt; Action Chain Editor** from the menu bar.</p>

<div drawio-diagram="9005"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779259243.png" alt="drawing-4-1779259243.png"/></div>

<table id="bkmrk-ui-%E9%A0%85%E7%9B%AE-%E8%AA%AC%E6%98%8E-%E5%B7%A6%E3%83%9A%E3%82%A4%E3%83%B3%EF%BC%88%E4%B8%8A%E5%9B%B3%E3%82%AA%E3%83%AC%E3%83%B3%E3%82%B8" style="width:100%;"><thead><tr><th style="width:27.1613%;background-color:rgb(35,111,161);">**<span style="color:rgb(255,255,255);">UI items</span>**</th><th style="width:72.8279%;background-color:rgb(35,111,161);">**<span style="color:rgb(255,255,255);">Description</span>**</th></tr></thead><tbody><tr><td style="width:27.1613%;">**Left pane** (orange frame in the figure above)

</td><td style="width:72.8279%;">Manages the State (OnEntry / OnExit) of the selected View and multiple Action Chain diagrams in a hierarchical structure.  
The display has a two-layer structure: the two items OnEntry / OnExit under the State section, and the regular Action Chain diagrams listed under the ActionChains section. You can perform operations such as create, open, rename, and delete.

</td></tr><tr><td style="width:27.1613%;">**Right pane** (red frame in the figure above)

</td><td style="width:72.8279%;">The workspace for editing the selected **Action Chain** diagram. Place and connect **Trigger**, **Action**, and **Condition** nodes to define the processing flow.

</td></tr></tbody></table>

##### Left pane

The left pane displays Action Chain diagrams and the following two sections associated with the selected View in a hierarchical structure.

- State section: Two fixed items for editing the View's OnEntry / OnExit action arrays.
- ActionChains section: The list of regular Action Chain diagrams created per trigger.

<table id="bkmrk-%E3%83%A1%E3%83%8B%E3%83%A5%E3%83%BC-%E8%AA%AC%E6%98%8E-new-diagram-" style="width:100%;height:198.4px;"><thead><tr style="height:29.6px;"><th style="width:18.47%;background-color:rgb(35,111,161);height:29.6px;"><span style="color:rgb(255,255,255);">Menu</span></th><th style="width:81.5062%;background-color:rgb(35,111,161);height:29.6px;">**<span style="color:rgb(255,255,255);">Description</span>**</th></tr></thead><tbody><tr style="height:46.4px;"><td style="width:18.47%;height:46.4px;">New Diagram</td><td style="width:81.5062%;height:46.4px;">Creates a new Action Chain diagram. Use it under the ActionChains section (disabled when the OnEntry / OnExit item is selected).</td></tr><tr style="height:29.6px;"><td style="width:18.47%;height:29.6px;">Open</td><td style="width:81.5062%;height:29.6px;">Opens the item selected in the left pane (an ActionChain diagram or OnEntry / OnExit) in the right pane.</td></tr><tr style="height:46.4px;"><td style="width:18.47%;height:46.4px;">Rename</td><td style="width:81.5062%;height:46.4px;">Renames the diagram selected in the left pane. Available only under the ActionChains section (OnEntry / OnExit are fixed items and cannot be renamed).</td></tr><tr style="height:46.4px;"><td style="width:18.47%;height:46.4px;">Delete</td><td style="width:81.5062%;height:46.4px;">Deletes the diagram selected in the left pane. Available only under the ActionChains section (OnEntry / OnExit are fixed items and cannot be deleted).</td></tr></tbody></table>

##### OnEntry / OnExit Editing Mode

When you select OnEntry or OnExit in the left pane of the Action Chain Editor, the right pane switches to OnEntry / OnExit Editing Mode and displays a dedicated pseudo-block.

- The diagram area in the right pane displays the OnEntry or OnExit pseudo-block as the start of the sequence.
- You can add actions from the Add Action context menu on the right side of the pseudo-block to build a sequential action array.
- Added or removed actions are synchronized bidirectionally with the target View's OnEntry property or OnExit property.
- Unlike regular Action Chains, adding or editing Trigger / Condition / Else nodes is restricted in this mode.

The actions registered in OnEntry / OnExit are executed in registration order at the moment the target View becomes active (OnEntry) or becomes inactive (OnExit).

<div drawio-diagram="9006"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779259577.png" alt="drawing-4-1779259577.png"/></div>

##### Right pane

On the right pane of the Action Chain diagram, you can place and connect the following nodes from the context menu. The properties of each node placed on the diagram can be edited in the Properties panel.

<table id="bkmrk-%E3%83%A1%E3%83%8B%E3%83%A5%E3%83%BC-%E8%AA%AC%E6%98%8E-add-trigger-" style="width:100%;height:425.483px;"><thead><tr style="height:29.7017px;"><th style="width:18.4724%;background-color:rgb(35,111,161);height:29.7017px;"><span style="color:rgb(255,255,255);">Menu</span></th><th style="width:81.5168%;background-color:rgb(35,111,161);height:29.7017px;">**<span style="color:rgb(255,255,255);">Description</span>**</th></tr></thead><tbody><tr style="height:63.3097px;"><td style="width:18.4724%;height:63.3097px;">Add Trigger</td><td style="width:81.5168%;height:63.3097px;">Select a trigger node that serves as the entry point of the Action Chain.

Use this menu to select the **Condition behavior** or **Behavior Building Block** (including Condition behaviors) that you want to use as the trigger. You can also create it by dragging and dropping a Condition behavior from the toolbox.

</td></tr><tr style="height:63.3097px;"><td style="width:18.4724%;height:63.3097px;">Add Action</td><td style="width:81.5168%;height:63.3097px;">Places a node that represents the action to execute.

Select the **Action behavior** (for example, switching Views or playing an animation) or a **Behavior Building Block** (including Action behaviors) that you want to use. You can also create it by dragging and dropping an Action behavior from the toolbox.

</td></tr><tr style="height:74.148px;"><td style="width:18.4724%;height:74.148px;">Add Condition</td><td style="width:81.5168%;height:74.148px;">Select the **ConditionOutput** created in the <span style="color:rgb(230,126,35);">**[Condition Editor](https://doc3161en.candera.eu/books/view-editor/page/condition-editor)**</span>, or a **Behavior Building Block** (including Condition behaviors). Branches the subsequent flow (true/false) based on the evaluation result.

- If no ConditionOutputs are defined in the *Condition Editor*, this menu is not shown.
- ConditionOutputs that are not configured correctly are not listed in this menu

</td></tr><tr style="height:46.5057px;"><td style="width:18.4724%;height:46.5057px;">Add After</td><td style="width:81.5168%;height:46.5057px;">Defines processing that must run afterwards regardless of whether the condition evaluated to true or false. Use this to express post-processing or common flows.

</td></tr><tr style="height:29.7017px;"><td style="width:18.4724%;height:29.7017px;">Add Else</td><td style="width:81.5168%;height:29.7017px;">Used together with **Add Condition** menu to construct an if/else if/else logic structure.</td></tr><tr><td style="width:18.4724%;">Add Note</td><td style="width:81.5168%;">Places a free-text Note block on the diagram. An independent block for design intent, annotations, TODOs, and similar notes that cannot be connected to other nodes. For details, see <span style="color:rgb(230,126,35);">[Note Block](#bkmrk-note-block)</span>.</td></tr><tr style="height:29.7017px;"><td style="width:18.4724%;height:29.7017px;">Copy</td><td style="width:81.5168%;height:29.7017px;">Shown when a node is selected on the right pane. Copies the selected node.</td></tr><tr style="height:29.7017px;"><td style="width:18.4724%;height:29.7017px;">Paste</td><td style="width:81.5168%;height:29.7017px;">Shown after performing Copy or Cut. Places a duplicate of the copied/cut node onto the diagram.

</td></tr><tr style="height:29.7017px;"><td style="width:18.4724%;height:29.7017px;">Cut</td><td style="width:81.5168%;height:29.7017px;">Shown when a node is selected on the right pane. Cuts the selected node.</td></tr><tr style="height:29.7017px;"><td style="width:18.4724%;height:29.7017px;">Delete</td><td style="width:81.5168%;height:29.7017px;">Shown when a node is selected on the right pane. Deletes the selected node.</td></tr></tbody></table>

### Basic operations

#### Create a new diagram

To create a new Action Chain diagram, first select the target View in the **View Tree** panel.

1. In **View Tree**, select the View you want to define an Action Chain for.
2. Open the **Action Chain Editor** using either of the following:
    
    
    - Double-click the target View
    - Right-click the target View and choose **Open Action Chain Editor**.
3. In the **left pane** of the Action Chain Editor, open the context menu and select **New Diagram**.
    
    
    - A new Action Chain is created under the **ActionChains** section.
    - Rename the diagram as needed.

<p class="callout info">State &gt; OnEntry / OnExit in the left pane are fixed items, and New Diagram applies only to items under the ActionChains section. For details on editing actions in OnEntry / OnExit, see <span style="color:rgb(230,126,35);">[OnEntry / OnExit Editing Mode](#bkmrk-onentry-%2F-onexit-edi)</span>.</p>

#### Note Block

You can place a free-text Note block on the Action Chain diagram. A Note block is an independent block for writing design intent, annotations, TODOs, review comments, and similar notes on the diagram.

- In the right pane, select Add Note from the context menu to place a Note block on the diagram.
- You can write any text in a Note block. The initial text is `Note / Type note here…`.
- A Note block cannot be connected to other nodes.
- To remove an unnecessary Note block, select it and then select Delete from the context menu.

#### Keyboard and Mouse Gestures

You can use keyboard and mouse gestures to edit nodes in the Action Chain Editor.

<table id="bkmrk-arrow-keys-%28arrow-ke" style="border-collapse:collapse;width:800px;border-width:1px;"><colgroup><col style="width:236px;"></col><col style="width:564px;"></col></colgroup><tbody><tr><td>Arrow Keys (arrow keys alone)</td><td>Moves the selected node by small increments.</td></tr><tr><td>Shift + Arrow Keys</td><td>Moves the selected node in grid units.</td></tr><tr><td>Shift + Drag</td><td>Performs a straight-line constrained move along the horizontal or vertical axis.</td></tr><tr><td>Ctrl + Drag</td><td>Duplicates the node while moving it (copy + move).</td></tr><tr><td>Alt + Drag</td><td>Performs a free move with grid snap disabled.</td></tr></tbody></table>

<p class="callout info">These gestures also work in the Condition Editor.</p>

#### Place a Trigger node

In an Action Chain diagram, start by placing a **Trigger** node that specifies “when to run.” The trigger hands off execution to the subsequent **Condition** group.

Place it on the right pane in either of the following ways:

- Right-click the right pane and choose **Add Trigger**, then select the trigger behavior to use from the list.
- Drag the desired trigger behavior from the **toolbox** onto the right pane.

#### Place ConditionOutput and Action nodes

A **ConditionOutput** (defined within a Condition Block) and an Action together represent one “if line.”

<p class="callout info">A **ConditionOutput** node must be created beforehand in the <span style="color:rgb(230,126,35);">**[Condition Editor](https://doc3161en.candera.eu/books/view-editor/page/condition-editor)**</span>.</p>

- On the **right pane**, open the context menu and choose **Add Condition** to place a ConditionOutput node.
    
    
    - This node references a ConditionOutput created in the <span style="color:rgb(230,126,35);">**[Condition Editor](https://doc3161en.candera.eu/books/view-editor/page/condition-editor)**</span>.
- For processing that should run when the ConditionOutput evaluates to **true**, choose **Add Action** to place an **Action** node. 
    - Placing an Action node immediately to the **right** of a ConditionOutput has the following meaning:  
        `Condition_1 + Action_1 → if (Condition_1) { Action_1(); }`
- Placing another ConditionOutput **vertically below** an existing ConditionOutput creates an **if / else if / else** block that is evaluated **top to bottom** (see the next section, “if/else if/else logic”).

#### if/else if/else logic

In an Action Chain diagram, you express `if / else if / else` by how you arrange **ConditionOutputs** and **Actions**.

- **Single row (side by side)**
    
    
    - Placing a **ConditionOutput** on the left and an **Action** on the right represents `if (Condition_X) { Action_X(); }` (see <span style="color:rgb(230,126,35);">[Case 2](#bkmrk-case-2%3A-nested-if-%28s)</span> below).
- **Stacked conditions in the same column**
    
    
    - From top to bottom, the rows are evaluated as `if` → `else if` → `else` (see <span style="color:rgb(230,126,35);">[Case 3](#bkmrk-case-3%3A-exclusive-br)</span>).
    - Rows that include a **ConditionOutput** correspond to `if`/`else if`, and a row that has only an **Action** corresponds to `else` (see <span style="color:rgb(230,126,35);">[Case 6](#bkmrk-case-6%3A-three-way-br)</span>).
- **Nested if**
    
    
    - Connecting from an **Action** node to another **ConditionOutput** node creates a nested `if`, which evaluates an additional condition after that Action (see <span style="color:rgb(230,126,35);">[Cases 2](#bkmrk-case-2%3A-nested-if-%28s)</span> and <span style="color:rgb(230,126,35);">[Case 7](#bkmrk-case-7%3A-nested-if-%28a)</span>).

#### Using After nodes

An **After** node is used to gather the “exits” of multiple branches into one.

- If you connect lines from multiple **Condition** rows to the same **After** node, all of those branches merge at that After.
    
    
    - Any **Action** placed to the right of an **After** node will always run next, regardless of which path was taken.
- If you insert an **After** node and then start a new **Condition** group, you can build a structure that “executes multiple independent `if` blocks in sequence under the same trigger” (see Cases 4 and 5 below).
- Even if an **After** node is present, processing ends there unless you connect an outgoing line. Therefore, placing an After node is not mandatory; however, adding one helps to: 
    - Clearly mark the end of a branching block, and
    - Make it easier to add common post-processing later.

### Action Chain Configuration Examples

This section shows how node arrangements on the **Action Chain** diagram (right pane) correspond to example **if** statements.

#### Case 1: Basic single-condition **if**

The simplest Action Chain: one condition and one action.

- A trigger (**Check Click**) detects the event; if the condition evaluates to **true**, a single action (**Set Color**) runs.

<div drawio-diagram="8896"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1768265118.png" alt="drawing-4-1768265118.png"/></div>

```c++
if (Check Click)
{
    Set Color();
}

```

#### Case 2: Nested **if** (side-by-side layout)

This configuration shows how to represent a nested `if` that evaluates another condition within the branch of an existing condition.

Arrange the nodes in a single row as: **Trigger -&gt; Condition -&gt; Action (Set Color) -&gt; Condition\_2 -&gt; Action (Set Color)**.

- First, if **Condition** is true, run **Set Color**.
- Then evaluate **Condition\_2**; if it is true, also run **Set Color**.

With this **horizontal (side-by-side) layout**, you can express “an `if` inside an `if`” as a nested conditional that is evaluated after the preceding **Action**.

<div drawio-diagram="8897"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1768265141.png" alt="drawing-4-1768265141.png"/></div>

```c++
if (Check Click)
{
    if (Condition)
    {
        Set Color();

        if (Condition_2)
        {
            Set Color();
        }
    }
}

```

#### Case 3: Exclusive branching (if / else if)

This configuration shows how to evaluate multiple conditions for the same event **exclusively** (`if / else if`) so that **only one** action runs.

Place two rows—**Condition** and **Condition\_2**—stacked vertically **one column to the right of the Trigger**, and place their corresponding Actions (**Set Color** / **Set Color**) to the right of each row. This represents:

- Upper row: `if (Condition) { SetColor(); }`
- Lower row: `else if (Condition_2) { SetColor(); }`

To make the branch’s **common exit** explicit, place a single **After** node at the end of the block formed by **Condition** and **Condition\_2**. The After node denotes “the exit for this `if`/`else if` group,” and all subsequent processing should connect to the **right** of the After node. With this layout, it is visually clear that **regardless of which condition is met**, the flow ultimately **merges** into the same continuation.

<div drawio-diagram="8898"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1768265197.png" alt="drawing-4-1768265197.png"/></div>

```c++
if (Check Click)
{
    if (Condition)
    {
        Set Color();
    }
    else if (Condition_2)
    {
        Set Color();
    }
}

```

#### Case 4: Two independent **if** blocks under the same Trigger

This configuration evaluates two Conditions **independently and in sequence** within a single Trigger.

- The **After** placed beneath the `Condition + Set Color` row is a mandatory exit: the flow passes through it **whether `Condition` is true or false**, and then proceeds to **`Condition_2`**. 
    - As a result, `Condition_2` is **always** evaluated, regardless of the outcome of `Condition`.
- The **After\_1** placed beneath the `Condition_2 + Set Color` row marks the **end** of the entire chain.

By contrast with **Case 3**, where stacking ConditionOutputs in the same column and using a **single After** yields **exclusive branching** (i.e., the next Condition is checked **only if** the previous one was false), **Case 4** inserts an intermediate **After** between the rows so that **both `if` blocks are evaluated** in order.

<div drawio-diagram="8899"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1768265248.png" alt="drawing-4-1768265248.png"/></div>

```c++
if (Check Click)
{
    if (Condition)
    {
        Set Color();
    }
    if (Condition_2)
    {
        Set Color();
    }
}

```

#### Case 5: Independent **if** + subsequent **if/else if** group

This configuration combines a single standalone `if` followed by an `if / else if` branching group under the same Trigger.

- **Row 1** (`Condition + Set Color`) corresponds to:  
    `if (Condition) { SetColor(); }`
    
    
    - The **After** directly beneath Row 1 is a mandatory exit. The flow passes through it **whether `Condition` is true or false**, and then proceeds to the group formed by **Condition\_2** and **Condition\_3**.
- **Rows 2 and 3** (`Condition_2 + Set Color`, `Condition_3 + Set Image`) represent:  
    `if (Condition_2) { SetColor(); } else if (Condition_3) { SetImage(); }`
    
    
    - When **Condition\_2** is true, **only** `SetColor()` runs; **only when it is false** is **Condition\_3** evaluated.
- The **After\_1** beneath these two rows is the **common exit** for the `if / else if` group.

Compared with **Case 4**, where both **Condition\_1** and **Condition\_2** were independent `if` blocks, **Case 5** has an **independent `if`** for **Condition\_1**, followed by an **`if / else if` group** formed by **Condition\_2** and **Condition\_3**.

<div drawio-diagram="8900"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1768265305.png" alt="drawing-4-1768265305.png"/></div>

```c++
if (Check Click)
{
    if (Condition)
    {
        Set Color();
    }
    if (Condition_2)
    {
        Set Color();
    }
    else if (Condition_3)
    {
        Set Image();
    }
}

```

#### Case 6: Three-way branching (if / else if / else)

This configuration shows a classic **exclusive** branch with three paths under a single Trigger.

- **Row 1: “Condition + Set Color”**  
    Corresponds to `if (Condition) { SetColor(); }`.  
    **Set Color** runs only when **Condition** is true.
- **Row 2: “Condition\_2 + Set Color”**  
    Corresponds to `else if (Condition_2) { SetColor(); }`.  
    **Set Color** runs only when **Condition** is false **and** **Condition\_2** is true.
- **Row 3: “Else + Set Image”**  
    Corresponds to `else { SetImage(); }`.  
    **Set Text** runs only when both **Condition** and **Condition\_2** are false.

The key point is that **exactly one** Action runs: evaluation proceeds **top to bottom** and executes the Action on the **first** row whose condition matches.

<div drawio-diagram="8901"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1768265354.png" alt="drawing-4-1768265354.png"/></div>

```c++
if (Check Click)
{
    if (Condition)
    {
        Set Color();
    }
    else if (Condition_2)
    {
        Set Color();
    }
    else
    {
        Set Image();
    }
}

```


#### Case 7: Nested `if` (After-based layout)

This configuration represents a nested `if` where one **ConditionOutput** is evaluated only inside the branch of another.

- The flow goes from the Trigger **Check Click** to **Condition**—this is the outer `if (CheckClick)`.
- The row **“Condition + Set Color”** corresponds to `if (Condition) { SetColor(); … }`.
- Because there is a connector from **Set Color** down to **Condition\_2**, **Condition\_2** is evaluated **only when `Condition` is true**. If `Condition` is false, the flow does **not** proceed to `Condition_2`.
- The lower row **“Condition\_2 + Set Color”** corresponds to `if (Condition_2) { SetColor(); }`. Thus, **only when both** `Condition` **and** `Condition_2` are true do `SetColor()` and then `SetColor()` run in sequence.
- **After** and **After\_1** serve as visual **exits/merge points** for the **Condition** block and the **Condition\_2** block, respectively.

In contrast to **Case 4**, where two ConditionOutputs are treated as **two independent `if`s** that are both evaluated, **Case 7** places **Condition\_2** entirely **inside** **Condition**, forming a classic **nested `if`** structure.

<div drawio-diagram="8902"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-01/drawing-4-1768265406.png" alt="drawing-4-1768265406.png"/></div>

```c++
if (Check Click)
{
    if (Condition)
    {
        Set Color();

        if (Condition_2)
        {
            Set Color();
        }
    }
}

```

# Condition Editor

The **Condition Editor** is a visual editor for defining conditional logic that branches the processing flow based on input devices and the solution state. Conditional logic is managed in **Condition Blocks**. Within a Condition Block, you define one or more **ConditionOutput**s that represent the evaluation results (true/false). ConditionOutputs can be referenced from Condition nodes in the <span style="color:rgb(230,126,35);">**[Action Chain Editor](https://doc3161en.candera.eu/books/view-editor/page/action-chain-editor)**</span>. They can also be assigned to the Condition property of behaviors and Fusion, allowing the same conditional logic to be reused in multiple places across the solution.

### Tool UI overview

#### Panel layout

Double-click any **Condition Block** in **Solution Explorer** to open the **Condition Editor** panel. On this panel, you build a logical expression by placing and connecting **Check / AND / OR / NOT** nodes. Condition Blocks you create here can be referenced from the <span style="color:rgb(230,126,35);">[**Action Chain Editor**](https://doc3161en.candera.eu/books/view-editor/page/action-chain-editor)</span>.

<p class="callout info">By default, the **Condition Editor** panel is hidden. To display it, choose **View &gt; View Editor &gt; Condition Editor** from the menu bar.</p>


<div drawio-diagram="9008"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779260153.png" alt="drawing-4-1779260153.png"/></div>

On the **Condition diagram**, you can place and connect nodes via the context menu. When you open a **Condition Block** in the Condition Editor, a default ConditionOutput node is placed automatically on the diagram. ConditionOutputs can be added or deleted as needed. The properties of nodes placed on the diagram can be edited in the **Properties panel**.

<p class="callout info">A **ConditionOutput** node represents the evaluation result (true/false) of the logical expression defined in the **Condition Block**. The logical expression you create in the Condition Editor is stored under each **ConditionOutput** node name and can be referenced from the **Action Chain Editor**. The same ConditionOutput can also be assigned to the Condition property of behaviors and **Fusion**.</p>

<table id="bkmrk-%E3%83%8E%E3%83%BC%E3%83%89%E7%A8%AE%E5%88%A5-%E8%AA%AC%E6%98%8E-add-check-%E6%9D%A1" style="width:800px;height:139.517px;border-collapse:collapse;"><thead><tr style="height:29.7017px;"><th style="width:218.012px;height:29.7017px;background-color:rgb(35,111,161);"><span style="color:rgb(255,255,255);">**Node type**</span></th><th style="width:581.188px;height:29.7017px;background-color:rgb(35,111,161);"><span style="color:rgb(255,255,255);">**Description**</span></th></tr></thead><tbody><tr style="height:63.3097px;"><td style="width:218.012px;height:63.3097px;">Add Check</td><td style="width:581.188px;height:63.3097px;">Select a **Check** node that serves as the entry point for configuring the condition expression.

Use this menu to select the **Condition behavior** or **Behavior Building Block** (including Condition behaviors) that you want to use as the starting point. You can also create it by dragging a Condition behavior from the toolbox onto the diagram.

</td></tr><tr style="height:46.5057px;"><td style="width:218.012px;height:46.5057px;">Add AND / OR / NOT</td><td style="width:581.188px;height:46.5057px;">These are logical operator nodes that combine multiple **Check** nodes and sub-conditions. Use **AND / OR / NOT** to express composite conditions.</td></tr><tr><td style="width:218.012px;">Add OUTPUT</td><td style="width:581.188px;">Add a new **ConditionOutput** node.</td></tr><tr><td style="width:218.012px;">Add Note</td><td style="width:581.188px;">Places a free-text Note block on the diagram. An independent block for design intent, annotations, TODOs, and similar notes that cannot be connected to other nodes. For details, see <span style="color:rgb(230,126,35);">[Note Block](#bkmrk-note-block)</span>.</td></tr><tr><td style="width:218.012px;">Copy / Cut / Delete / Paste</td><td style="width:581.188px;">This menu becomes available when a node on the diagram is selected. It lets you **copy**, **cut**, **delete**, and **paste** the selected node.</td></tr></tbody></table>

### Basic operations

#### Create a new Condition Block

Follow these steps to create a new **Condition Block**:

1. In **Solution Explorer**, open the context menu at the desired location.
2. Choose **Add &gt; New Item**.
    
    
    - The **Add New Item** dialog opens.
3. In the dialog’s left pane, select **Condition Block**, then click **OK**.
    
    
    - The value you enter in **Name** becomes the new Condition Block’s name.
    - The [<span style="color:rgb(230,126,35);">**Category** setting determines</span>](#bkmrk-create-a-new-conditi) which category (location) the Condition Block is registered under in the toolbox.
4. A new **Condition Block** is created in **Solution Explorer**.
    
    
    - At the same time, the Condition Block you created is added to **Behaviors** in the **toolbox**.
    - For details on where it is placed, see <span style="color:rgb(230,126,35);">[Reusing a Condition Block](#bkmrk-reusing-a-condition-)</span> below.
5. Double-click the newly created Condition Block to launch the **Condition Editor**.
    
    
    - On the Condition Editor panel diagram, there is a ConditionOutput node named **Condition**.

#### Reusing a Condition Block

The created ConditionBlock and each ConditionOutput within the ConditionBlock are registered in the toolbox. By dragging and dropping a ConditionBlock or ConditionOutput from the toolbox, you can reuse the same condition logic in the following places:

- **Condition Editor**: Place it as a Check node that references an existing ConditionOutput.
- **Action Chain Editor**: Assign it to the **Condition** property of a Condition node.
- **Behaviors/Fusion**: Assign the ConditionOutput to the **Condition** property of the corresponding behavior.

Also, where a **Condition Block** appears within the toolbox’s Behaviors categories depends on whether the Category property is set.

- If **Category is set**: A category with the same name is added under the toolbox’s Behaviors, and the Condition Block is shown there.
- If **Category is not set**: The Condition Block is automatically shown under an appropriate category in the toolbox’s Behaviors, depending on the conditions you configured.

To check which category it appears in, select the target Condition Block in the Solution Explorer, then see **General &gt; Category** in the Properties panel.

<p class="callout info">For the created Condition Block and the **ConditionOutput** nodes placed within the Condition Block, you can use <span style="color:rgb(230,126,35);">[the standard operations](https://doc3161en.candera.eu/link/46#bkmrk-copy%2C-clone%2C-rename-)</span> in **Solution Explorer** to copy, duplicate, delete, and rename them.</p>

#### Creating a Condition diagram

1. In **Solution Explorer**, double-click any Condition Block.
    
    
    - The **Condition Editor** panel opens.
    - On the panel, there is a ConditionOutput node named **Condition**.
2. On the right pane, open the context menu, choose **Add Check**, and select the Condition behavior to use.
    
    
    - It is placed on the diagram as a **Check** node.
3. Place **AND / OR / NOT** nodes as needed and build the logical expression.
4. As needed, add **AND / OR / NOT** nodes and connect the **Check** nodes to construct the expression.
5. Connect the **ConditionOutput** node at the end of the diagram.
    
    
    - Logical expressions created in the Condition Editor are saved under the name of each ConditionOutput node and can be referenced from Condition nodes in the Action Chain Editor.
    - The same ConditionOutput can also be assigned to the **Condition** property of the corresponding behaviors/Fusion for reuse.

#### Note Block

You can place a free-text Note block on the Action Chain diagram. A Note block is an independent block for writing design intent, annotations, TODOs, review comments, and similar notes on the diagram.

- In the right pane, select Add Note from the context menu to place a Note block on the diagram.
- You can write any text in a Note block. The initial text is `Note / Type note here…`.
- A Note block cannot be connected to other nodes.
- To remove an unnecessary Note block, select it and then select Delete from the context menu.

#### Keyboard and Mouse Gestures

You can use keyboard and mouse gestures to edit nodes in the Action Chain Editor.

<table id="bkmrk-arrow-keys-%28arrow-ke" style="border-collapse:collapse;width:800px;border-width:1px;"><colgroup><col style="width:236px;"></col><col style="width:564px;"></col></colgroup><tbody><tr><td>Arrow Keys (arrow keys alone)</td><td>Moves the selected node by small increments.</td></tr><tr><td>Shift + Arrow Keys</td><td>Moves the selected node in grid units.</td></tr><tr><td>Shift + Drag</td><td>Performs a straight-line constrained move along the horizontal or vertical axis.</td></tr><tr><td>Ctrl + Drag</td><td>Duplicates the node while moving it (copy + move).</td></tr><tr><td>Alt + Drag</td><td>Performs a free move with grid snap disabled.</td></tr></tbody></table>

<p class="callout info">These gestures also work in the Condition Editor.</p>

# Tutorial

# Preparing Scenes and Views

This page covers the preparation of the foundation used throughout the subsequent pages. Starting from the Empty solution, you will set up a learning environment, configure the Render Targets, and create the basic scenes — Background, Header, MainContent, and DetailContent — along with the corresponding Views for each.

In the subsequent pages, you will use these elements to learn about screen switching with sibling Views, screen structuring with parent-child Views, and conditional transitions using the Action Chain Editor and Condition Editor.

### Preparing the solution

In this task, you prepare a learning environment free from the influence of existing samples. If unnecessary scenes or State Machines remain from the start, they can be difficult to distinguish from the structures you are about to create, so it is important to clean them up first.

<div class="page-content" dir="auto" id="bkmrk-create-a-new-solutio"><div dir="auto">

1. Create a new solution from the sample solution Empty.
2. In the Solution Explorer, delete the Scene2D and Scene3D scenes from Scenes.
3. Select Render Targets under Scenes and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Render Target</td><td style="height: 29.7969px;">Auto Swap</td><td style="height: 29.7969px;">True</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> </td><td style="height: 29.7969px;">Auto Clear</td><td style="height: 29.7969px;">True</td></tr></tbody></table>
4. Next, delete the GlobalStateMachine from the State Machine in the Solution Explorer.
5. Save the solution with a name of your choice.

This configuration enables the system to update the display all at once after the entire Render Target finishes drawing, rather than reflecting each camera's rendering to the display individually. However, to prevent afterimages from the previous screen, the critical factor is ensuring that the Background scene (created next) correctly handles color buffer clearing.  
</div></div>### Background Scene

The purpose of this task is not simply to place a background. The Background scene plays the role of finalizing the screen's color content at the beginning of every frame. If this scene is not configured correctly, the previous screen might appear to remain visible, even though the View switch itself succeeds.

1. <span style="color: rgb(230, 126, 35);">[Create a new 2D Scene](https://doc3161en.candera.eu/books/scene-design/page/create-a-new-scene)</span> and name it **Background**.
2. Select the camera in the Scene Tree and configure the following properties in the Properties panel: <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;">Camera</td><td style="width: 199.656px;">Sequence Number</td><td style="height: 29.7969px; width: 199.688px;">0</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;"> </td><td style="width: 199.656px;">Clear Color Buffer</td><td style="height: 29.7969px; width: 199.688px;">True</td></tr><tr><td style="width: 199.656px;"> </td><td style="width: 199.656px;">Enable Swapping</td><td style="width: 199.688px;">False</td></tr></tbody></table>
3. Place a 2D Text Node from the Toolbox onto the Scene Tree of the Background scene.  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px;">Transform</td><td style="width: 199.641px;">Position X</td><td style="width: 199.719px;">0</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px;"> </td><td style="width: 199.641px;">Position Y</td><td style="width: 199.719px;">0</td></tr><tr><td style="width: 199.641px;">2D Text Node</td><td style="width: 199.641px;">Text</td><td style="width: 199.719px;">Background</td></tr></tbody></table>

The Background scene requires Clear Color Buffer to be set to True. This clears the previous color content before drawing a new frame, so even when subsequent content scenes overlay their rendering with Clear Color Buffer set to False, the screen is less likely to appear doubled. Note that because the Background scene serves as both the shared background and the clearing handler, it is safer not to include screen-specific decorations in this scene.

### Header Scene

Here, you create a shared display element that multiple screens reuse. The Header is an element displayed in both MainView and DetailView, so you will later extract it as an independent View for reuse.

1. Create a new 2D Scene and name it **Header**.
2. Select the camera in the Scene Tree and configure the following properties in the Properties panel: <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;">Camera</td><td style="width: 199.656px;">Sequence Number</td><td style="height: 29.7969px; width: 199.688px;">2</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;"> </td><td style="width: 199.656px;">Clear Color Buffer</td><td style="height: 29.7969px; width: 199.688px;">False</td></tr><tr><td style="width: 199.656px;"> </td><td style="width: 199.656px;">Enable Swapping</td><td style="width: 199.688px;">False</td></tr></tbody></table>
3. Place a 2D Text Node from the Toolbox onto the Scene Tree of the Header scene. <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px;">Transform</td><td style="width: 199.641px;">Position X</td><td style="width: 199.719px;">300</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px;"> </td><td style="width: 199.641px;">Position Y</td><td style="width: 199.719px;">10</td></tr><tr><td style="width: 199.641px;">2D Text Node</td><td style="width: 199.641px;">Text</td><td style="width: 199.719px;">Common Header</td></tr></tbody></table>

The Header is a layer that simply overlays on top of the background and content. If you clear the color buffer here, you might erase previously drawn elements. By assigning a Sequence Number that places the Header in front of the background and the content, the Header achieves a natural stacking order as a heading.

### MainContent Scene

In this task, you create the main screen content used for the first screen switch. The buttons you add here serve as the entry point for building sibling View transitions in the next page.

1. Create a new 2D Scene and name it **MainContent**.
2. Select the camera in the Scene Tree and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;">Camera</td><td style="width: 199.656px;">Sequence Number</td><td style="height: 29.7969px; width: 199.688px;">1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;"> </td><td style="width: 199.656px;">Clear Color Buffer</td><td style="height: 29.7969px; width: 199.688px;">False</td></tr><tr><td style="width: 199.656px;"> </td><td style="width: 199.656px;">Enable Swapping</td><td style="width: 199.688px;">False</td></tr></tbody></table>
3. Place a 2D Text Node from the Toolbox onto the Scene Tree of the MainContent scene. <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 119.188px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">50</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">50</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">2D Text Node</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Main Screen</td></tr></tbody></table>
4. Next, add two TextButton controls and configure each as follows:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 119.188px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr><td colspan="3" style="width: 599.001px; background-color: rgb(194, 224, 244);">TextButton 1</td></tr><tr><td style="width: 199.641px;">General</td><td style="width: 199.641px;">Name</td><td style="width: 199.719px;">OpenDetailButton</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">100</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">100</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Control</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Open Detail</td></tr><tr><td colspan="3" style="width: 599.001px; background-color: rgb(194, 224, 244);">TextButton 2</td></tr><tr><td style="width: 199.641px;">General</td><td style="width: 199.641px;">Name</td><td style="width: 199.719px;">OpenNavigationButton</td></tr><tr><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">400</td></tr><tr><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">100</td></tr><tr><td style="width: 199.641px; height: 29.7969px;">Control</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Open Navigation</td></tr></tbody></table>

MainContent is a standard content scene placed on top of the background, so Clear Color Buffer remains set to False. The Background scene handles the clearing, and this scene only overlays the screen content on top of that background.

### DetailContent Scene

Here, you create the content for the DetailView. The Back button is used for return transitions between sibling Views, and the CheckBox is used as a control input for conditional automatic transitions in a later page.

1. Create a new 2D Scene and name it **DetailContent**.
2. Select the camera in the Scene Tree and configure the following properties in the Properties panel: <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;">Camera</td><td style="width: 199.656px;">Sequence Number</td><td style="height: 29.7969px; width: 199.688px;">1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;"> </td><td style="width: 199.656px;">Clear Color Buffer</td><td style="height: 29.7969px; width: 199.688px;">False</td></tr><tr><td style="width: 199.656px;"> </td><td style="width: 199.656px;">Enable Swapping</td><td style="width: 199.688px;">False</td></tr></tbody></table>
3. Place a 2D Text Node from the Toolbox onto the Scene Tree of the DetailContent scene. <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 119.188px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">50</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">50</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">2D Text Node</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Detail Screen</td></tr></tbody></table>
4. Next, place a TextButton control and configure the following properties: <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 148.984px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">General</td><td style="width: 199.641px; height: 29.7969px;">Name</td><td style="width: 199.719px; height: 29.7969px;">BackButton</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">100</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">100</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Control</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Back</td></tr></tbody></table>
5. Finally, add a CheckBox control and configure the following properties:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 148.984px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">General</td><td style="width: 199.641px; height: 29.7969px;">Name</td><td style="width: 199.719px; height: 29.7969px;">KeepDetailOpenCheckBox</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">100</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">200</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Control</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Keep Detail Open</td></tr></tbody></table>

### Configuring Scenes as Views

At this stage, you make the foundational components used in the subsequent pages referenceable as Views. When you set a Scene's IsView property to true, that Scene becomes referenceable as a View.

1. Select each of the four scenes created in the previous steps (Background / Header / MainContent / DetailContent) and select the IsView checkbox in the Scene category of the Properties panel.
    
    <div drawio-diagram="9013"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779261401.png" alt=""/></div>

Because the Scene name is used as the View Identifier as is, specify the same names (Background / Header / MainContent / DetailContent) when referencing them from the View Definition Editor in the subsequent pages.

In the next page, you will combine these Views to compose MainView and DetailView, and learn how to switch between them as sibling relationships on the View Tree.

# Screen Transitions with View Tree

In this page, you use the basic Views prepared in the previous page to compose two screen-level Views, MainView and DetailView, and arrange them as siblings in the View Tree.

The central themes of this page are how to assemble a single screen in the View Definition Editor and why a sibling relationship in the View Tree is suited for mutually exclusive screen switching. You also configure Jump To View on a button and verify in the Player that MainView and DetailView switch without overlapping. This page is the core part for learning the basics of the View Editor — defining screen-level Views and using sibling View transitions.

### Creating MainView

Here, you bundle the background, the common header, and the main content into a View that represents the entire main screen. Proceed while understanding that the View Definition Editor is "the place to assemble a screen-level View."

1. In Solution Explorer, select the Solution folder and select **Add &gt; New Item** from the context menu.
2. In the **New Item** dialog, select View and name it MainView.
3. Double-click the created MainView to open the View Definition Editor.
4. Add the following elements to the left pane of the View Definition Editor: 
    - Background
    - Header
    - MainContent

MainView is a View that bundles the background, the common header, and the contents of the main screen into a single screen state. It is also important that you reuse Header as an existing View — this teaches the idea of extracting shared components as separate Views and reusing them.

### Creating DetailView

Next, you define a View that represents the entire detail screen. As with MainView, you use the background and header as shared components, and only the content portion differs. This lets multiple screens share the same visual framework while only switching their content.

1. In Solution Explorer, select the Solution folder and select **Add &gt; New Item** from the context menu.
2. In the **New Item** dialog, select View and name it DetailView.
3. Double-click the created DetailView to open the View Definition Editor.
4. Add the following elements to the left pane of the View Definition Editor: 
    - Background
    - Header
    - DetailContent

DetailView is also an independent View that represents the entire screen. Because it shares the same background and header as MainView and only replaces the content, you can easily perform screen-level switching in the View Tree later.

### Configuring MainViewTree

Here, you place MainView and DetailView in the View Tree. The most important point is to make the two a sibling relationship. A sibling relationship is suited for switching between independent screen states.

1. In Solution Explorer, select the Solution folder and select **Add &gt; New Item** from the context menu.
2. In the **New Item** dialog, select ViewTree and name it MainViewTree.
3. Double-click the created MainViewTree to open the View Tree panel.
4. Drag and drop MainView onto the View Tree panel to add it as a top-level View State.
5. In the same way, drag and drop DetailView into the empty area below MainView to add it as a top-level View State.

#### Verifying the Sibling Relationship in the View Tree

- MainView and DetailView are at the same hierarchical level (DetailView is not a child of MainView).
- The two are targets to switch between exclusively.

<p class="callout info">If you drop DetailView onto the body of MainView here, you create a parent-child relationship, and the resulting structure may unintentionally behave close to simultaneous display. Because you want to switch between the entire screens this time, always drop into the empty area below to place them as siblings.</p>

### Configuring Transitions Between Views

From here, you make it possible to move between the sibling Views defined in the View Tree using Jump To View. The key point is that you specify the completed screen-level View as the transition target, not a content View.

1. Double-click the MainContent scene to open the Scene Editor.
2. In the Scene Tree, select OpenDetailButton.
3. Drag and drop a Jump To View behavior onto Action in the Extra Scene Tree.
4. Select the added Jump To View behavior and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">General</td><td style="height: 29.7969px;">Name</td><td style="height: 29.7969px;">JumpToDetailView</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Asset</td><td style="height: 29.7969px;">View</td><td style="height: 29.7969px;">DetailView</td></tr></tbody></table>

You specify DetailView (a Composite View that includes the background and header) — not DetailContent (a Scene with IsView=true on its own) — as the transition target because you want to switch at the screen level, including the background and header. The flow of treating a Composite View created in the View Definition Editor as a state in the View Tree connects here.

In the same way, configure the return transition from DetailView to MainView. This completes the round-trip switching between sibling Views.

1. Double-click the DetailContent scene to open the Scene Editor.
2. In the Scene Tree, select BackButton.
3. Drag and drop a Jump To View behavior onto Action in the Extra Scene Tree.
4. Select the added Jump To View behavior and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">General</td><td style="height: 29.7969px;">Name</td><td style="height: 29.7969px;">JumpToMainView</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Asset</td><td style="height: 29.7969px;">View</td><td style="height: 29.7969px;">MainView</td></tr></tbody></table>

### Verifying in the Player

Here, you verify not just the switching between MainView and DetailView, but also whether the Background's clear configuration is effective. Even when the transition itself succeeds, if the previous screen remains visible, the cause is more often on the Background side than in the View Tree.

1. Save the solution and launch the Player. 
    - Verify that MainView is displayed immediately after launch.
2. Click the Open Detail button. 
    - Verify that the screen switches to DetailView.
3. Click the Back button. 
    - Verify that the screen returns to MainView.

In this page, you composed MainView and DetailView as screen-level Views in the View Definition Editor and placed them as siblings in the View Tree. You also implemented basic screen switching between sibling Views using Jump To View. In the next page, you learn a different use case — a parent-child relationship that switches only a local state while preserving the shared display.

# Structuring Screen Transitions with Parent-Child View States

In this page, you define NavigationView as a parent Composite View, and inside it, you build a structure that switches between NavigationMain (a Scene with IsView=true) and RouteDetailsView (a Composite View) as child View States. What you learn here is that, unlike the sibling relationship in the previous page, a parent-child relationship is suited for "switching only a local state while maintaining the shared display." By switching between the normal display and the detail display while maintaining the map and shared buttons inside NavigationView, you understand the practical use of the parent-child structure in the View Tree. You also revisit the composition that combines a Composite View with a Scene that has IsView=true.

### Creating Shared Scenes for Navigation

First, you prepare the elements that you want to display continuously while NavigationView is active. Here, you handle the map display and the Home button as shared parts, and incorporate them into the parent View definition later.

#### NavigationMap Scene

1. Create a new 2D scene and name it NavigationMap.
2. Select the camera in the Scene Tree and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;">Camera</td><td style="width: 199.656px;">Sequence Number</td><td style="height: 29.7969px; width: 199.688px;">1</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;"> </td><td style="width: 199.656px;">Clear Color Buffer</td><td style="height: 29.7969px; width: 199.688px;">False</td></tr><tr><td style="width: 199.656px;">  
    </td><td style="width: 199.656px;">Enable Swapping</td><td style="width: 199.688px;">False</td></tr></tbody></table>
3. Place a 2D Text Node from the Toolbox onto the Scene Tree of the NavigationMap scene.  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 119.188px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">250
    
    </td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">200
    
    </td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">2D Text Node</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Navigation Map
    
    </td></tr></tbody></table>

#### NavigationViewButtons Scene

1. Create a new 2D scene and name it NavigationViewButtons.
2. Select the camera in the Scene Tree and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;">Camera</td><td style="width: 199.656px;">Sequence Number</td><td style="height: 29.7969px; width: 199.688px;">2</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;"> </td><td style="width: 199.656px;">Clear Color Buffer</td><td style="height: 29.7969px; width: 199.688px;">False</td></tr><tr><td style="width: 199.656px;">  
    </td><td style="width: 199.656px;">Enable Swapping</td><td style="width: 199.688px;">False</td></tr></tbody></table>
3. Place a TextButton control from the Toolbox onto the Scene Tree of the NavigationViewButtons scene.  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 148.984px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">General</td><td style="width: 199.641px; height: 29.7969px;">Name</td><td style="width: 199.719px; height: 29.7969px;">JumpToHomeViewButton</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">350</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">300
    
    </td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Control</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Home</td></tr></tbody></table>

NavigationMap and NavigationViewButtons are elements that you want to remain visible while in NavigationView. Therefore, you incorporate them into the parent View definition later.

### Creating Transition Scenes for Navigation

Next, you prepare the targets to switch between inside NavigationView. Here, you separate the normal display and the route details display so that you can treat them as child states of the parent View.

#### NavigationMain Scene

1. Create a new 2D scene and name it NavigationMain.
2. Select the camera in the Scene Tree and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;">Camera</td><td style="width: 199.656px;">Sequence Number</td><td style="height: 29.7969px; width: 199.688px;">2</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;"> </td><td style="width: 199.656px;">Clear Color Buffer</td><td style="height: 29.7969px; width: 199.688px;">False</td></tr><tr><td style="width: 199.656px;">  
    </td><td style="width: 199.656px;">Enable Swapping</td><td style="width: 199.688px;">False</td></tr></tbody></table>
3. Place a 2D Text Node from the Toolbox onto the Scene Tree of the NavigationMain scene.  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 119.188px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">50</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">200
    
    </td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">2D Text Node</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Navigation Main</td></tr></tbody></table>
4. Next, place a TextButton control and configure the following properties:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 148.984px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">General</td><td style="width: 199.641px; height: 29.7969px;">Name</td><td style="width: 199.719px; height: 29.7969px;">ShowDetailsButton</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">50</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">300
    
    </td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Control</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Show Details</td></tr></tbody></table>

#### RouteDetailsContent Scene

1. Create a new 2D scene and name it RouteDetailsContent.
2. Select the camera in the Scene Tree and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;">Camera</td><td style="width: 199.656px;">Sequence Number</td><td style="height: 29.7969px; width: 199.688px;">2</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;"> </td><td style="width: 199.656px;">Clear Color Buffer</td><td style="height: 29.7969px; width: 199.688px;">False</td></tr><tr><td style="width: 199.656px;">  
    </td><td style="width: 199.656px;">Enable Swapping</td><td style="width: 199.688px;">False</td></tr></tbody></table>
3. Place a 2D Text Node from the Toolbox onto the Scene Tree of the RouteDetailsContent scene.  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 119.188px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">450</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">200
    
    </td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">2D Text Node</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Route Details</td></tr></tbody></table>

#### NavigationBack Scene

1. Create a new 2D scene and name it NavigationBack.
2. Select the camera in the Scene Tree and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;">Camera</td><td style="width: 199.656px;">Sequence Number</td><td style="height: 29.7969px; width: 199.688px;">2</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 199.656px;"> </td><td style="width: 199.656px;">Clear Color Buffer</td><td style="height: 29.7969px; width: 199.688px;">False</td></tr><tr><td style="width: 199.656px;">  
    </td><td style="width: 199.656px;">Enable Swapping</td><td style="width: 199.688px;">False</td></tr></tbody></table>
3. Place a TextButton control from the Toolbox onto the Scene Tree of the NavigationBack scene and configure the following properties:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 148.984px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">General</td><td style="width: 199.641px; height: 29.7969px;">Name</td><td style="width: 199.719px; height: 29.7969px;">BackToNavigationMainButton</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Transform</td><td style="width: 199.641px; height: 29.7969px;">Position X</td><td style="width: 199.719px; height: 29.7969px;">50</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;"> </td><td style="width: 199.641px; height: 29.7969px;">Position Y</td><td style="width: 199.719px; height: 29.7969px;">300
    
    </td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px; height: 29.7969px;">Control</td><td style="width: 199.641px; height: 29.7969px;">Text</td><td style="width: 199.719px; height: 29.7969px;">Back</td></tr></tbody></table>


NavigationMain is for the normal display, and RouteDetailsContent and NavigationBack are components for the detail display. These are not shared displays — you treat them as targets to switch between inside NavigationView.

### Creating Navigation-Related Views

Here, you use both the case of creating a simple View from an existing Scene and the case of creating a new View that combines multiple components. This distinction is also important when learning the parent-child structure.

#### Creating Views: Using Existing Scenes

1. Select each of the five scenes created in the previous steps and select the IsView checkbox in the Scene category of the Properties panel.  
    <div drawio-diagram="9012"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779261329.png" alt=""/></div>
    
    
    - NavigationMap
    - NavigationViewButtons
    - NavigationMain
    - RouteDetailsContent
    - NavigationBack

#### Creating the New RouteDetailsView

1. Create a new View and name it RouteDetailsView.
2. Double-click the created RouteDetailsView to open the View Definition Editor.
3. Add the following elements to the left pane of the View Definition Editor: 
    - RouteDetailsContent
    
    
    - NavigationBack

RouteDetailsView is a screen state that bundles the detail display itself and the return operation. By extracting a local grouping like this as a Composite View, you make it easier to treat it as a child View State later.

### Configuring NavigationView

Here, you bundle into the parent View only the elements that you want to remain displayed while in Navigation. It is important to include only the shared display in the parent View, and not the parts that you want to switch.

1. In Solution Explorer, select the Solution folder and select **Add &gt; New Item** from the context menu.
2. In the **New Item** dialog, select View and name it NavigationView.
3. Double-click the created NavigationView to open the View Definition Editor.
4. Add the following elements to the left pane of the View Definition Editor: 
    - Background
    - Header
    - NavigationMap
    - NavigationViewButtons

You do not include NavigationMain or RouteDetailsView in the NavigationView definition. You add these later as child View States in the View Tree, and treat them as targets to switch between under the parent. This separation clarifies the roles of the shared display and the local switching.

### Configuring MainViewTree

Here, you add NavigationView as a top-level sibling View and attach child View States inside it. This lets you experience a two-layer structure — sibling relationships at the top level and a parent-child relationship inside Navigation.

1. Double-click MainViewTree to open the View Tree panel.
2. Drop NavigationView into the empty area below MainView and DetailView to add it as a top-level View State.
3. Drop NavigationMain onto the body of the parent NavigationView to add it as a child View State.
4. Drop RouteDetailsView onto the body of the parent NavigationView to add it as a child View State.

By dropping onto the body of the parent, the child states are treated as internal states of NavigationView while it is active. This is the essence of a parent-child relationship, as opposed to a sibling relationship.

### Configuring Navigation-Related Transitions

Here, you configure both the transitions to top-level sibling View States and the switching of child View States under the parent. This shows that the same Jump To View takes on different meanings depending on the relationship of the View you jump to.

#### MainContent Scene

1. Double-click the MainContent scene to open the Scene Editor.
2. In the Scene Tree, select OpenNavigationButton.
3. Drag and drop a Jump To View behavior onto Action in the Extra Scene Tree.
4. Select the added Jump To View behavior and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">General</td><td style="height: 29.7969px;">Name</td><td style="height: 29.7969px;">JumpToNavigation</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Asset</td><td style="height: 29.7969px;">View</td><td style="height: 29.7969px;">NavigationView</td></tr></tbody></table>

#### NavigationMain Scene

1. Double-click the NavigationMain scene to open the Scene Editor.
2. In the Scene Tree, select ShowDetailsButton.
3. Drag and drop a Jump To View behavior onto Action in the Extra Scene Tree.
4. Select the added Jump To View behavior and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">General</td><td style="height: 29.7969px;">Name</td><td style="height: 29.7969px;">JumpToRouteDetail</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Asset</td><td style="height: 29.7969px;">View</td><td style="height: 29.7969px;">RouteDetailsView</td></tr></tbody></table>

#### NavigationBack Scene

1. Double-click the NavigationBack scene to open the Scene Editor.
2. In the Scene Tree, select BackToNavigationMainButton.
3. Drag and drop a Jump To View behavior onto Action in the Extra Scene Tree.
4. Select the added Jump To View behavior and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">General</td><td style="height: 29.7969px;">Name</td><td style="height: 29.7969px;">JumpToNavigationMain</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Asset</td><td style="height: 29.7969px;">View</td><td style="height: 29.7969px;">NavigationMain</td></tr></tbody></table>

#### NavigationViewButtons Scene

1. Double-click the NavigationViewButtons scene to open the Scene Editor.
2. In the Scene Tree, select JumpToHomeViewButton.
3. Drag and drop a Jump To View behavior onto Action in the Extra Scene Tree.
4. Select the added Jump To View behavior and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">General</td><td style="height: 29.7969px;">Name</td><td style="height: 29.7969px;">JumpToMainView</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Asset</td><td style="height: 29.7969px;">View</td><td style="height: 29.7969px;">MainView</td></tr></tbody></table>

The important point here is that, inside NavigationView, NavigationMain and RouteDetailsView switch between each other as child View States, while the Home button exits Navigation entirely and returns to MainView, the top-level sibling View State.

### Verifying in the Player

The purpose of this verification is to see how the meaning of the parent-child relationship is reflected in the screen display. Verify that the shared display portion is maintained while only the child state switches.

1. Save the solution and launch the Player. 
    - Verify that MainView is displayed immediately after launch.
2. Click the Open Navigation button. 
    - Verify that the screen switches to NavigationView.
    - At the same time, verify that Background and Header are displayed.
    - In addition, verify that Navigation Main, Navigation Map, the Show Detail button, and the Home button are displayed.
3. Click the Show Details button. 
    - Verify that the screen switches to Route Details.
    - At the same time, verify that Background and Header are displayed.
    - In addition, verify that Navigation Map and the Home button are displayed.
4. Click the Back button. 
    - Verify that the screen returns to Navigation Main.
5. Click Home. 
    - Verify that the screen returns to MainView.

In this page, you built a structure that uses NavigationView as the parent View State and switches between child View States inside it. This let you confirm in practice that a sibling relationship is suited for exclusive switching of entire screens, while a parent-child relationship is suited for switching only a local state while retaining the shared display. In the next page, you add conditional automatic transitions to DetailView using the Action Chain Editor and the Condition Editor.

# Controlling Transitions with Conditions and Action Chains

In this page, you implement a conditional automatic transition for DetailView, combining a timer with a checkbox value. The central theme is the division of roles: the Action Chain Editor is the place to build the processing flow, while the Condition Editor is the place to define the condition expression independently. You build behavior that returns to MainView after a certain time elapses after entering DetailView, while stopping the auto-transition only when the Keep Detail Open CheckBox is on. This lets you understand the coordination of triggers, conditions, and actions in practice. In particular, in this page, setting OperationMode of Check Processed Value to CompareExternalValueWithConditionValue is the key to correct behavior.

### Configuring the CheckBox Control

First, you convert the state of the CheckBox control placed in the DetailContent scene into a form readable by the Condition Editor. If you skip this step, you cannot use the current checked state in a condition expression.

1. Double-click the DetailContent scene to open the Scene Editor.
2. In the Scene Tree, select KeepDetailOpenCheckBox.
3. Drag and drop a Forward Value behavior onto the Extra Scene Tree.
4. Select the added Forward Value behavior and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"> Asset</td><td style="height: 29.7969px;">EventDispatchStrategy</td><td style="height: 29.7969px;">DedicatedBehavior</td></tr></tbody></table>
5. Add a Value behavior under DedicatedBehavior of the Forward Value behavior.
6. Drag and drop the added Value behavior onto the DetailContent scene in the Scene Tree to associate it.

With this configuration, the current value of the CheckBox control is held on the scene node, and the Condition Editor can reference it as an external value. The target that you specify as ValueBehavior in the next step is the Value you created here.

### Configuring the ConditionBlock

Here, you define the condition logic that determines whether the automatic transition is allowed, separately from the Action Chain. Separating the condition makes it easier to understand the processing flow and the evaluation logic independently.

In this task, you build a condition that becomes true only when both the timer has fired and the Keep Detail Open CheckBox is off. This is the heart of the conditional transition.

1. In Solution Explorer, select the Solution folder and select **Add &gt; New Item** from the context menu.
2. In the **New Item** dialog, select ConditionBlock and name it ReturnToMainOnTimeoutCondition. 
    - The Condition Editor panel appears and displays the diagram of the newly created ReturnToMainOnTimeoutCondition &gt; Condition.
3. On the diagram, use the context menu and select **Add Check &gt; Condition &gt; Control &gt; Check Timer** to add it to the diagram.
4. In the same way, from the context menu, select **Add Check &gt; Condition &gt; Control &gt; Check Processed Value** to add it to the diagram.
5. Select the added Check Processed Value and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 195.578px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.656px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.688px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 46.5938px;"><td style="width: 199.656px; height: 46.5938px;">Asset</td><td style="width: 199.656px; height: 46.5938px;">OperationMode</td><td style="width: 199.688px; height: 46.5938px;">CompareExternalValueWithConditionValue</td></tr><tr style="height: 29.7969px;"><td style="width: 199.656px; height: 29.7969px;"> </td><td style="width: 199.656px; height: 29.7969px;">ConditionOperator</td><td style="width: 199.688px; height: 29.7969px;">Equal</td></tr><tr style="height: 29.7969px;"><td style="width: 199.656px; height: 29.7969px;"> </td><td style="width: 199.656px; height: 29.7969px;">ConditionValue type</td><td style="width: 199.688px; height: 29.7969px;">Bool</td></tr><tr style="height: 29.7969px;"><td style="width: 199.656px; height: 29.7969px;"> </td><td style="width: 199.656px; height: 29.7969px;">ConditionValue</td><td style="width: 199.688px; height: 29.7969px;">False</td></tr><tr style="height: 29.7969px;"><td style="width: 199.656px; height: 29.7969px;"> </td><td style="width: 199.656px; height: 29.7969px;">ValueBehavior</td><td style="width: 199.688px; height: 29.7969px;">DetailContent scene &gt; Value</td></tr></tbody></table>
6. Next, from the context menu, select **Add AND** to add an AND node.
7. Connect Check Timer and Check Processed Value to the AND.
8. Connect the output of the AND to the ConditionOutput.  
    <div drawio-diagram="9014"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779261704.png" alt=""/></div>

The meaning of the condition built here is: allow the automatic transition only when the timer has fired and the checkbox is off. The OperationMode setting is especially important. If you set it to an in-process event-dependent mode such as CompareProcessedValueWithConditionValue, no value event to compare against exists at the time of the Timer event, and the condition is not evaluated correctly. The correct choice here is CompareExternalValueWithConditionValue, which references the external value held on the scene node.

### Configuring On Entry for DetailView

Next, configure the action that starts the timer at the moment of entering DetailView. At this point, no transition occurs yet — you only set up the reference time for the subsequent condition evaluation.

<span style="background-color: rgb(251, 238, 184);">You can edit a View's OnEntry action in the OnEntry / OnExit Editing Mode of the Action Chain Editor. This tutorial uses this method.</span>

1. <span style="background-color: rgb(251, 238, 184);">Double-click MainViewTree to open the View Tree panel.</span>
2. <span style="background-color: rgb(251, 238, 184);">Double-click DetailView to open the Action Chain Editor.</span>
3. <span style="background-color: rgb(251, 238, 184);">In the left pane of the Action Chain Editor, double-click State &gt; OnEntry.</span>
    - <span style="background-color: rgb(251, 238, 184);">The OnEntry pseudo-block appears in the right pane.</span>
4. <span style="background-color: rgb(251, 238, 184);">On the right side of the pseudo-block, select **Add Action &gt; Action &gt; Control &gt; Start Timer** from the context menu to add a Start Timer action.</span>
5. <span style="background-color: rgb(251, 238, 184);">Select the added Start Timer and configure the following properties in the Properties panel:</span>  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 59.25px;"><tbody><tr style="height: 29.7917px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7917px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7917px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7917px; width: 199.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 29.4583px;"><td style="width: 199.641px; height: 29.4583px;"><span style="background-color: rgb(251, 238, 184);">Asset</span></td><td style="width: 199.641px; height: 29.4583px;"><span style="background-color: rgb(251, 238, 184);">Delay</span></td><td style="width: 199.719px; height: 29.4583px;"><span style="background-color: rgb(251, 238, 184);">3000</span></td></tr></tbody></table>

This configuration means: use the moment three seconds after entering DetailView as the timing for the automatic transition decision. Note that starting the timer and the transition itself are separate configurations. <span style="background-color: rgb(251, 238, 184);">The content added to OnEntry in the Action Chain Editor is automatically synchronized with the OnEntry property of DetailView.</span>

### Configuring the Action Chain

Finally, build a processing flow that receives the timer event, evaluates the ConditionOutput, and returns to MainView only when the result is true. This is the first point at which the Action Chain Editor and the Condition Editor work together.

1. Double-click MainViewTree to open the View Tree panel.
2. Double-click DetailView to open the Action Chain Editor.
3. In the left pane, double-click ActionChain1 to open the diagram.
4. <div>On the diagram, from the context menu Add Condition, select the Condition of the ReturnToMainOnTimeoutCondition you created earlier to add it.  
      
    </div>
5. <div>From the context menu, select **Add Action &gt; Action &gt; Views &gt; Jump To View** and place it on the diagram.  
      
    </div>
6. <div>Select the Jump To View and configure the following properties in the Properties panel:  
    <table border="1" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 74.1876px;"><tbody><tr style="height: 29.7969px;"><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 199.641px;"><span style="color: rgb(255, 255, 255);">Property Category</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 162.641px;"><span style="color: rgb(255, 255, 255);">Item</span></td><td class="align-left" style="background-color: rgb(35, 111, 161); height: 29.7969px; width: 236.719px;"><span style="color: rgb(255, 255, 255);">Value</span></td></tr><tr style="height: 14.5938px;"><td style="width: 199.641px;">General</td><td style="width: 162.641px;">Name</td><td style="width: 236.719px;">JumpToMainViewAfterTimeout</td></tr><tr style="height: 29.7969px;"><td style="width: 199.641px;">Asset</td><td style="width: 162.641px;">View</td><td style="width: 236.719px;">MainView</td></tr></tbody></table>
    
      
    </div>
7. From the context menu, select **Add Trigger &gt; Condition &gt; Control &gt; Check Timer** and place it on the diagram.
8. On the diagram, connect Check Timer to Condition.  
    <div drawio-diagram="9015"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779261731.png" alt=""/></div>
9. <div>Finally, snap the Jump To View action to the Condition to connect them.  
    <div drawio-diagram="9016"><img src="https://doc3161en.candera.eu/uploads/images/drawio/2026-05/drawing-4-1779261757.png" alt=""/></div>
    
      
    </div>

This configuration means: when Check Timer fires, evaluate the ConditionOutput of ReturnToMainOnTimeoutCondition, and return to MainView only when the result is true. If you connect Check Timer directly to Jump To View, the system always returns after the timer elapses and cannot reflect the checkbox state. By placing a ConditionOutput in between, the transition becomes a conditional one.

### Verifying in the Player

In this verification, you confirm not just the automatic transition by the timer itself, but also that the behavior changes depending on the checkbox state. This is the final check to verify that the division of roles between the Action Chain and the Condition is functioning correctly.

1. Save the solution and launch the Player. 
    - Verify that MainView is displayed immediately after launch.
2. Click the Open Detail button. 
    - Verify that the screen switches to DetailView.
3. Leave the Keep Detail Open checkbox off and wait for three seconds. 
    - Verify that the screen returns to MainView automatically.
4. Click the Open Detail button again.
5. This time, turn the Keep Detail Open checkbox on. 
    - Verify that the screen does not return automatically even after waiting about three seconds.
6. Verify that you can return to MainView by clicking the Back button.

In this page, you implemented a conditional automatic transition whose behavior changes according to the UI state, by coordinating the Action Chain Editor with the Condition Editor. With this, you have practiced all four basic features of the View Editor: creating screen-level Views in the View Definition Editor, configuring their relationships in the View Tree, building processing flows in the Action Chain Editor, and separating condition expressions in the Condition Editor. The complete flow of the tutorial is now finished.