TitleBar Script: Difference between revisions

From HLKitWiki
Jump to navigationJump to search
New page: {{context|Kit Reference|Script Types}} ==Technical Details== :{| class="scripttable" |class="leftnormal"|Initial Context: |Container |- |Alternate Context: |None |-...
 
No edit summary
Line 18: Line 18:


:{| class="infotable"
:{| class="infotable"
|class="leftnormal"|Text
|class="leftnormal"|text
|Entry: Contains the default text to display ("Choose an Item from the List Below").<br>
|Entry: Contains the default text to display ("Choose an Item from the List Below").<br>
Exit: Contains the text to be displayed to the user to prompt selection. The final text may contain [[Encoded Text|encoding]].
Exit: Contains the text to be displayed to the user to prompt selection. The final text may contain [[Encoded Text|encoding]].

Revision as of 14:00, 12 December 2008

Context: HL Kit &#133; Kit Reference &#133; Script Types 

Technical Details

Initial Context: Container
Alternate Context: None
Fields Finalized? Yes

The TitleBar script utilizes the following special symbols:

text Entry: Contains the default text to display ("Choose an Item from the List Below").

Exit: Contains the text to be displayed to the user to prompt selection. The final text may contain encoding.

Description

The TitleBar script is only used within portals that display a choose form where the user can select an item. At the top of the choose form is a title bar that contains a prompt, directing the user to select an item from the list presented. This script allows an author to specify the exact text to be displayed at the top of the selection table, making it possible to remind the user of the context being selected or how many selections remain.

NOTE!  The TitleBar script is read-only. Within this script, virtually all aspects of the structural hierarchy can be accessed, but nothing can be changed.

Example

When displaying selections where the user can select multiple items, it's helpful to inform the user how many choices remain. This can be easily achieved by a script like the one below.

@text = "Add a Special Ablity - " & hero.child[resAbility].field[resSummary].text