ch32.htm

linux-unix130.linux.and.unix.ebooks130 linux and unix ebookslinuxLearning Linux - Collection of 12 E

		<TD ALIGN="LEFT" VALIGN="TOP">middle </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Adjust </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Motif--resizes objects and acts as a go to pointer for </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">			<P>

		</TD>

		<TD ALIGN="LEFT" VALIGN="TOP">			<P>

		</TD>

		<TD ALIGN="LEFT" VALIGN="TOP">scrollbars </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">			<P>

		</TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Drag </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">OPEN LOOK--resizes objects </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">right </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Menu </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Motif--activates and selects from pop-up menus </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">			<P>

		</TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Custom </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">OPEN LOOK--activates and selects from pull-down and pop-up menus </TD>

	</TR>

</TABLE>



</CENTER>

<P>In addition to specifying the interaction model that you want to use on the command

line, you can also specify the application that you want to load into ObjectBuilder.

This is done by specifying the application name as an option on the command line.

For example, the following command would start ObjectBuilder and load the sample

application using the OPEN LOOK interaction model:<FONT COLOR="#0066FF"></FONT>

<PRE><FONT COLOR="#0066FF">uib -openlook sample

</FONT></PRE>

<CENTER>

<H3><A NAME="Heading7<FONT COLOR="#000077">ObjectBuilders Main Window</FONT></H3>

</CENTER>

<P>After ObjectBuilder is started, its main window comes up on your screen. This

window is illustrated in Figure 32.1.</P>

<P>The ObjectBuilder main window allows you to control all aspects of the ObjectBuilder

session. There are nine options available from the window: five pull-down menus,

three selection options, and one message area. Each of these options is described

in detail next. 

<P>

<a href="../art/32/32fig01.gif">Figure 32.1.</a> The ObjectBuilder main window.



<P>

<CENTER>

<H4><A NAME="Heading8<FONT COLOR="#000077">The File Menu</FONT></H4>

</CENTER>

<P>The File menu contains the standard file-related options available in most visual

tools. The File menu is shown in Figure 32.2. 



<P>

<a href="../art/32/32fig02.gif">Figure 32.2.</a> The File menu. 



<P>Table 32.3

describes each of the options available in the File menu. <BR>

<FONT SIZE="4"></FONT>

<CENTER>

<P><FONT SIZE="4"><B>Table 32.3.</B> File menu options. </FONT>

<TABLE BORDER="0">

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT"><I>Option </I></TD>

		<TD ALIGN="LEFT"><I>Description </I></TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Clear </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Clears the current application and initializes ObjectBuilder to begin a new application.

					</TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Save </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Saves the complete application using the current name. If a name has not been assigned

			to the application, you are prompted for one. </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Save As </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Saves the application interface currently being edited via a dialog box. It also

			allows you to save only the configuration and help files of the application. </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Load </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Loads the application specified in the Load dialog box. </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Append Subobject </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Inserts the interface object specified in the Append dialog box into the current

			application. </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Revert to Disk </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Discards all edits made during the current session and reloads the last saved version

			of the application from disk. </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Exit </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Exits ObjectBuilder. </TD>

	</TR>

</TABLE>



</CENTER>

<CENTER>

<H4><A NAME="Heading9<FONT COLOR="#000077">The Edit Menu</FONT></H4>

</CENTER>

<P>This pull-down menu provides the basic editing features required to build an application.

The options are shown in Figure 32.3. 



<P>

<a href="../art/32/32fig03.gif">Figure 32.3.</A>The Edit menu. 



<P>A description of

each option can be found in Table 32.4. <BR>

<B></B>

<CENTER>

<P><FONT SIZE="4"><B>Table 32.4.</B> Edit menu options. </FONT>

<TABLE BORDER="0">

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT"><I>Option </I></TD>

		<TD ALIGN="LEFT"><I>Description </I></TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Undo </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Operates as either a stack of operations (you move backward through operations) or

			as a toggle (selecting negates the last operation performed and selecting the option

			again restores it) </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Subclass </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Invokes the Subclass editor for any subclassed object in your application </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Help </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Invokes the help editor </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP">Properties </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Invokes the properties dialog box </TD>

	</TR>

</TABLE>



</CENTER>

<CENTER>

<H4><A NAME="Heading10<FONT COLOR="#000077">The View Menu</FONT></H4>

</CENTER>

<P>This menu gives you access to three functions that assist you in building and

debugging the application. The View menu is shown in Figure 32.4. 



<P>

<a href="../art/32/32fig04.gif">Figure 32.4.</a> The

View menu.



<P>The <TT>Hidden Objects</TT> function provides a menu of all of the hidden objects

in your application. Objects are hidden if their initial state is either <TT>OI_ACTIVE_NOT_DISPLAYED</TT>

(this is the case with pop-up or pull-right menus) or <TT>OI_NOT_DISPLAYED</TT>,

meaning the object is not visible at that time. Additionally, the <TT>OI_abbr_menu</TT>

object and all its derived classes are always treated as hidden objects.</P>

<P>When the <TT>Hidden Objects</TT> function is selected, the Hidden Objects dialog

box is displayed, as in Figure 32.5. 



<P>

<a href="../art/32/32fig05.gif">Figure 32.5.</a> The Hidden Objects dialog box.



<P>When you click on an object name in the scroll menu, that object is displayed

and can then be modified in the same manner as any other object. Clicking on the

name a second time hides the object. The <TT>HIDE ALL</TT> and <TT>SHOW ALL</TT>

buttons can be used to display and hide all objects in one step. If an object is

not hidden when the <TT>CLOSE/DISMISS</TT> button is pressed, then it remains visible.

But it is still a hidden object within the application at runtime.</P>

<P>The <TT>Status</TT> <TT>and</TT> <TT>Error</TT> <TT>Log</TT> function displays

the Status Log window that is shown in Figure 32.6. 



<P>

<a href="../art/32/32fig06.gif">Figure 32.6.</a> The Status Log window.





<P>In this window you find all error messages and help messages that were issued since

the ObjectBuilder session started. Pressing the <TT>CLEAR</TT> button removes all

messages from the log. The <TT>CLOSE/DISMISS</TT> button closes the Status Log window.</P>

<P>The <TT>Simulation Trace</TT> function provides a running log of events, including

interaction with all register callbacks, generated while ObjectBuilder is in <TT>RUN

MODE</TT>. The Simulation Trace window is shown in Figure 32.7. 



<P>

<a href="../art/32/32fig07.gif">Figure 32.7.</A> The Simulation Trace window.



<P>The Filter menu allows you to determine which callback types are displayed. The

Print menu allows you to determine which elements of the callback you want to display.

You can display any or all of the following:



<UL>

	<LI>The event that called the callback

	<P>

	<LI>The callback

	<P>

	<LI>The object and argument

	<P>

	<LI>The parameters

</UL>



<CENTER>

<H4><A NAME="Heading11<FONT COLOR="#000077">The Palette Menu</FONT></H4>

</CENTER>

<P>A palette contains objects that can be used in an application. These objects are

a source of new instances of OI objects, user subclasses, and user-created objects.

The Palette menu has two options: Palettes and Load. The Palettes option provides

a pull-right menu that lists all available palettes. The Palettes menu is shown in

Figure 32.8. 



<P>

<a href="../art/32/32fig08.gif">Figure 32.8.</a> The Palettes menu.



<P>Table 32.5 describes the purpose of each palette. <BR>



<CENTER>

<P><FONT SIZE="4"><B>Table 32.5.</B> The available palettes. </FONT>

<TABLE BORDER="0">

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT"><I>Palette </I></TD>

		<TD ALIGN="LEFT"><I>Description </I></TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP"><TT>all_OI</TT> </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Contains all displayable OI objects </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP"><TT>default</TT> </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">For users who can readily identify most objects </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP"><TT>dialog</TT> </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Contains all dialog boxes </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP"><TT>editor</TT> </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Contains objects for building custom attribute editors </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP"><TT>minfootprint</TT> </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Positions all OI objects so the palette occupies the minimum amount of screen space

					</TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP"><TT>novice</TT> </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Contains icons and labels for all OI objects and is helpful until you are familiar

			with the objects and how to use them </TD>

	</TR>

	<TR ALIGN="LEFT" rowspan="1">

		<TD ALIGN="LEFT" VALIGN="TOP"><TT>terse default</TT> </TD>

		<TD ALIGN="LEFT" VALIGN="TOP">Lists all OI objects by the name found in the OI library </TD>

	</TR>