Defining a File Choice Control 
Use
You use this procedure to define the properties, hyperlinks, and event handlers for a file choice control. A file choice control allows you to open either a File Open dialog box or a File Save dialog box. The main components of a file choice control are a label, an input field, and a button.
A file choice control:
· Can be used on any type of tile
· Can be bound (associated with a data source property) or left unbound
· Can be associated with a hyperlink
Prerequisites
You have:
· Added a file choice control in a tile
· Identified the property of a data source with which you want to associate the control, if this control is to be bound to a data source
Ensure that a combo engine was specified for this property.
· Identified the business anchor that references the data source containing the property you want to use
The business anchor name includes the name of the data source it references.
· Switched to the required change list
Procedure
...
1. In the Solution Explorer, locate the tile for which you want to design the file choice control, click the tile with the secondary mouse button, and choose View Designer.
The Tile Designer window appears.
2. Select the file choice control.
The Properties panel displays the values for the file choice control’s properties.
3. In the Properties panel, enter the appropriate values for the control properties.
For more information on each of the properties, see Properties of a File Choice Control.
4. If you do not need to create a hyperlink, continue with step 5. If you want to create a hyperlink, click the control with the secondary mouse button and choose View Hyperlinks.
For more information, see Model a Hyperlink.
5. If you do not need to create an event handler, continue with step 6. If you want to create an event handler, perform the following steps:
a. In the Tile Designer, click the control with the secondary mouse button and choose Add Handler.
The New Event Handler dialog box appears with default values in the fields.
b. In the Event field, select the event you want to use.
The following table provides information about the events.
Event Name |
Description |
onBoundAttributeChanged |
The value of the BO property changes. |
onBtnClicked |
The user chooses the button. This event occurs before the file choice dialog box appears. |
onHyperlinkClicked |
The user chooses the hyperlink. This event occurs before the hyperlink is executed. |
onSelected |
The user closes the file choice dialog box. |
onValueChanged2 |
The value of the control field changes. |
The following table contains events that are not supported in this release. Choose the event in the Use event column for your code.
Unsupported event |
Use event |
onFileChoiceBtnClicked |
onBtnClicked |
onFileChoiceWindowClosed |
onSelected |
onValueChanged |
onValueChanged2 |
c. Select Edit this handler code after creation and choose OK.
d. In the TODO section, enter the code you require for the event handler.
e. Save the code.
6. Save your entries.
Result
You have defined a file choice control by specifying the properties, hyperlinks, and event handlers.
See also: