Allows you to create new files, open files, merge other files with your project, save your interface, save and load classes, import GIL files, generate code, print, or exit Builder Xcessory. Select File from the Browser menu bar, either with the mouse or with a mnemonic, to display the following menu:
The following sections describe the items available from the File menu.
Clears all current objects and switches to the default language. If any pixmaps, styles, procedures, identifiers, user-defined types or constants will be destroyed by the clear operation, Builder Xcessory displays the following warning message dialog:
Displays the File Selection dialog:
You can use the File Selection dialog to specify the following UIL files:
· UIL file generated by Builder Xcessory
· Existing UIL file written by hand
· Existing UIL files written with another user interface design tool
By default, the Filter field of the File Selection dialog contains the name of the directory from which you are running Builder Xcessory.
To display the contents of a different directory, enter the directory name in the Filter field and click the Filter button. You can specify match strings using regular expressions. For example, *.uil will list only files ending in characters .uil. Click OK to open the specified file or Cancel to remove the File Selection dialog.
The Files box lists the files in the directory which match the file filter, set to *.uil by default.
Enter the full pathname in this field to select a file.
To select a file, click on the file name in the File box or enter the full pathname in the Selection field.
If you open a file from a directory different from the one in which you started Builder Xcessory executable, Builder Xcessory changes to the current working directory.
Open imports a UIL file along with information specific to Builder Xcessory, such as generated code routine names and routine generation status. For example, if you change the Main file from main-c.c to mymain.c, this information is imported along with the file. If you disable code generation of a file, this information is also incorporated. However, this information is not imported during a Read operation.
When Builder Xcessory attempts to Open the selected file, it may display a warning dialog with the message "Name conflict between loaded style and new style". A resource style that exists currently in the Builder Xcessory Style Manager has the same name as a different resource style defined for the file that you are attempting to open.
The three push buttons perform the following operations:
Displays the same File Selection dialog as shown in Open (Ctrl+O) . However, invoking the File Selection dialog from Read allows the following option and additional operations:
· You can add the interface specified in the UIL file to an existing interface on your display.
· Builder Xcessory classes, styles, constants, procedures, identifiers, and types in the new file are added to their respective managers.
· The contents of the read file are added to the current UIL file, and the read file is subsumed by the current UIL file.
Read differs from Open in the following ways:
· Read does not change the current working directory.
· All code generation options stored in the Read file are overridden by the current settings in Builder Xcessory.
· Read merges the UIL file into the currently opened project. Any association to the original UIL file is not maintained.
Writes your interface to the currently specified UIL file. Select one of the following options to display and edit the directory path and file name:
· Save As from the Browser File menu.
· Code Generation Preferences from the Browser Options menu.
Displays a File Selection dialog:
The Directory Path field is non-editable. You can rename the UIL file, or re-specify the directory path.
To edit the Filter text field, use one of the following methods:
· Double-click with the Directories list to navigate up and down directory paths.
· Click the Filter button to update the Directories list for the directory specified in the Directory Path field (which simply echoes what you specified in the Filter text field).
Reads in a class already created and saved as an include file by using the Save Class menu item.
When you select Read Class, a File Selection dialog is displayed. Specify the include file name or re-specify the directory path and click on the OK button in the File Selection dialog.
Builder Xcessory reads in the include file and adds it to the Palette.
Writes out a selected class in your application to a separate UIL include file. If you Save, the class definition is saved into an include file instead of the application's UIL file, allowing you to easily add the class to other projects.
Use Save Class when you have a class that you want to share with other developers or use in more than one application. Once you write a class to its own include file, other users can read that class into Builder Xcessory using Read Class.
To use Save Class, use the following procedure:
1. Switch to Classes View in the Browser to display all current classes.
2. Select one class, then select Save Class.
3. Enter a filename for the include file in the File Name text field at the bottom of the dialog, and click OK.
To save a class that will automatically be loaded into your Builder Xcessory at startup:
1. Select the class in Classes View
2. Select Save Class (see Save Class )
3. Drag icon of the class from its current location (probably Project Classes) on the Palette to a Private Classes group
To save a class that will automatically be loaded into everyone's Builder Xcessory at startup, drag the icon of that class from its current location (probably Project Classes) on the Palette to a Public Classes group.
Once you save a class, you can rename the file using Save Class As, described in the following section.
{BX}/XCESSORY/classes
directory to drag the icon onto the Group. If you do not have write permission, ask someone with the proper permissions to move the file to the {BX}/xcessory/classes directory.
You can rename the include file which contains a class that you saved separately from your application. You can also specify the directory path.
Makes the selected class read-only (you cannot edit the class). You must select a class before you click on this option. Builder Xcessory displays a warning dialog asking if you want to save the class before locking it:
1. Click OK to display a File Selection dialog (if you have not yet saved the class).
2. Enter the pathname of the file and click OK.
When you save your application, this file will not be overwritten.
2. Click on the Class option of the File menu.
The Lock Class option now reads Unlock Class. Select Unlock Class to remove the lock.
Refer to Classes and Methods in the Builder Xcessory User's Guide for more detailed information about using classes.
Displays a menu that contains only the Import Gil option.
Displays the same File Selection dialog as shown in Open (Ctrl+O) and Read (Ctrl+F). See Open (Ctrl+O) for more detailed information about the File Selection dialog. The File Selection dialog filter defaults to a .G file suffix.
The File Selection dialog allows you to add the interface specified in a GIL (Guide Interface Language) file to an existing interface on your display. You can set certain options before importing a GIL file. See the section GIL Import Preferences for more detailed information.
Writes the files for your application. {Lang} is the language you selected for this particular project file, or the language you selected as your default language at the beginning of your Builder Xcessory session. If you want to choose a different language, refer to Choose A Language for more detailed instructions.
Once you save your application, you can generate your application code outside Builder Xcessory in scripts or makefiles with the following command on the command line:
The following sections describe how files are generated in each available language.
Writes the C++ files for your application. Additional files are generated if you included classes in your interface. See Code Generation Preferences for more detailed information about filenames and options for the files to be generated.
MyClass.
C and MyClass.h
are regenerated only if they are different from the previous code generation.
The following list describes the C++ files generated by Builder Xcessory when you select Generate C++, or execute the cgx50 -gen CXX command on the command line (default names are in parentheses):
· Class Tree Root (UIComponent)
· A header file and source file for every class in the interface
Writes the C++ files that use the IRIS ViewKit/ViewKit ObjectPak classes for your application.
To generate your application code outside Builder Xcessory, use the following flag in the cgx50 command on the command line:
The following list describes the ViewKit files generated by Builder Xcessory when you select Generate ViewKit, or execute the cgx50 -gen VK command on the command line (default names are in parentheses):
-xrm
flag on the applications command line.· A header file and source file for every class in the interface.
Writes the C files for your application. To generate your application code outside Builder Xcessory, use the following flag in the cgx command:
The following list describes the C files generated by Builder Xcessory when you select Generate C, or execute the cgx50 -gen C command on the command line (default names are in parentheses):
Generates code for your application using a combination of C and UIL. Builder Xcessory generates your interface in a set of UIL files specified with the UIL File Manager. Other files are generated to compile, invoke, and run your UIL from outside Builder Xcessory.
The following list describes the UIL files generated by Builder Xcessory when you select Generate UIL, or execute thecgx50
-gen C_UIL
command (default names are in parentheses):
The following lists the C files generated by Builder Xcessory when you select Generate C, or execute the cgx50 -gen C_UIL command on the command line (default names are in parentheses):
· Imakefile that specifies both UIL and C imake information. Makefile ( makefile-uil
)
.uid
file which is then read by the Mrm calls at run-time to create the interface. Builder Xcessory generates a backup file whenever it overwrites an existing UIL file. Automatic backup is provided for the default filename uil.uil or any customized filename. If, for example, you write the renamed UIL file new_uil.uil, and a copy of this file already exists, Builder Xcessory generates the backup file new_uil.uil~. These UIL files are identical to the files generated when you select Save from the Browser File menu.You can change any filename, and disable or enable the generation of a particular file from the File Names tab of the Code Generation Preferences dialog (Browser Options menu). Any changes made in the Output File Names dialog will be reflected in subsequent generation of code.
Writes the Java files for your application.
To generate your application code outside Builder Xcessory, use the following flag in the cgx50 command:
The following list describes the Java files generated by Builder Xcessory when you select Generate Java, or execute the cgx50 -gen JAVA command on the command line (default names are in parentheses):
· A source file for every user-defined class and top-level object in your interface (name_of_class.java and
name_of_top_level_object.java)
Displays the Print Setup dialog:
The toggles set on this dialog specify the options which are used when you select Print Hierarchy from the Browser File menu.
The radio buttons in the Destination field adjust whether the output of Print Hierarchy will go to a file, a viewer window, or a printer.
The toggles in the Options field adjust the format and content of the print output:
The toggles in Hierarchy View allow you to print either the Browser or the XtIntrinsic view of the widget hierarchy:
Exits the Builder Xcessory. If you have made changes to your interface since last writing out the UIL file, Builder Xcessory displays a warning dialog that allows you to save your changes, quit your changes, or cancel the exit operation.