UIL File Manager

Allows you to view and manipulate files used for output file placement and to create and edit a hierarchy of UIL output files.


Note: With the UIL File Manager, you can use the UIL files in conjunction with Builder Xcessory File Placement to save different parts of your interface in different UIL files. This is especially useful when you are localizing an internationalized application.


Icons appear to the left of a given file name if that file is Read/Only and/or modified. Select UIL Files from the Browser Managers menu to display the UIL File Manager:

UIL File Manager

Read-Only UIL files

Read-Only files are preceded by a lock icon. Builder Xcessory does not allow you to Save to a Read/Only file. You can change the File Name field (as described below) to write the file to a different path or file name that is not Read/Only.

Modified UIL files

The names of files modified since the last Save or Save As operation are preceded by a star icon. A Save or Save As operation clears the icon.

UIL File Manager File Menu

Select File from the UIL File Manager menu bar, either with the mouse or with a mnemonic, to display the following menu:

UIL File Manager File Menu

Dismiss

Selecting Dismiss from the UIL File Manager File menu dismisses the UIL File Manager.

UIL File Manager Edit Menu

Select Edit from the UIL File Manager menu bar, either with the mouse or with a mnemonic, to display the following menu:

UIL File Manager Edit Menu

The following sections describe the UIL File Manager Edit menu options.

Edit Path (Ctrl+P)

Displays the Path, in which the paths of all files in the Include File Hierarchy are displayed.

Edit Path

To change a file path, click on the file in the hierarchy, type the new path in the UIL File Manager Directory text field, and press return or click the Apply to File button.

This applies the currently selected (highlighted) path to the selected file. This feature provides an effective method to easily move files to different directories. For example, a Read/Only file can be made Read/Write by moving it to another directory.

Add New File (Ctrl+N)

Creates a new output file, referenced in an include statement in the file currently selected in the Include File Hierarchy.

Add New File

File Name and Directory

To change the directory of the currently selected file to a new directory, edit the file name or the Directory text field and press return. If you change the value in the Directory text field, all files in the old directory will move to the new directory.

Path

To change the directory of the currently selected file to another directory in the Path, select the appropriate entry under Path and press Apply to File.

In each case, the File Name text field will be updated for the currently selected file.

Add Existing File (Ctrl+E)

Displays a file selection box. Select the name of an existing file in this dialog and press return. The file will be referenced in an include statement in the UIL file currently selected in the Include File Hierarchy.


Note: Existing files must not have UIL module or end module statements.

Remove File (Ctrl+R)

Removes the currently selected file as well as all of its descendants in the Include File Hierarchy. You are permitted to delete a file that is used in your interface. The messages in the Browser Message window will indicate any references to the file or its descendents.

Shuffle Up
(Ctrl +U)

Allows you to manipulate the order in which the UIL files are included.

Shuffle Down
(Ctrl +D)

Allows you to manipulate the order in which the UIL files are included.

UIL File Manager View Menu

Select View from the UIL File Manager menu bar, either with the mouse or with a mnemonic, to display the UIL File Manager View menu:

UIL File Manager View Menu

File Name

Displays the name of each file in the Include File Hierarchy.

Full Name

Displays the full path name of each file in the Include File Hierarchy.

Full Name

Displays any logical names used when you enter a file name. Allows you to simultaneously view the data contained in the Include File Hierarchy and Directory Hierarchy view options.


Note: Full Name is insensitive when the Directory Hierarchy is selected.

Include File Hierarchy

Allows you to view the Include File Hierarchy:

Include File Hierarchy

The Include File Hierarchy illustrates which output files are included in which other files. For example, if file bar.uil is referenced in an include statement in the header of file foo.uil, then bar.uil is displayed to the right of foo.uil, connected by a line.

Directory Hierarchy

Allows you to view the Directory Hierarchy.

Directory Hierarchy

The Directory Hierarchy is a tree diagram of the directories to which the output UIL files are written. If you edit the path of a file, its relative position on the Directory Hierarchy changes. More than one "root" (left-most path) can be on this hierarchy.

Show Path

Displays the Directory text field and the Path at the bottom of the UIL File Manager:

Show Path

The Path consists of the directories in which the output files will be searched for, with the top-most member searched first. Shuffle the position of the selected directory path in the Path by using the up and down arrows, and delete paths that are not referenced with the Delete button.

Changing a file path

To change a file path, perform the following steps:

1. Click on the file in the hierarchy.

2. Enter the new path in the UIL File Manager Path field.

3. Press return or click the Apply to File button.


Note: If the currently selected path is used by a file in the hierarchy, the Delete button is grayed out.

Show File Name

Displays the File Name text field.

Show File Name

Edit the File Name text field in order to change the path or name of the currently selected file.

UIL File Manager Apply Menu

Select Apply from the UIL File Manager menu bar, either with the mouse or with a mnemonic, to display the UIL File Manager Apply menu:

UIL File Manager Apply Menu

The Apply menu options allow you to apply the UIL file placement described in the following sections.

To Selected

Apply UIL File Manager settings to the currently selected object(s).

To Selected Tree(s)

Apply UIL File Manager settings to the currently selected object(s) and each of its descendants.

Make Default

Make the currently selected file the default output file. Any subsequently created objects, styles, identifiers, and constants are placed in this file by default.

 

Documentation: