Working with Components
3. On the Insertion view, click Add ( ) to add the number of items you want to insert with each selection
4.2.4.2 Selector behavior properties
Use the following table as a guide for setting the Behavior properties for selectors. Some options are available only for specific selector types.
Description Option
Common tab
Specify how the component responds when users interact with it. Select one of the following options:
• Mouse Click: data is inserted when users click an item.
• Mouse Over: data is inserted when users move the mouse over an item.
For Label Based Menu components, the Insert On option is only available when the Always Expanded option is selected.
Insert On
Description Option
For a sliding picture menu, this option specifies how the menu scrolls through the thumbnails. Select one of the following:
• Buttons: user clicks buttons at each end of the menu to scroll.
• Mouse: user moves the mouse across the thumbnails to scroll.
Slider Method
For a sliding picture menu, this option specifies how far the slider moves. Select one of the following options:
• One: scrolls through thumbnails one at a time
• Page: scrolls through thumbnails a page at a time. The number of thumbnails on a page is determined by the width of the component.
Slider Amount
For a sliding picture menu, this option adjusts the speed of the slide behavior as the user scrolls through the thumbnails.
Scroll Speed
For an accordion menu, this parameter specifies how quickly categories expand when the user clicks the category label.
Slide Speed
For a play selector component, this parameter specifies the length of time that it takes to run through a complete sequence, displaying the whole range of source data. Select the number of seconds from the list.
Play Time (sec-onds)
If you select this option for a play selector, it plays automatically when the model opens.
Auto Play
If you select this option for a play selector, it rewinds itself automatically when the sequence has finished playing.
Auto Rewind
If you select this option for a play selector, it automatically restarts the sequence when it finishes playing it.
Auto Replay
For a fish-eye picture menu, this option specifies the size of the popup effect when the mouse moves over an image. Slide the size slider to adjust the size.
Zoom Size
For a fish-eye picture menu, this option specifies the speed that images popup on the selector when the mouse moves over the images. Slide the speed slider to adjust the speed.
Zoom Speed
Description Option
If you select this option for a label based menu, the menu always displays the available labels. Otherwise, you must specify how users expand the menu and the direction that the labels expand towards.
Note:
If this option is selected, the Insert On option is not available.
Always Expand-ed
If Expand On is selected for a label based menu, you can specify how users expand the menu. Select either Mouse Click or Mouse Over.
Expand On
For a label based menu, this option specifies the direction that the menu expands towards when it is opened.
The available options depend on the Orientation setting on the General view.
When the orientation is set to Horizontal, you can choose Left or Right. When the orientation is set to Vertical, you can choose Center Down, Left Down, Right Down, Center Up, Left Up, or Right up.
Expand Direc-tion
When this option is selected for a label based menu, the menu opens in an ani-mated fashion instead of expanding instantly.
Open Animation
In this area, you can set options specific to the ticker component.
Ticker Options
Specify the separator character used between items on a ticker.
Item Separator
Specify the direction the data scrolls across a ticker. Select Left or Right.
Scroll Direction
Specify how quickly the data scrolls across a ticker.
Scroll Speed
Select this option to allow users to sort table rows at runtime. If selected, users can click a column heading to sort the data in that column alphabetically or by value.
Allow Column Sorting
Select this option to use the table as a selector. When selected, users can click a row to insert the source data into a defined destination. With this option cleared, the table does not insert data during runtime even if you have configured Data Insertion options.
Rows are Se-lectable
Description Option
For an accordion menu, this option specifies the category that is open by default when the model runs. Select the category based on its relative position in the list of categories. The first category is selected by default.
Selected Item:
Category
Specify the type of data that will be matched to determine the default selection.
If a match is not found, the selection is set to none.
Choose one of the following options:
Description Option
The data in the source location is matched to the component's labels.
Label
The position of each selection item for the component is as-signed a number value starting from 1.The data in the source location is matched to the position numbers.
Position
The position of each selection item is assigned a number starting from 0. The data in the source location is first matched to the component's labels. If there is no match, the data is matched to the position number. If a match is still not found, the first item is selected.
This option is not available for list builder components.
Dynamic Selected Item:
Type
Specify the item that is selected by default when the model runs. Select the item based on its name or relative position in the list of items. If you choose No Selec-tion, an item is not selected when the model opens.
Note:
For the list builder, you must choose source data in the spreadsheet or click Manual Edit ( ). The selected items are added to the Destination list, but are not added to the destination cells until the user clicks Update. To insert data for the selected items when the model opens at runtime, select the Insert Items at Run-time option.
Selected Item:
Item
Description Option
Specify a location in the spreadsheet to store the selected item value.
Tip:
To reset a selector component to a "no selection" state, add another selector to set this value to None when Insertion Type is set to Label and -1 when it is set to Position.
Note:
If the type of the selected item is "Dynamic", Insert Selected Item is not available.
Selected Item:
Insert Selected Item
For a list builder, select this option if you want to add items to the Destination list and insert the data from those items into the destination cells when the model opens at runtime. If you enable this option, your selections in the Item box are added to the Destination list and inserted into the destination cells in the embed-ded spreadsheet.
Selected Item:
Insert Items at Runtime
For an accordion menu, select this option to hide categories that do not have any label data.
Hide Empty Cat-egories
This option determines whether users can select specific rows in a table. By de-fault, all rows are selectable. To prevent a row from being selected, clear the checkbox beside the row number.
Row Selectabili-ty
This option determines whether users can select rows in the table. Clear this checkbox to use the selector as a noninteractive display component.
Rows are Se-lectable
For a hierarchical table, select this check box to allow users to select multiple items in the table.
Allow Multi-se-lection
Select this option to show checkboxes for each row that help users identify which rows are selected.
Display Check Box
If this option is selected, the component does not display blank cells past the last non-empty label. This option is useful when the number of selections in the component varies.
Ignore Blank Cells
This option allows you to specify conditions that control when the selector is visible in the model. For more information about using dynamic visibility, seeManaging the visibility of components.
Dynamic Visibil-ity
Animations and Effects tab
Description Option
With this option selected, combo boxes drop down with an animated effect instead of expanding instantly.
Drop-Down Ani-mation
You can add a sound effect to some components. The sound effect is triggered when users interact with the component.
Enable Sound
Configure an animated entry effect for the appearance of the component. This option is useful for components with dynamic visibility.
Select an entry effect from the Type list and specify how long the effect lasts in the Duration (seconds) box.
Entry Effect
Related Topics
•To configure component properties
•Selector general properties
•Selector appearance properties
4.2.4.2.1 Understanding insertion types
When you configure a selector component, you set it up to insert specific data into the embedded spreadsheet. That data can then be used by other components. Depending on what you want to do with the data, you can insert different types of data to the target cells. The available options vary depending on the type of selector.
Description Insertion Type
The selected item's position in a list of items is written to the target cell. For example, if the sec-ond item in a list is selected, a value of 2 is written to the target cell.
Position
The label specified for the selected item is written to the target cell. For example, if B is selected from the options A, B, and C, the label "B" is in-serted in the target cell. This insertion type is useful when labels can change at runtime and the labels are used for a subsequent data search.
Label
Description Insertion Type
The value of the selected source cell is written to the target cell. The number of cells specified in the source data range needs to match the number of labels displayed in the component.
Note:
For hierarchical tables, multiple values can be selected and inserted. Each value that a user selects is inserted into the destination range until the range is full. At that point, the oldest data value is overwritten each time the user makes a new selection.
Value
The selected row from the source data is written to the target row.
For example, if the user chooses the third item in a combo box, the third row of source data is insert-ed to the target row.
Note:
For hierarchical tables, multiple rows can be se-lected and inserted. Each row that a user selects is inserted into the destination range until the range is full. At that point, the oldest row of data is overwritten each time the user makes new se-lection.
Row
The selected column from the source data is written to the target column. This insertion type functions similarly to Row insertion.
Column
This insertion type allows you to insert multiple rows when a single item is selected.
The selector sorts rows of source data by their labels and displays each unique label. When the user selects an item, all the rows that share the selected label are written to the target destination.
The inserted rows keep the same order as in the source data. If the Destination range does not have enough rows to contain the data, the lower rows are not inserted.
Filtered Rows
Description Insertion Type
A 1 is entered in the target cell for the selected item and a 0 is entered in the target cells for all other items in the list.
Status List
Related Topics
•To configure insertion for a hierarchical table