<!-- $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&numsp;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&numsp;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&numsp;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&mdash;the project file (<Filename>.bip</Filename> suffix) and all of the module files (<Filename>.bil</Filename>
suffixes)&mdash;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&numsp;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&numsp;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&numsp;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-->
