567 lines
28 KiB
Plaintext
567 lines
28 KiB
Plaintext
<!-- $XConsortium: ch02.sgm /main/6 1996/09/08 19:47:58 rws $ -->
|
|
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
|
|
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
|
|
<!-- (c) Copyright 1995 International Business Machines Corp. -->
|
|
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
|
|
<!-- (c) Copyright 1995 Novell, Inc. -->
|
|
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
|
|
<!-- (c) Copyright 1995 Hitachi. -->
|
|
<Chapter Id="ABUG.proj.div.1">
|
|
<Title Id="ABUG.proj.mkr.1">Managing Projects and Modules</Title>
|
|
<Para Id="ABUG.proj.mkr.2">When you use App Builder to create a graphical user interface, you are
|
|
working on a <Emphasis>project</Emphasis>, which is comprised of one or more <Emphasis>modules</Emphasis>. App Builder,
|
|
which was built with itself, was a single project comprising over 30 modules.</Para>
|
|
<InformalTable Id="ABUG.proj.itbl.1" Frame="All">
|
|
<TGroup Cols="1">
|
|
<ColSpec Colname="1" Colwidth="4.0 in">
|
|
<TBody>
|
|
<Row Rowsep="1">
|
|
<Entry><Para><!--Original XRef content: 'Creating, Opening, and Saving Projects7'--><XRef Role="JumpText" Linkend="ABUG.proj.mkr.3"></Para></Entry>
|
|
</Row>
|
|
<Row Rowsep="1">
|
|
<Entry><Para><!--Original XRef content: 'Creating, Importing, Exporting, and Saving Modules13'--><XRef Role="JumpText" Linkend="ABUG.proj.mkr.6"></Para></Entry>
|
|
</Row>
|
|
<Row Rowsep="1">
|
|
<Entry><Para><!--Original XRef content: 'Showing, Hiding, and Removing Modules18'--><XRef Role="JumpText" Linkend="ABUG.proj.mkr.8"></Para></Entry>
|
|
</Row>
|
|
</TBody>
|
|
</TGroup>
|
|
</InformalTable>
|
|
<Sect1 Id="ABUG.proj.div.2">
|
|
<Title Id="ABUG.proj.mkr.3">Creating, Opening, and Saving Projects</Title>
|
|
<Para>A project file is started when you choose New Project from the File menu of the
|
|
App Builder primary window or New from the Project menu of the Project
|
|
Organizer, or when you drag and drop a window onto the workspace in a new
|
|
session of App Builder. See
|
|
<!--Original XRef content: '&xd2;Project Organizer&xd3; on page 127'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apWDB.mkr.7"> for a description
|
|
of the Project Organizer. See
|
|
<!--Original XRef content: '&xd2;Dragging and Dropping Palette Objects&xd3; on
|
|
page 22'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.layo.mkr.2"> for a discussion of drag and drop procedures.</Para>
|
|
<Para>A project file is saved when you choose Save Project from the File menu of the
|
|
App Builder primary window or when you select Save from the Project menu
|
|
of the Project Organizer. A project file has a <Command>.bip</Command> (builder interface project)
|
|
suffix.
|
|
</Para>
|
|
<Sect2 Id="ABUG.proj.div.3" Role="Procedure">
|
|
<Title>To Create a New Project<IndexTerm><Primary>projects</Primary><Secondary>creating</Secondary></IndexTerm><IndexTerm><Primary>creating</Primary><Secondary>projects</Secondary></IndexTerm></Title>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Choose New Project from the File menu of the App Builder primary
|
|
window or New from the Project menu of the Project Organizer.</Para>
|
|
<Para>The Project Name dialog box will be displayed. By default, an unnamed
|
|
project is called <Command>Untitled</Command>.</Para>
|
|
<Graphic Entityref="ABUG.proj.fig.1" Id="ABUG.proj.igrph.1"></Graphic>
|
|
<Para>If you have made changes to the current project since you last saved it, a
|
|
message dialog box will be displayed first, giving you the option to discard
|
|
the changes and create the new project or to cancel the New Project
|
|
operation.</Para>
|
|
<Para>Click Discard Changes to throw out the changes and close the current
|
|
project.</Para>
|
|
<Para>Click Cancel if you want to save the current project. Save the current project
|
|
before creating the new project.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Type a name (all lowercase) for the project and click Apply.</Para>
|
|
<Para>The name of the project (with <Filename>.bip</Filename> added as a suffix) will be displayed in
|
|
the title bar at the top of the App Builder primary window. Every module
|
|
you create or import will be part of the current project until you open
|
|
another project.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
<Note>
|
|
<Para>Project names should be all lowercase so that there is no conflict
|
|
between the name of the project resource file and the project executable file.
|
|
<Literal><IndexTerm>
|
|
<Primary>naming</Primary>
|
|
<Secondary>resource files</Secondary>
|
|
</IndexTerm><IndexTerm>
|
|
<Primary>resource file</Primary>
|
|
<Secondary>naming</Secondary>
|
|
</IndexTerm></Literal>The name of the resource file created when you generate code is the same as
|
|
the name of the project, minus the <Filename>.bip</Filename> suffix, but it is given an initial capital
|
|
letter. <Literal><IndexTerm>
|
|
<Primary>naming</Primary>
|
|
<Secondary>projects</Secondary>
|
|
</IndexTerm><IndexTerm>
|
|
<Primary>projects</Primary>
|
|
<Secondary>naming</Secondary>
|
|
</IndexTerm></Literal></Para>
|
|
</Note>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.4" Role="Procedure">
|
|
<Title Id="ABUG.proj.mkr.4">To Open an Existing Project<IndexTerm><Primary>projects</Primary><Secondary>opening existing</Secondary></IndexTerm><IndexTerm><Primary>opening</Primary><Secondary>existing projects</Secondary></IndexTerm></Title>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Choose Open Project from the File menu of the App Builder primary
|
|
window or Open from the Project menu of the Project Organizer.</Para>
|
|
<Para>The Open Project dialog box will be displayed.</Para>
|
|
<Para>If you have made changes to the current project since you last saved it, a
|
|
message dialog box will be displayed first, giving you the option to discard
|
|
the changes and open the other project or to cancel the Open Project
|
|
operation.</Para>
|
|
<Para>Click Discard Changes to throw out the changes and close the current
|
|
project.</Para>
|
|
<Para>Click Cancel if you want to save the current project. Save the current project
|
|
before opening the other project.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Change folders, if necessary.</Para>
|
|
<Para>You have to press Return or click Update before the folder change is
|
|
registered.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Double-click the appropriate project file (<Filename>.bip</Filename> suffix) in the Files list</Para>
|
|
<Para><Emphasis>Or,</Emphasis> select the file and click Open.</Para>
|
|
<Para>The name of the project will be displayed in the title bar of the App Builder
|
|
primary window and the selected project will be displayed in the Project
|
|
Organizer.</Para>
|
|
<Graphic Entityref="ABUG.proj.fig.2" Id="ABUG.proj.igrph.2"></Graphic>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>In the module array of the Project Organizer, select the modules you want to
|
|
display and choose Show from the Module menu to display the module
|
|
interfaces.</Para>
|
|
<Para>See
|
|
<!--Original XRef content: '&xd2;To Show a Hidden Module&xd3; on page 18'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.proj.mkr.9"> for detailed instructions.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.5" Role="Procedure">
|
|
<Title>To Save a Project<IndexTerm><Primary>projects</Primary><Secondary>saving</Secondary></IndexTerm><IndexTerm><Primary>saving</Primary><Secondary>project</Secondary></IndexTerm></Title>
|
|
<Para>A project is only saved when you explicitly choose to save it, so be sure to save
|
|
often and regularly.</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Choose Save Project from the File menu of the App Builder primary
|
|
window or Save from the Project menu of the Project Organizer.</Para>
|
|
<Para>If you have saved the project before, the project will be saved without
|
|
comment.</Para>
|
|
<Para>If this is the first time you have saved the project, the Save Project dialog
|
|
box will be displayed.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Change to the appropriate folder.</Para>
|
|
<Para>You will normally want a separate folder for each project you work on. You
|
|
are apt to have Makefile problems otherwise.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Type a file name in the Enter file name field.</Para>
|
|
<Para>You do not have to append <Filename>.bip</Filename> to the project name; this is done
|
|
automatically when you save a project.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Save.</Para>
|
|
<Para>The project will be saved.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.6" Role="Procedure">
|
|
<Title Id="ABUG.proj.mkr.5">To Save a Version of a Project<IndexTerm><Primary>projects</Primary><Secondary>saving in different folder</Secondary></IndexTerm><IndexTerm><Primary>saving</Primary><Secondary>project to different folder</Secondary></IndexTerm></Title>
|
|
<Para>Do the following to save a version of the current project in a different folder.
|
|
You might want to do this so that you can compare two versions of a project or
|
|
put the two versions out for review. If you have made unsaved changes to the
|
|
current project those changes will be saved in the new project only.</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Choose Save Project As from the File menu of the App Builder primary
|
|
window or Save As from the Project menu of the Project Organizer.</Para>
|
|
<Para>The Save Project dialog box will be displayed, with the current project name
|
|
in the Enter file name field.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Change to another folder.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Type a name in the Enter file name field.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Save.</Para>
|
|
<Para>The project—the project file (<Filename>.bip</Filename> suffix) and all of the module files (<Filename>.bil</Filename>
|
|
suffixes)—has been copied to another folder. The original project and
|
|
module files are not affected. The new project will now be the current
|
|
project; its name will be displayed in the title bar of the App Builder
|
|
primary window.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.7" Role="Procedure">
|
|
<Title>To Rename a Project<IndexTerm><Primary>projects</Primary><Secondary>renaming</Secondary></IndexTerm><IndexTerm><Primary>renaming</Primary><Secondary>projects</Secondary></IndexTerm></Title>
|
|
<Para>Do the following to give the current project a different name. The modules that
|
|
comprise the current project will become part of a new project with a new
|
|
name and <Emphasis>the current project will</Emphasis> <Emphasis>no longer exist</Emphasis>. See
|
|
<!--Original XRef content: '&xd2;To Save a Version of a
|
|
Project'--><XRef Role="SectionTitle" Linkend="ABUG.proj.mkr.5"> above if you want to save a <Symbol Role="Variable">version</Symbol> of the the current project.</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Choose Save Project As from the File menu of the App Builder primary
|
|
window or Save As from the Project menu of the Project Organizer.</Para>
|
|
<Para>The Save Project dialog box will be displayed, with the current project name
|
|
in the Enter file name field.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Modify the name or type in a new name in the Enter file name field.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Save.</Para>
|
|
<Para>A message dialog box will be displayed for each module in the project,
|
|
telling you that the module exists and giving you the option to overwrite it
|
|
or cancel the operation.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Overwrite for each module if you want to rename the project and save
|
|
the module.</Para>
|
|
<Para>Click Cancel if you do not want to rename the project and overwrite the
|
|
current module.</Para>
|
|
<Para>If you click Overwrite for each of the modules the project will be renamed;
|
|
the new project name will be displayed in the title bar of the App Builder
|
|
primary window. The old project file (<Filename>.bip</Filename> suffix) will still be in the folder,
|
|
but it will not be the active project file. If you generate code for the project
|
|
and run <Command>make</Command> in the folder, the new project name will be used.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.8" Role="Procedure">
|
|
<Title>To Save a Project to a File (Encapsulate Project)<IndexTerm><Primary>encapsulated project file</Primary></IndexTerm><IndexTerm><Primary>projects</Primary><Secondary>saving as encapsulated file</Secondary></IndexTerm><IndexTerm><Primary>saving</Primary><Secondary>project to encapsulated file</Secondary></IndexTerm></Title>
|
|
<Para>A project is comprised of one or more modules. Normally a project file is saved
|
|
in a file with a <Filename>.bip</Filename> suffix, and each module file is saved in a separate file
|
|
with a <Filename>.bil</Filename> suffix. To save a project as a single file (for convenience in mailing
|
|
the project to someone, for instance):</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Open the project, as described in
|
|
<!--Original XRef content: '&xd2;To Open an Existing Project&xd3; on page 9'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.proj.mkr.4">.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Choose Save Project As from the File menu of the App Builder primary
|
|
window or Save As from the Project menu of the Project Organizer.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Change to the appropriate folder, if necessary.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Select Save As Encapsulated Project.</Para>
|
|
<Para>The name of the current project will be displayed in the Enter file name
|
|
field, with a <Filename>.bix</Filename> (builder interface exchange) suffix.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Save or press Return.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
<Note>
|
|
<Para>When a project is saved as an encapsulated file, the <Filename>.bip</Filename> file is not
|
|
affected. When an encapsulated project is opened in App Builder, it is opened
|
|
just like any other project. When you attempt to save a project that was opened
|
|
from an encapsulated file, a message dialog box will be displayed, explaining
|
|
that the project will be saved as individual files. Choose Save Project As if you
|
|
want to save it as an encapsulated project again.</Para>
|
|
</Note>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.9" Role="Procedure">
|
|
<Title>To Close a Project<IndexTerm><Primary>projects</Primary><Secondary>closing</Secondary></IndexTerm><IndexTerm><Primary>closing projects</Primary></IndexTerm></Title>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Choose Close Project from the File menu of the App Builder primary
|
|
window or Close from the Project menu of the Project Organizer.</Para>
|
|
<Para>If you have made changes since saving the project a message dialog box will
|
|
be displayed, giving you the chance to discard the changes or to cancel the
|
|
close operation.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
</Sect1>
|
|
<Sect1 Id="ABUG.proj.div.10">
|
|
<Title Id="ABUG.proj.mkr.6">Creating, Importing, Exporting, and Saving Modules</Title>
|
|
<Para>A <Symbol Role="Variable">module</Symbol> is a logical unit of a project. Each window and dialog in App Builder
|
|
is a module of the App Builder project, for instance. A module is created when
|
|
you choose New Module from the File menu of the App Builder primary
|
|
window or New from the Module menu of the Project Organizer.</Para>
|
|
<Para>You do not have to create a new module for each window, but in most cases
|
|
you will want to: this will make maintaining modules simpler and will allow
|
|
you to use a module for various applications.</Para>
|
|
<Para>All module files in a project are saved when the project is saved. You can
|
|
explicitly save a particular module by choosing Save from the Module menu of
|
|
the Project Organizer. A saved module file has a <Filename>.bil</Filename> (builder interface
|
|
language) suffix.</Para>
|
|
<Sect2 Id="ABUG.proj.div.11" Role="Procedure">
|
|
<Title>To Create a New Module<IndexTerm><Primary>creating</Primary><Secondary>modules</Secondary></IndexTerm><IndexTerm><Primary>modules</Primary><Secondary>creating</Secondary></IndexTerm></Title>
|
|
<Para>Do the following to create a new module, which will become part of the
|
|
current project.</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Choose New Module from the File menu of the App Builder primary
|
|
window or New from the Module menu of the Project Organizer.</Para>
|
|
<Para>The Module Name dialog box will be displayed, with Untitled selected as
|
|
the default name:</Para>
|
|
<Graphic Entityref="ABUG.proj.fig.3" Id="ABUG.proj.igrph.3"></Graphic>
|
|
<Note>
|
|
<Para>If you drag and drop a window on the workspace after creating a new
|
|
project, the Module Name dialog box will be displayed, just as if you had
|
|
chosen New Module from the File menu.</Para>
|
|
</Note>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>In the dialog box, type in the name you want to give the new module.<IndexTerm>
|
|
<Primary>modules</Primary>
|
|
<Secondary>naming</Secondary>
|
|
</IndexTerm><IndexTerm>
|
|
<Primary>naming</Primary>
|
|
<Secondary>modules</Secondary>
|
|
</IndexTerm>
|
|
</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Apply or press Return.</Para>
|
|
<Para>The name of the new module will appear in the Editing Module field at the
|
|
bottom of the App Builder primary window. Any windows you drag from
|
|
the Windows palette and drop on the workspace will be part of the new
|
|
module.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.12" Role="Procedure">
|
|
<Title>To Import a Module into a Project<IndexTerm><Primary>modules</Primary><Secondary>importing</Secondary></IndexTerm><IndexTerm><Primary>importing</Primary><Secondary>modules</Secondary></IndexTerm></Title>
|
|
<Para>To import an existing module into the current project:</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Choose Import Module from the File menu of the App Builder primary
|
|
window or Import from the Module menu of the Project Organizer.</Para>
|
|
<Para>The Import File dialog box will be displayed.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Change to the folder where the module (<Filename>.bil</Filename> suffix) file is saved.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Change the Import Format type, if necessary.</Para>
|
|
<Para>By default, BIL format is selected. If the file you are importing is a UIL file,
|
|
click the UIL button. The file will be converted to BIL format when it is
|
|
imported.<IndexTerm>
|
|
<Primary>importing</Primary>
|
|
<Secondary>module in UIL format</Secondary>
|
|
</IndexTerm><IndexTerm>
|
|
<Primary>UIL format</Primary>
|
|
<Secondary>importing modules in</Secondary>
|
|
</IndexTerm><IndexTerm>
|
|
<Primary>modules</Primary>
|
|
<Secondary>importing in UIL format</Secondary>
|
|
</IndexTerm>
|
|
</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Change Import By method, if necessary.</Para>
|
|
<Para>By default, Import By Copy is selected. If you want to import the module
|
|
by reference rather than making a copy of it, click the Reference button.</Para>
|
|
<Note>
|
|
<Para>Import By Reference, which causes module files to be shared, can be
|
|
dangerous, since the actual module file may be changed or deleted
|
|
inadvertantly.</Para>
|
|
</Note>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Double-click on the module to be imported in the Files list.</Para>
|
|
<Para><Emphasis>Or,</Emphasis> select the file and click Import.</Para>
|
|
<Para>The module will be added to the current project the next time you save the
|
|
project.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.13" Role="Procedure">
|
|
<Title>To Save a Module<IndexTerm><Primary>modules</Primary><Secondary>saving</Secondary></IndexTerm><IndexTerm><Primary>saving</Primary><Secondary>modules</Secondary></IndexTerm></Title>
|
|
<Para>All modules in a project are saved when you save the project. If you want to
|
|
save individual modules, you can do so in the Project Organizer.
|
|
</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Display the Project Organizer by choosing Project Organizer from the File
|
|
menu of the App Builder primary window.</Para>
|
|
<Graphic Entityref="ABUG.proj.fig.4" Id="ABUG.proj.igrph.4"></Graphic>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>In the module array of the Project Organizer select the module you want to
|
|
save.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Choose Save from the Module menu.</Para>
|
|
<Para>If you have saved the module previously during this App Builder session,
|
|
the module will be saved without comment.</Para>
|
|
<Para>If this is the first time you have saved the module, the Save BIL File dialog
|
|
box will be displayed, with the name of the selected module (with a <Filename>.bil</Filename>
|
|
suffix) in the Enter file name field.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Change to the folder where you want to save the module, if necessary.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Save or press Return.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.14" Role="Procedure">
|
|
<Title>To Rename a Module<IndexTerm><Primary>renaming</Primary><Secondary>modules</Secondary></IndexTerm><IndexTerm><Primary>modules</Primary><Secondary>renaming</Secondary></IndexTerm></Title>
|
|
<Para>Use Save As from the Module menu of the Project Organizer to rename a
|
|
module. When you save the current project, the new module name will replace
|
|
the old name in the project (<Filename>.bip</Filename>) file. The original module will still be in the
|
|
project folder, but it will not be part of the project. To save a module without
|
|
affecting the project, see
|
|
<!--Original XRef content: '&xd2;To Export a Module&xd3; on page 16'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.proj.mkr.7">.</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Display the Project Organizer by choosing Project Organizer from the File
|
|
menu of the App Builder primary window.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Select the module you want to rename.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Choose Save As from the Module menu.</Para>
|
|
<Para>The Save BIL File dialog box will be displayed, with the name of the
|
|
selected module (with a <Filename>.bil</Filename> suffix) in the Enter file name field.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Type a file name in the Enter file name field.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Save or press Return.</Para>
|
|
<Para>The new module name will replace the old name in the project (<Filename>.bip</Filename>) file
|
|
the next time you save the project.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.15" Role="Procedure">
|
|
<Title Id="ABUG.proj.mkr.7">To Export a Module<IndexTerm><Primary>modules</Primary><Secondary>exporting</Secondary></IndexTerm><IndexTerm><Primary>exporting</Primary><Secondary>modules</Secondary></IndexTerm></Title>
|
|
<Para>Do the following to save a <Emphasis>copy</Emphasis> of a module in the current project. The current
|
|
project is not affected when you export a module. A new module is created,
|
|
which is not part of the current project; the original module remains as part of
|
|
the project.</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>From the File menu of the App Builder primary window choose Export
|
|
Module and select one of the currently open modules from the submenu
|
|
displayed.</Para>
|
|
<Para><Emphasis>Or,</Emphasis> in the Project Organizer select the module to be exported in the module
|
|
array and choose Export from the Module menu.</Para>
|
|
<Para>The Export File dialog box will be displayed, with the selected module
|
|
name in the Enter file name field.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Type a new file name in the Enter file name field</Para>
|
|
<Para><Emphasis>Or,</Emphasis> change to the folder where you want to save the module and type a file
|
|
name in the Enter file name field.</Para>
|
|
<Para>If you want to save a version of the module in the current folder, do not
|
|
change folders. Simply give the module a different name.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Export or press Return.</Para>
|
|
<Para>A copy of the selected module has been created.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.16" Role="Procedure">
|
|
<Title>To Save a Module in UIL Format<IndexTerm><Primary>exporting</Primary><Secondary>module in UIL format</Secondary></IndexTerm><IndexTerm><Primary>UIL format</Primary><Secondary>saving module in</Secondary></IndexTerm><IndexTerm><Primary>modules</Primary><Secondary>saving in UIL format</Secondary></IndexTerm><IndexTerm><Primary>saving</Primary><Secondary>module in UIL format</Secondary></IndexTerm></Title>
|
|
<Para>To save a module in UIL (user interface language) format instead of BIL
|
|
(builder interface language) format:</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Choose Export Module from the File menu of the App Builder primary
|
|
window and select the module you want to export from the submenu that is
|
|
displayed.</Para>
|
|
<Para><Emphasis>Or,</Emphasis> in the Project Organizer select the module to be exported and choose
|
|
Export from the Module menu.</Para>
|
|
<Para>The Export File dialog box will be displayed, with the selected module
|
|
name in the Enter file name field.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Change to the folder where you want to save the module, if necessary.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Select Save As UIL (above the Enter file name field).</Para>
|
|
<Para>The file name suffix will change from <Filename>.bil</Filename> to <Filename>.uil</Filename>.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Type a file name in the Enter file name field, if necessary.</Para>
|
|
<Para>If the name in the Enter file name field is OK, leave it as it is.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Click Export or press Return.</Para>
|
|
<Para>The file will be saved with a <Filename>.uil</Filename> suffix.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
</Sect1>
|
|
<Sect1 Id="ABUG.proj.div.17">
|
|
<Title Id="ABUG.proj.mkr.8">Showing, Hiding, and Removing Modules</Title>
|
|
<Para>For a small project you may always want to show all modules. For a large
|
|
project with many modules you may want to show only one or two modules at
|
|
a time. Use the Project Organizer to show and hide modules, and to remove
|
|
modules from projects. The Project Organizer displays icons for all of the
|
|
modules that comprise a project. In the Project Organizer you can display or
|
|
hide the interfaces for selected modules and you can remove modules from a
|
|
project.
|
|
</Para>
|
|
<Graphic Entityref="ABUG.proj.fig.5" Id="ABUG.proj.igrph.5"></Graphic>
|
|
<Sect2 Id="ABUG.proj.div.18" Role="Procedure">
|
|
<Title Id="ABUG.proj.mkr.9">To Show a Hidden Module<IndexTerm><Primary>modules</Primary><Secondary>showing</Secondary></IndexTerm><IndexTerm><Primary>showing modules</Primary></IndexTerm></Title>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Display the Project Organizer by choosing Project Organizer from the File
|
|
menu of the App Builder primary window.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Double-click the module icons in the module array of the Project Organizer
|
|
that you want to show.</Para>
|
|
<Para><Emphasis>Or,</Emphasis> select the module icons and choose Show from the Module menu.</Para>
|
|
<Para>The user interfaces for the selected modules will be displayed.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
<Note>
|
|
<Para>If a module you want to show is in a different project, you will first
|
|
have to open the other project. See
|
|
<!--Original XRef content: '&xd2;To Open an Existing Project&xd3; on page 9'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.proj.mkr.4"> for
|
|
instructions.</Para>
|
|
</Note>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.19" Role="Procedure">
|
|
<Title>To Hide a Shown Module<IndexTerm><Primary>modules</Primary><Secondary>hiding</Secondary></IndexTerm><IndexTerm><Primary>hiding modules</Primary></IndexTerm></Title>
|
|
<Para>To hide a module that is displayed (to clean up the workspace so that you can
|
|
more easily work on another module, for instance):</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Display the Project Organizer by choosing Project Organizer from the File
|
|
menu of the App Builder primary window.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Select the modules in the module array that you want to hide.</Para>
|
|
<Para>Select one module by clicking mouse button 1 on it. To add to the selection
|
|
click mouse button 2 on other modules. To select a number of adjacent
|
|
modules drag-select with mouse button 1 or mouse button 2, starting above
|
|
and to the left of the first module to be selected.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Choose Hide from the Module menu.</Para>
|
|
<Para>The user interfaces for the selected modules will be hidden.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
<Sect2 Id="ABUG.proj.div.20" Role="Procedure">
|
|
<Title>To Remove a Module from a Project<IndexTerm><Primary>projects</Primary><Secondary>removing a module from</Secondary></IndexTerm><IndexTerm><Primary>modules</Primary><Secondary>removing from project</Secondary></IndexTerm><IndexTerm><Primary>removing module from project</Primary></IndexTerm></Title>
|
|
<Para>When you remove a module from the current project, the module file will still
|
|
exist in the project folder, but it will no longer be part of the project. The
|
|
module file name will be removed from the project file (<Filename>.bip</Filename> suffix) the next
|
|
time the project is saved. With the appropriate project open, do the following
|
|
to remove one or more modules from the project.</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Display the Project Organizer by choosing Project Organizer from the File
|
|
menu of the App Builder primary window.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Select the modules in the module array that you want to remove.</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Choose Remove from the Module menu of the Project Organizer.</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
</Sect2>
|
|
</Sect1>
|
|
</Chapter>
|
|
<!--fickle 1.14 mif-to-docbook 1.7 01/02/96 10:11:44-->
|