Path Controls

Path Controls

There are two kinds of path controls available:

• File Browser Widget—control that allows the user to specify a path and filename using a text box and browser widget that launches the XSI File Browser dialog.

• Folder Widget—control that allows the user to specify a folder using a text box and folder widget that launches a Folder Picker dialog.

The user can change the text that appears in these controls directly, but they can also be changed dynamically through Logic (see Dynamically Changing Custom Properties).

File Browser Widget

File Browser controls display an editable text box and a file browser widget along with an optional label. They are associated to an underlying String parameter.

Clicking on the file browser widget launches a File Browser which can be used to identify a path and filename. When the user clicks OK on the File Browser, it updates the associated text box with the selected path and filename.

You create them using the PPGLayout.AddItem method with the siControlFilePath control type enum.

The following item attributes are available:

Available on all Controls also as a property on the PPGItem object:

Common to many Controls:

Specific to the File Browser control:

• siUILabel

• siUIItems

• siUIType

• siUIWidthPercentage

• siUILabelPercentage

• siUILabelMinPixels

• siUINoLabel

• siUIValueOnly

• siUIContinue

• siUICX

• siUICY

• siUIStyle

• siUIFileFilter

• siUIInitialDir

• siUISubFolder

• siUIAudioFile

• siUIImageFile

• siUIOpenFile

Folder Widget

Folder widget controls display an editable text box and a folder widget along with an optional label. They are associated to an underlying String parameter.

Clicking on the folder widget launches a Folder Picker which can be used to identify the path for a folder. When the user clicks OK on the Folder Picker, it updates the associated text box with the selected path.

You create them using the PPGLayout.AddItem method with the siControlFolder control type enum.