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:
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 Edit Menu
Select Edit from the UIL File Manager menu bar, either with the mouse or with a mnemonic, to display the following menu:
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.
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.
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:
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
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
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
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.
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.