[Win32forth-cvs] win32forth/Help/html/IDE ClassBrowser.htm, NONE, 1.1 Code Window.htm, NONE, 1.1 Cr

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/win32forth/win32forth/Help/html/IDE
In directory sc8-pr-cvs9.sourceforge.net:/tmp/cvs-serv23503/Help/html/IDE

Added Files:
	ClassBrowser.htm Code Window.htm Creating a Toolbar.htm 
	Define a Menu.htm Editor.htm Form Designer.htm IDE.htm 
	IDEMenus.htm IDEToolbar.htm Overview.htm Project Navigator.htm 
	ProjectManager.htm PropertyForm.htm Splitter Windows.htm 
	Win32ForthIDE.htm 
Log Message:
Beginning of docs for the IDE. EAB

--- NEW FILE: ClassBrowser.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Untitled</title>
</head>

<body>

<h1 align="center">Class & Vocabulary Browser</h1><br><br>

The class and vocabulary browser allow browsing the code, objects and classes
the make up Win32Forth and the IDE.<br><br>

<img src="ClassesTab.gif" alt="" border="0">

<img hspace=50 src="VocabulariesTab.gif" alt="" border="0"><br><br>

Pressing the control key and clicking an item in the tree opens the source in the editor
for browsing.

</body>
</html>

--- NEW FILE: Win32ForthIDE.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
<html>
<head>
  <title>Win32ForthIDE</title>
</head>
<body>
<center>
<P><IMG SRC="Win32ForthIDE.ico" NAME="Graphic1" ALIGN=LEFT WIDTH=237 HEIGHT=235 BORDER=0><H1 align="center"><B>Win32ForthIDE</B></H1></P>
<P><h1 align="center">The Integrated Developement Environment<br>For<br>Win32Forth</h1></center></P>
<BR><BR><BR>
<HR>
The Win32ForthIDE is an integrated developement environment for the creating, compiling, testing, debugging and managing of applications
written in Win32Forth. It consists of a Multiple Document Interface Source Editor and Browser, a Class and Vocabulary
Browser, a Source Level Debugger, a Project Manager, a Forms Designer and an Image and HTML file viewer.<br><br>

Consider a screenshot of the IDE with a number of files opened.<br><br>

<center><img src="IDEWindow.gif" alt=""></center><br><br>

Click on the appropriate link following for more information.<br><br>

<A NAME="Index"></A>
<UL>
	<dl><dl><dl><dl><dl><dd>
	<LI><A HREF="IDE.htm">Overview</A>
	<LI><A HREF="Editor.htm">Editor</A>
	<LI><A HREF="ProjectManager.htm">Project Manager</A>
	<LI><A HREF="Form Designer.htm">Forms Designer</A>
	<LI><A HREF="ClassBrowser.htm">Class & Vocabulary Browser</A>
	<LI><A HREF="IDEMenus.htm">Menus</A>
	</dd></dl></dl></dl></dl></dl>

</UL>

For questions or further infomation regarding Win32ForthIDE, Win32Forth itself or any related topic
please go to the<a href="http://groups.yahoo.com/group/win32forth/">Win32Forth forum</a> <br>
</body>
</html>
--- NEW FILE: Project Navigator.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Project Navigator</title>
</head>

<body>
<h1><center>Project Navigator</center></h1><br><br>

While Project Manager keeps track of files in a project, Navigator complements it by
keeping track of the code in the project. This allows quickly finding where code is defined in a large
multi-file project.

<center><img src="Navigator.gif" alt="" border="0"></center><br><br>

The root item is the name of the current project.Tracking a project ( click the track button )
scans all the files in a project and builds the Navigator tree from the code. 
Code is separated into objects and classes, global (i.e not private to a class or object ) definitions,
private definitions, methods and data ( consisting of values, variables, ints etc.)
Clicking a tree item will expand the list. When a code item is clicked the source file where it can be found and the line number
is displayed in the status bar. Clicking the "Goto" button will open the source file and positin the cursor at the line
number where the code is located. 
Note that in the methods tree the item in brackets is the parent class or object of the method.

In the <A HREF="Preferences.htm">IDE Preferences dialog </A>an option is available to allow or prevent the inclusion of library files
when tracking code in a project.<br><br>

In the bottom window of the Project Navigator is the Bookmark window. This allows setting markers in source files and the quick return to specific
points in such files.

Click "Add Bookmark" to set a marker at the current point in a source file. To return to that point simply click the line text 
in the listbox.

"Clear Bookmarks" clears all bookmarks.
</body>
</html>

--- NEW FILE: Form Designer.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Help using Form Designer</TITLE>
</HEAD>
<BODY LANG="en-US" DIR="LTR">
<P><IMG SRC="Forthform.gif" NAME="Graphic1" ALIGN=LEFT WIDTH=237 HEIGHT=235 BORDER=0><H1 align="center"><B>IDE Form Designer</B></H1></P>
<h2 align="center">The Form Tool for Win32Forth</h2><BR clear="LEFT">

<HR>
Form Designer, as its name suggest, is a tool for designing forms in the IDE. It is based on the stand-alone ForthForm application. All the
functionality of ForthForm is included in Form Designer.
<BR><BR><BR>Follow the links below to learn more.
<A NAME="Index"></A>
<UL>
	<dl><dl><dl><dl><dl><dl><dd>
	<LI><A HREF="Overview.htm">Overview</A>
	<LI><A HREF="Creating a Form.htm">Creating and compiling a form</A>
	<LI><A HREF="Using Forms.htm">Using a compiled form</A>
	<LI><A HREF="Creating a Toolbar.htm">Creating and testing a toolbar</A>
	<LI><A HREF="Define a Menu.htm">Defining and compiling a menu</A>
	<LI><A HREF="Splitter Windows.htm">Generating a splitter window</A>
	<LI><A HREF="PropertyForm.htm">Generating a property sheet template</A></dd></dl></dl></dl></dl></dl></dl>

</UL>

</BODY>
</HTML>

--- NEW FILE: Overview.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<title>Overview</title>
</HEAD>
<h1 align="center"><B>Overview</B></h1>

The Form Designer window is displayed by clicking on the Form designer tab in the IDE TabWindow.
<center><img src="FormDesignerTab.gif" width="240" height="621" alt="" align="absmiddle"></center>

The top window in the form designer tab contains the form toolbar. Many of the toolbar buttons are enabled or disabled depending on whether a form is opened and it contains any controls.
However, hovering the mouse cursor over a button will pop up a tooltip identifying the function of the button.

The bottom window contains two tabs. Clicking the "Status" tab displays information about the currently selected form and any control
selected. It also displays a "monitor" window which allows the setting of the runtime position of a form on the display monitor.

The "List of Forms" tab allows the viewing the names of all open forms. Clicking on the name of a form
 makes that form the active one and brings it to the foreground.

The Forms Designer tab can be detached into a floating window. This is done by selecting the "Float Form Designer Window"
 option from the IDE Preferences dialog.</A> When detached, newly created forms will be positioned relative to the
 location of the detached window. Thus, if using dual monitors, created forms will be displayed on the same monitor as
 the Form Designer window.

<P><A HREF="FF-Creating a Form.htm">Creating and compiling a form</A></P>
<P><A HREF="Forms Designer.htm#Index"><img src="ff-back.gif" align="absmiddle" border=0>Back to main page</A></P>
</BODY>
</HTML>

--- NEW FILE: Code Window.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Untitled</title>
</head>

<body>

<P><h1 align="center">Forms Code Window</h1></P><br><br>

The Forms Code Window allow adding code at design time to a form. It can be opened from the right-click
menu of a control or a form. Consider the below example.

<center><img src="Directory Demo.gif" alt="" border="0"></center><br><br>
<center><img src="Forms Code Window.gif" alt="" border="0"></center><br><br>

The top left pane of the Forms Code Window lists any open forms. The top right pane lists the controls of the selected
form as well as three other items - Global Code, Private Code and On_InitFunction. Clicking any of these or a control
will display any code entered for that item and allow editing said code.

Global Code - any code can be added here, e.g needed files, global variables or definitions etc. If any
controls for a form are global any code added here will be inserted after the controls definitions, thereby allowing
reference to the controls.

Private Code - Code that will be local to the form object. Again any code here will be inserted after controls
are defined.

On_InitFunction - this is a colon definition into which any initialization code can be added. It is added after private
code has been added. It is inserted as the last function in the On_Init: method of the form.

Controls - Code entered for a control will become part of a colon definition. This definition will have the name
On_NameOfControl e.g in the example form above btnDelete will have a function name On_btnDelete. These functions are
only created if code is entered for a control. Note that while code can be entered for all controls, not all
controls code is added to the form. Currently only code for Pushbuttons, Radiobuttons,Checkboxes, Listboxes, ComboListboxes and
Horizontal and Vertical Scroll bars added to a form. Any code added will then become part of a default Wm_Command-Func.

Please note that code for controls as well as the On_InitFunction become part of a colon definition. Be guided in your coding accordingly.

When a form is saved as a .ff file any code entered will be saved in a separate file under the same name but
with "_code" added to the name e.g Dirbox.ff, Dirbox.ff_code. If opening a .ff file a code file is searched for in the smae
directory as the form file. If found it is loaded, otherwise the form is loaded as if no code ever existed.

Refresh - updates the window with any added controls or forms. Typically, this is done automatically.

Save Code - saves any enter code. Normally any code added is saved automaticaly, but it is a good idea to save after
editing.

Test - opens the Win32Forth console to test the form. A temporary file, not the .frm file, is created and loaded to allow
for testing any code entered. Breakpoints can be set in the entered code to allow for debugging. While forms can also be tested
from the IDE ( click test from the form toolbar or the form's right-click menu )it is a recommended that such forms,
especially if significant code has been added, be tested from a fresh Win32Forth instance.

Close - close the Forms Code Window. The Code Window will also be closed when the last form is closed.

</body>
</html>

--- NEW FILE: IDEMenus.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>IDE Menus</title>
</head>

<body>

<P><h1 align="center">Menus</h1></P><br><br>

<h2>File</h2>
<pre>
New File - create a new empty source text file
Open File - open a new source text file
Close File - close active file
Save File - save active file, prompt for a name if not named
Save File As - save active file under a different name
Save All Files - save all modified files
Open Highlighted File - attempt to open highlighted file
Open HTML File - open html file for previewing as html
New HTML Source File - create a new file with default html formatting
Print - print active file
Page Setup - set print parameters e.g margins, paper size etc.
Exit - exit the IDE, same effect as Alt-F4
Recent Files List - recent text files that were opened

</pre>
<h2>Edit</h2>
<pre>
Undo - undo the last editing operation
Redo - redo the last editing operation
Cut - removes selected text and place it on the clipboard
Copy - copy selected text to the clipboard
Paste - paste text from clipboard into document at current location
Delete - deletes selected text. Does NOT place it on the clipboard
Line Cut - removes current line and places it on the clipboard
Line Copy - copies current line to the clipboard
Line Delete - deletes current line. Does NOT place it on the clipboard
Line Transpose - swaps text on current line with that of the previous line
Line Duplicate - inserts a copy of current line at current line position
Select All - selects all text in current document
Remove Selection - removes highlight from selected text.
Search - opens a dialog to allow entering text to search for 
Search Next - search forward in document for previously entered text
Search Previous - search backward in document for previously entered text
Search & Replace - opens a dialog to allow entering text for both search and replacing
Find Text In Files - opens a dialog to allow finding text in files
Insert Date - inserts date at current location in document
Insert Date & Time - inserts date and time at current location in document
Block comment - allows a group of specified lines to be commented out. 
Block uncomment - removes a previous block comment from a group of specified lines. 
Lower Case - converts the highlighted text to lower case. 
Upper Case - converts the highlighted text to upper case. 
</pre>

<h2>Project Menu</h2>

<pre>New - start a new project.

Open - open a previously saved project.

Save - save current project. A project is saved as a standard text file.

Save As - save a copy of the project.

Rename - rename current project i.e the root name.

<b>Build</b> - build project. The build file would be the main file of the project. Scans the build file
        for needs, include and fload statements and add specified files. Recurses found files. Note that the
		build file is highlighted with a red icon in the project tree.

ReBuild - Same as build except any files currently in the project are deleted first.

Set search path for build - set the path to search for files with option to save to disk.

<b>New Module</b> - creates a blank .f file, adds it to the module list and opens the file in the editor
             ready for editing.

Navigator - <A HREF="Project Navigator.htm">Project Navigator</A> tracks code in a project.

Add files to project - opens a dialog allowing single or multiple file selection.

Delete from project - deletes highlighted file.

Add open Forms - Add any saved open forms to the forms list.

</pre>
<h2>Form</h2>
<pre>
New - Create a new blank form of default size
Open - Open a single or multiple forms
Edit Properties - modify the properties of active form
Close Active Form - close active form
Close all - close all open forms
Save - save active form (.ff file)
Save as - save and allow changing the name of the active form
Save all modified - save any changed forms
Merge open forms - compile all open forms to a single text (.frm) file
Property form template - opens a dialog to allow generating a property sheet like template.
Compile - generate code to create form in a .frm file
Compile all - compile all open forms to .frm files 
Copy to clipboard - compile form and copy code to the Windows clipboard
Test - show how form will look at runtime
Create Toolbar - opens a dialog to allow generating a toolbar
Splitter Window Templates - assorted splitter window templates
Define menu - opens a dialog to allow defining a menu

</pre>
<h2>DexH</h2>
<pre>
</pre>
<h2>View</h2>
<pre>
Display Line Endings - shows the line ending characters which are usually not visible. 
Display White Space - shows spaces and tabs which are usually not visible. 
Display Line Numbers - shows numbers in the left hand margin to indicate how far down in the file the line is. 
Colorize Source - shows keywords and various other items of text in distinctive colors to allow for easy identification. Makes editing source code easier on the eyes and helps identify spelling errors. 
Browse - switches the display mode from simple text editing to hyperlinking. Right clicking words in a source file will jump to the definition of the word if it can be located. 
Preview as HTML - displays the current file as it would appear in a web browser. 
</pre>
<h2>Options</h2>
<pre>
Line Endings - allows specifying the character or characters to be used to terminate lines based on the target operating system custom. 
Create Backup Files - specifies that the original files should be saved as backup files before changes are made.
Remove trailing white space -
Ensure final line ending -
Save All Files Before Compile - writes any unsaved changes to the file system before performing the compilation process. This can prevent loss of changes if the machine crashes or hangs before the file could otherwise be saved.
Always compile main project file - compile main project file if checked, else compile active document
Set Tab Options - allows specifying how the Tab key should be handled. 
IDE Preferences - opens a dialog to allow setting personal preferences for the environment
Show Status Bar - toggles display of the status bar at the bottom of the window. 
Show Toolbar - toggles display of the toolbar just below the menu. 
</pre>
<h2>Tools</h2>
<pre>
</pre>
<h2>Window</h2>
<pre>
Tile Horizontally - displays the windows the full width of the client area with each active window the same size vertically. 
Tile Vertically - displays the windows the full height of the client area with each active window the same size horizontally. 
Arrange - allows positioning the active windows. 
Cascade - overlaps the windows so that their title bars are visible and stepped for easy location. 
Close All - closes all open edit windows. 
</pre>
<h2>Help</h2>
<pre>
Help For Highlighted ANS word - will open the ANS documentation to the section describing the selected ANS word. 
Win32Forth Documentation - opens the Win32Forth help in the default web browser. 
ANS Forth Standard - opens the ANS documentation in the default web browser. 
Win32Forth Project Group - opens the Win32Forth.org home page in the default web browser. 
Win32Forth Forum - opens the Win32Forth Yahoo discussion group home page in the default web browser. 
About - shows the customary credits and version numbers for the program
</pre>

</body>
</html>

--- NEW FILE: Splitter Windows.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Splitter Windows</title>
</head>

<body>
<h1 align="center">Generating splitter windows</h1>

To generate a splliter window first select "Splitter window templates" from
the tools menu. The following dialog will be displayed -
<IMG SRC="SplitterDialog.gif" BORDER=0>

The image buttons indicate the type of template that will be generated when the button is clicked. Hovering the mouse cursor over a button
also pops up a tooltip with a brief description.

The default action is to test a selected template. Other options are to copy the template
code to the clipboard for pasting in other source code, and to edit the code using the form editor.
If you want to save the source code to a file you can do so from the form editor.

<P ALIGN=LEFT><A HREF="Form Designer.htm#Index"><img src="back.gif" align="absmiddle" border=0>Back to main page</A></P>

</body>
</html>

--- NEW FILE: PropertyForm.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Property Sheet</title>
</head>

<body>
<P><h1 align="center">Generating a Property Form</h1></P>

<p> The Property Forms dialog allows the creation of a property sheet like template
using all open forms.</p>

<p align="center"><img src="PropertyFormDialog.gif" border="0"><br clear=0></p>

<h2><b>Defining a Property Form</b></h2>

Name - the name of the property form. If none is entered a default name will be provided.

<b>Caption</b> - The title of the property form.<br><br>

<b>Add Default Buttons</b> - if checked code for three default buttons will be generated.<br><br>

<b>Multi-line Tabs</b> - allow multiple rows of tabs if dialog is not wide enough.<br><br>

<b>Button Tabs</b> - Tabs will display like buttons when selected.<br><br>

Compile Forms to Disk - If checked, forms will be compiled to a separate file and then loaded. Note that
if the file name needs to be changed it will require unchecking the option and doing a
dummy test or edit. Subsequently reselecting the option will allow the choosing of the filename.

<b>Test</b> - compile and test using current selections.<br><br>

<b>Edit</b> - Compile and display source code in editor.<br><br>

<b>Clipboard</b> - compile and copy source code to the clipboard.<br><br>

<b>Close</b> - close the property form dialog.<br>

<hr>

<p><A HREF="Form Designer.htm#Index"><img src="back.gif" align="absmiddle" border=0>Back to main page</A></p>

</body>
</html>

--- NEW FILE: IDEToolbar.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Untitled</title>
</head>

<body>
<P><h1 align="center">ToolBars</h1></P>

The IDE rebar allows one-click access to many of the IDE functions. It consists
of three parts, (1) The Editor toolbar, (2) The Project Manager toolbar and (3) a combobox 
that allows a file containing a source word to be opened at the point where the word is defined.

<img src="IDEToolbar.gif"  alt="" border="0"><br><br>

Note that by dragging on any of the three handles the order of the toolbars can be rearranged for the 
current session.<br><br>

<h2>(1) Editor Toolbar</h2>
If the main window is active ( click on its caption if not ) positioning the mouse cursor over a button pops up a tooltip identifying the
button function. If no file is opened some buttons will be disabled.

<h2>(2) Project Manager Toolbar</h2>

This toolbar allows a new project to be defined, the opening of an existing project as well as 
the compiling of a project, among other things. Like the Editor toolbar, hovering the mouse over a button
will pop up a tooltip describing the function of that button.

<h2>(3) ComboBox</h2>
The drop down combobox control located in a rebar control can be used to quickly view the source for a word.
Simply type the word in the box an press enter. If valid, the file containing the source for the word
will be open at the point where the word is defined.

<P ALIGN=LEFT><A HREF="Win32ForthIDE.html#Index">Back to main page</A></P>

</body>
</html>

--- NEW FILE: IDE.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Untitled</title>
</head>

<body>

<h1 align="center">IDE Overview</h1>

The IDE has a number of other features that the user might find helpful.<br><br>

"View Source For" - typing a word in this textbox in the toolbar and pressing "Enter"
will search open the source for word if it is defined and position the cursor on the 
line where it it defined. Handy for quick look-ups when you can't remember the syntax for a word.

<b>"Directory viewer"</b> from the TabWindow-<br><br>
<center><img src="DirectoryTab.gif"  alt="" border="0"></center><br><br>

The directory window displays files matching a series of specifications. Right clicking in the window brings
up a number of options including changing a folder, moving up a level and how the files are displayed.
Select from the bottom combolist box which file filters to apply to the window. User defined specs
can also be added by clicking the filter button at the top of the window and following the prompt. 
Hovering the mouse cursor over these buttons will help identify the function of these buttons. 
Note that user defined specs are not saved when the IDE session has ended.

The top combolistbox keeps a history of all paths viewed. Selecting a path from this list will 
return the viewer to that path and display its files.

Double-clicking on a file in the directory window will open that file in the IDE. Most image
files as well as HTML files and text files will be viewed in native format. Binary files will be
displayed in hex format. Control and double-clicking a .htm file will open it in the editor for editing.

"Save Current Session/Reload Session" - available from the "Options" menu. 
The current project and any opened files and forms are saved in a default session file. When a session is reloaded
the same files and project will be reopened . Source files will be returned to the point of editing that they were at.

"IDE Preferences" - from the "Options" menu. 
Set various personal preferences for the environment.
</body>
</html>

--- NEW FILE: Define a Menu.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Untitled</title>
</head>

<body>
<h1 align="center">Defining  A Menu</h1>

The menu definition dialog allows a menu to be defined.
<img src="Define Menu Window.gif" alt="" border="0">

The menu is display in a treeview structure, with the menu name as the root item. The example dialog
displays the menu for ForthForm. Popups and submenus will have a + sign next to them.
Click on + to expand the tree item.

MenuText - the string text used for the menu strings as well as the menu name.

C Button - clears both menuext and name text.

Name - used to set and display the name for a Win32Forth :Menuitem.

Popup - add a popup item to the menu.

Submenu - add a submenu item to the menu.

MenuItem - add a menuitem to the menu. To make a :MenuItem type the name in the Name textbox.

MenuSeparator - add a menuseparator to the menu.

Note that the above options require the desired popup, submenu or menubar to be selected.

New - prompts to erase all entries and create a default menu.

Delete - Delete the selected menu item. The main menubar cannot be deleted.

Rename- rename the selected item. Alternatively the double click an item to edit it. Press enter to
save edited text.

Edit - compile the menu in W32F format and edit in Formpad.

Clipboard - compile the menu in W32F format and copy to the clipboard.

Save - Save the menu as a menu definition file (.mdf). This a standard text file loadable from
Win32Forth. It will always be saved in this format despite any future compiling extensions.

Load - Load a menu from a menu definition file or read a W32F menu definition from a Forth file.

<p><b>Test</b> - Test the defined menu.

Close - Close the dialog window.

<p><A HREF="Form Designer.htm#Index"><img src="back.gif" align="absmiddle" border=0>Back to main page</A></p>

</body>
</html>

--- NEW FILE: Creating a Toolbar.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Creating A ToolBar</title>
</head>

<body>
<h1 align="center">Creating A ToolBar</h1>

The toolbar dialog, the bitmap preview window and the toolbar bitmap preview window allow a toolbar to
be defined and tested.

<p align="center"><img src="Bitmap Preview Window.gif" width="600" height="62" alt="" border="0">
<img src="CreateToolbar Window.gif" width="598" height="454" alt="" border="0"><br clear=0>
<img src="Toolbar Preview Window.gif" width="600" height="62" alt="" border="0"><br clear=0>

The bitmap preview window displays the selected bitmap at the default dimensions. The toolbar bitmap preview window
simulates how the selected bitmaps will look in the toolbar when created.

<h2><b>Defining a toolbar</b></h2>

Name - the name of the toolbar. This is the minimum required to generate a toolbar.
With a name specified and no bitmap image a default toolbar will be generated using one of the Win32 API toolbar
bitmaps.

<b>Bitmap</b> - full path to the bitmap file that contains the toolbar images.<br><br>

<b>Exclude path</b> - if checked bitmap file is referenced without the path component.<br><br>

<b>Bitmap Info</b> - set the bitmap width and height.<br><br>

<b>Button Info</b> - set the width and height of each toolbar button.<br><br>

<b>Toolbar Options</b> - Check "Flat" if a flat toolbar is required, otherwise the toolbar will have raised buttons
Use "Show Button text" if buttons will display text strings.<br><br>

Toolbar Styles - These options should be self-explanatory or experiment to find out. Further information can be found in the
source code file "Toolbar.f".

<b>ToolBar Button-</b> Used to change the style, state, description and other information for a single button.<br><br>

Use "Add" to add an individual button to the toolbar, and then select the desired bitmap for this button
by left clicking in the bitmap preview window. The default style and state for the button is "Button" and "Enabled". These
can be changed by clicking the appropiate checkboxes.

If the "Auto Mode" option is selected a button will be automatically added when a bitmap in the bitmap preview window is clicked.
The clicked bitmap becomes the default for the added button.

If it is desired to change the bitmap for a button simply manuever to the desired button (first,last,previous,next), ensure
that "Auto Mode" is off and click the desired bitmap in the preview window.<br><br>

<b>Move Up/Move Down</b>- Use these buttons to reposition a button in the toolbar.<br><br>

Delete- Removes a button from the list. No confirmation is given.

Description- this can be the button name or description. It is used in the generation of button IDs
for the toolbar. If none is provided a default will be added.

<b>Tooltip</b>- tooltip text for the button.<br><br>

Button Text- optional button text. Note that "Show Button Text" should be enabled if text is to be displayed.

<b>Extra Button</b>- If this option is selected the button will not be displayed in the toolbar by default.<br><br>

Note that if a button has the "Separator style" option selected no bitmap will be displayed for the button.
In the Toolbar bitmap preview window a separator button is displayed as a white space.

<h2><b>Button Functions</b></h2>

<p><b>New</b> - Start with a default toolbar and clear button list.<br><br>

<b>Open</b> - Open a toolbar definition file (.tdf) with saved toolbar options.<br><br>

<b>Save</b> - Save options to file.<br><br>

Test - Compiles and displays a toolbar with the specified options. To modify and retest
close the open toolbar window first.

Source - Display source code for the toolbar in the FormPad. From there it can be copied to
the clipboard or saved to file.

<b>Refresh</b> - Updates button information display.<br><br>

Close - close the "Define Toolbar" dialog. This will also close the Bitmap Preview Window.

<hr>

<p><A HREF="Form Designer.htm#Index"><img src="back.gif" align="absmiddle" border=0>Back to main page</A></p>

</body>
</html>

--- NEW FILE: Editor.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Editor</title>
</head>

<body>

<h1 align="center">The IDE Editor</h1><br>

The IDE Editor is a standard multiple document interface editor based on the 
<a href="http://www.scintilla.org"> Scintila edit control.</a><br><br>

A lexer was written for the control which allows syntax highlighting for Forth source code.<br><br>

A source file can be opened from the editor toolbar <img src="EditorToolbar.gif" alt="" border="0"> or from
the <A HREF="IDEMenus.html">File Menu</A>. Hovering the mouse cursor over a button in the toolbar will popup 
a tooltip identifying the button function. Each source file will be opened in a separate window, and opened files can
then be arranged or tiled to preference ( from the Window menu ).

The Editor supports tabbed editing i.e opened files can be displayed in tabs above the editing window. This option is 
selected from the preferences dialog and allows quick switching between open files. The Files tab in the TabWindow
also allows switching between files.

<center><img src="FilesTab.gif" alt="" border="0"><br><br></center>

The editor is very functional and allows easy editing of source code files as well as multi-source projects. The interface 
is similar to most typical Windows programs and should be mostly familiar to users who have used other editors. It is best
learned by exploring and using but consider some highlights.

HTML source can quickly be previewed by pressing F10 or selecting from the "View" menu.<br><br>

DexH Document Extracter - extract documentation from source code.<br><br>

Search for text in files across folders.<br><br>

Optional create backup file when saving.<br><br>

</body>
</html>

--- NEW FILE: ProjectManager.htm ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Project Manager </title>
</head>

<body>

<h1 align="center">Project Manager</h1>
Click on the Project Manager tab. The following is a screenshot of an opened project. 
<center><img src="ProjectTab.gif" alt="" border="0"></center>

The name of the opened project is displayed at the root of the project tree.<br><br>

Files for an application are divided into the six categories shown: modules, forms, dlls,
resources, auxiliary files and docs.
 Modules - Forth .f files
 Forms - Form files, *.frm
 DLLs - any Dlls needed
 Resources - bitmap or icon files
 Docs - .htm and .txt files.
 Auxiliary - any other files

If any of categories contain files then clicking on that category name will expand the item and show
its files. Clicking on a selected file will open it in the editor for editing or browsing.

The Project toolbar <img src="Project Toolbar.gif" alt="" border="0">and menu allow access to other Project Manager functions. For the toolbar
hovering the mouse over a button will pop up a tooltip indicating the button's function.

<h2>Project Menu</h2>

<pre>New - start a new project.

Open - open a previously saved project. The name of the opened project is displayed in the statusbar.

Save - save current project. A project is saved as a standard text file.

Save As - save a copy of the project.

Rename - rename current project i.e the root name.

<b>Build</b> - build project. The build file would be the main file of the project. Scans the build file
        for needs, include and fload statements and add specified files. Recurses found files. Note that the
		build file is highlighted with a red icon in the project tree.

ReBuild - Same as build except any files currently in the project are deleted first.

Set search path for build - set the path to search for files with option to save to disk.

<b>New Module</b> - creates a blank .f file, adds it to the module list and opens the file in the editor
             ready for editing.

Navigator - <A HREF="Project Navigator.htm">Project Navigator</A> tracks code in a project.

Add files to project - opens a dialog allowing single or multiple file selection.

Delete from project - deletes highlighted file.

Add open Forms - Add any saved open forms to the forms list.

</pre>

The path name for a selected file is not shown in the treeview, however the full pathname is stored in the
project manager. Note too that even if more than one file references or includes the same file only
one copy is saved in the tree.

<h3>Compiling a project</h3>If the option "Always compile main Project file" ( from the Options Menu )
is checked then the opened project will be compiled when "Compile" is selected form the menu or toolbar. If not checked
then if the file in the active window is a source file it will be compiled.

</body>
</html>