Copyright: ®1996 NuMega Technologies, Inc.


Contents

Please choose a help topic from the list below.

 	Step-by-Step guide to using NuMega VB/Namer

  	How to obtain support

 	Technical reference

 	Quick-Start on NuMega VB/Namer

Contents

10


Support
Support Services

 This section provides instructions on support services available from NuMega Technology, Inc.

In order to save your time and provide you with the best possible support, we would like you to do a few things before you contact us. These simple steps will get you the fastest answer to your questions.

•	Have you read the manual? Did you look under the table of contents and the index? Did you re-check the manual?

•	Have you used the search feature of the help system?

•	Have your serial number ready. It was on the registration card stuck on the inside cover of the manual.

•	Have your version number ready. Use the Help...About dialog from any window to see the version number.

 By Phone

Technical support is available from 9:00am to 5:00pm, Monday through Friday, EST. The technical support phone number is (603) 889-2386. Have version number, customer number and product serial number ready.

 By Fax

You can fax your questions to (603) 889-1135 24 hours a day. Don’t forget to include version and registration numbers. Provide as much detail as possible in your fax.

 By E-Mail We also provide tech support via electronic mail. Send e-mail to internet info@numega.com. Don’t forget to include version and registration numbers. Include any code examples as a file attachment to the email. You can also visit our web site at http://www.numega.com.

Support

10002


Guide
Step-By-Step Guide

 This section provides step-by-step help on using NuMega VB/Namer.

1) Load a project using the File...Open Project dialog.

2) Choose the files you want to process from the Project Window file list.

3) Set options using the Options dialog.

3) Press F5 to start the process.

4) To stop or interrupt the process, press Shift+F5.

 You can run the Wizard at any time by choosing the Wizard help menu option.

Guide

10003


Technical_Reference
Technical Reference

 This section provides a technical discussion on how NuMega VB/Namer operates.

NuMega VB/Namer scans projects for objects, and then checks the NameBase to compare each object name to the reccomeneded name. If you have enabled the 'Edit...Rename' menu, then each object will be renamed.

What NuMega VB/Namer Does

NuMega VB/Namer modifies the names of controls, forms, modules, types and classes. NuMega VB/Namer operates on all the files selected from the project window. The standard naming prefix as contained in the NameBase is afixed to the front of the object name. NuMega VB/Namer uses the VB/CodeReview NameBase to determine prefixes for objects. NuMega VB/Namer works with VB3 and VB4 projects with an extension of VBP or MAK.

VB/CodeReview NameBase

The NameBase consists of the files CLASSNAM.NDX and CLASSNAM.DBF. CLASSNAM.NDX contains all known Visual Basic object class names. CLASSNAM.DBF contains the actual prefixes to use. These two files work together to provide a consistant, manageable database of class names and standard prefixes.  The NameBase is stored in dBASE III+ file format, not as MS Jet. The database engine used is Visual/db, also from NuMega Technology, Inc. Visual/db can index over 200 records per-second, offers memory based (buffered) file storage, and runs in the applications process making it many, many times faster than equivalent Jet calls. Also, Visual/db only requires about 75K of overhead vs several megabytes for MS Jet.

How NuMega VB/Namer Works

NuMega VB/Namer checks all project objects to ensure they have the proper, standard prefix. If they do not it is added after prompting for a prefix to use.

Be sure to see the important notice about using the StdNamer Add-In and NuMega VB/Namer at the same time!

Note that you can edit, add or delete NameBase entries using the Manage NameBase menu dialog.

Technical_Reference

10004


quick start
Quick-Start

 This section is a quick start on using NuMega VB/Namer

To get running right away with VB/Formatter, use the Wizard. In general the process is to load a project, choose options, and then process it.  See the Step-By-Step directions for fastest results.

quick start

4000


Tips Of the Day
Tip Of the Day

The Tip Of the Day feature shows pointers maximizing your usage of this VB/Formatter.

•	You can disable tips by clearing the Show Tips At Startup option. You can see tips from most Help menus.

•	Choose OK when done viewing tips.

•	You can cycle through the tips one at a time by choosing the Next Tip button.

•	The More Tips button shows this help file, which lists all tips.

More Tips

Tips Of the Day

2000


More Tips Of the Day
Tip Of the Day

Following is a list of all tips.

•	You can skip running the Wizard each time you start VB/Namer by clearing the 'Show At Startup' box on the Wizard screen.

•	You can skip seeing Tip of the Day each time you start VB/Namer by clearing the 'Show At Startup' box on the Tip of the Day screen.

•	You can edit the VB/Namer NameBase(tm) by using the 'Tools...Manage NameBase' menu option.

•	You can start processing by pressing F5.

•	You can stop processing by pressing Shift+F5.

•	You can get context sensitive help almost anywhere by pressing F1.

•	The System Information display is located under the Help..About screen.

•	You can determine version and other important information from the System Information option of the Help...About menu.

•	You can save system information to a disk file by using the File..Save menu dialog from the Syste Information display.

•	You can setup the printer by using the Print menu, and then choosing Setup.

•	You can change the page orientation from the Print Setup menu.

•	You can change the font used for printing by choosing the File...Print Setup menu, and then choosing the Font button.

•	You can exit the Tip Of The Day dialog by pressing Escape!

•	Double-clicking on the running man in the Wizard dialog shows our fearless leaders name.

More Tips Of the Day

2001


Wizard Tab 1
NuMega VB/Namer Wizard - Tab 1

This tab is where you choose the project to process.

Step-By-Step Instructions

Technical Reference

Wizard Tab 1

3000


wiz_choose_file
Choose File List

Choose a file from the drop-down list to process. To select a new file, choose the Browse button, which will call the open file dialog.

wiz_choose_file

11038


wiz_finish
Finish Button

Choose this button to start the processing using the information entered into the Wizard.

wiz_finish

11039


wiz_help
Help Button

Choose this button to show help on using the Wizard.

wiz_help

11040


Wiz_last
Last Button

Choose this button to move to the previous or last step in the Wizard process.

Wiz_last

11041


wiz_next
Next Button

Choose this button to move to the next step in the Wizard process.

wiz_next

11042


wiz_our_developer
Application Splash Screen

This area contains the name of the application using the wizard.

wiz_our_developer

11043


wiz_show_at_startup
Show At Startup Option

When this checkbox is set (has an X in it) then the Wizard is automatically shown when the program starts. When the checkbox is cleared, the Wizard is not automatically started.

Note that you can always run the Wizard by choosing the Help...Wizard menu dialog from most program windows.

wiz_show_at_startup

11044


wiz_tab1
Wizard - Tab1

Click this here to move to Tab1.

wiz_tab1

12004


wiz_tab2
Wizard - Tab2

Click here to move to Tab2.

wiz_tab2

12003


wiz_tab3
Wizard - Tab3

Click here to move to Tab3.

wiz_tab3

12002


Wizard Tab 2
NuMega VB/Namer Wizard - Tab 2

This tab is where you choose files of the the project to process.

Step-By-Step Instructions

Technical Reference

Wizard Tab 2

3001


wiz_select_files
Choose Files To Process

Choose the files in the list you want to process.

wiz_select_files

11037


Wizard Tab 3
NuMega VB/Namer Wizard - Tab 3

This tab is where you choose how to process selected files.

Step-By-Step Instructions

Technical Reference

Wizard Tab 3

3002


WizMsg1
Query Load Project

You need to choose a Visual Basic project to review before VB/Formatter can review it. There is no project specified under Tab 1 of the Wizard. Move to Tab 1 and choose a project.

You can choose:

•	Yes to load a project file now.

•	No to go back to the Wizard.

WizMsg1

3003


WizMsg2
Query Exit Wizard

You chose not to load a project. Do you want to exit the Wizard at this time?

You can choose:

•	Yes quit the Wizard now.

•	No to go back to the Wizard.

WizMsg2

3004


opfn
Open File

You need to choose a file to open.

You can choose:

•	Ok after choosing the file you want to load.

•	Cancel to end this dialog without choosing a file.

•	Network to navigate to network drives.

opfn

5000


Results Display

This window shows the results of the processing.

Results Display

11036


T_231435000049
Confirm Process Project

You have opened a project. Would you like to review this project now?

You can choose:

•	Yes to start the project review now.

•	No to return to the Project level view of the project.

StartNow

6000


StartNow
Query Open Project

You have opened a project. Would you like to review this project now?

You can choose:

•	Yes to start the project review now.

•	No to return to the Project level view of the project.

StartNow

6000


NameBase Manager

This dialog lets you enable/disable messages. You can assign messages to any event class, warning level and color. You can also enable or disable any event or groups of events. When done, close the dialog and you will be prompted to save the changes you have made.

NameBase Manager

5500


review
Review Window

This dialog lets you view the re-naming process in the project under review. You can also print the display to the printer by choosing the File...Print dialog.

review

5700


Project
Project Window

This windows shows you the project files for the loaded project. From this window your can invoke the Message Manager dialog, start and stop reviews or load new projects for review. To start a review, load a project and then press F5. To Stop a running review, press Shift+F5.

Project

5400


NameBase
VB/CodeReview NameBase

The VB/CodeReview NameBase consists of several files. These files contain all known object class names, and a standard prefix which is used to classify each object class.

NameBase

10008


Classname Definition
Classname

The Classname of an object defines the type of object. For example, Visual Basic forms are objects of type FORM. Text boxes are object of type TextBox, Labels are type Label. Each object in Visual Basic has a unique classname. Normally, you only see the classname in the Properties window of Visual Basic. When you select an object and press F4 to view the Properties window for that object, its classname is shown at the top of the Properties window, as shown below.

Classname Definition

10007


Object Naming
Enter Object Name

While scanning a form for object names, an object was found without the standard naming prefix for objects of the Classname shown. The dialog shows the file name containing the object, the object classname, the current object's name, from the .Name property. Presented as a default new object name is the standard naming prefix for this object class and a name created from the caption property of the object.

You can choose:

•	Choose OK when done entering new name

•	Choose Cancel to stop processing

Object Naming

10005


NameBase Note
Important Note

When new control classes are added to a Visual Basic project with the StdNamer utility in use as a VB 4 Add-In, the NameBase may get updated with the new classes. While you can have the StdNamer Add-In running when using NuMega VB/Namer, do not use the 'Manage NameBase' menu option as any changes you make could overwrite changes made from the StdNamer Add-In, and vice versa. In general, if you want to edit the NameBase, make sure the StdNamer Add-In is not active.

NameBase Note

11006


Remove All Blank Lines

This command will remove all blank lines from the selected project files. It overrides any other settings, including any settings that add formatting lines to a project.

Remove All Blank Lines

11005


Accept All Changes

Choosing this option will automatically accept all changes to the processed file. The original file will be overwritten with the changed files and you will have no chance to reject pr cancel. Use this option with care.

Accept All Changes

10006


Query Start Now

To start processing now, press Yes. To skip processing right now, press No.

Query Start Now

11021


Confirm Delete Object Entry

You are about to delete an object entry from the NameBase.

You can choose:

•	Press OK to delete this entry.

•	Press Cancel to stop the delete process, keeping this entry.

Note that presing OK will delete this entry from this copy of the NameBase.

Confirm Delete Object Entry

11504


Query Cancel Get Object Name

When prompted with the Get Object Name dialog, you chose to cancel. To exit this process press Yes, to continue processing using the default object name press No. To cancel this process, and stop processing, press Cancel.

Query Cancel Get Object Name

12000


NameBase Changed

You have just made a change to the NameBase. You cannot undo this change, however, if you do not save the changes when you exit the NameBase manager, the current NameBase will not get updated.

NameBase Changed

11503


Enter Prefix

You are entering a new object classname into the NameBase. You are now prompted to enter a unique prefix that objects of this class will use. Enter the new prefix to use and press OK to add it to the NameBase. Press Cancel to skip adding a new prefix to the NameBase.

Enter Prefix

11502


Edit Classname

You are editing classname in the NameBase manager. Edit the classname, but be careful to make sure that what you enter is really an object classname.

•	Press OK to save changes made to the NameBase.

•	Press Cancel to skip adding the changes to the NameBase.

Edit Classname

11505


Add New Classname

You are entering a new classname in the NameBase manager. Enter the new classname to use and press OK to add it to the NameBase. Press Cancel to skip adding a new classname to the NameBase.

Add New Classname

11501


Query Save Changes

You are about to leave the NameBase manager. You have made changes to the copy of the NameBase, and are now asked if you want to save these changes.

•	Press Yes to save the changes you made.

•	Press No to exit and skip saving the changes you made.

•	Press Cancel to stay in the NameBase manager.

Note that pressing No will lose any changes you made to the copy of the NameBase you were working with.

Query Save Changes

11500


Show Help
Query Show Help

To see help on using NuMega VB/Namer then press Yes now. To skip seeing help, press No.

Show_Help

11022


Query Cancel Backup

You chose to cancel selecting a file name for manual backup. If you want to cancel the backup and then cancel the overwrite, press Cancel now. To continue without backing up press OK now.

Note that pressing OK means the file will not be backed up before overwriting it with the results of the processing.

Query Cancel Backup

11023


Options

This dialog is where you enter program options for NuMega VB/Namer operations.

General Settings

View Results As Process Runs

Set this option print a status messages to the display window as the process runs. Clear this options for fastest performance.

Show Tool Tips

Set this option to have tool tips displayed when the mouse is held over a toolbar button for 2 seconds or more; clear to show no tool tips.

Show Status Bar

Set this option to display the status bar; clear to hide status bar.

Prompt Before Saving Changes

Set this option to have NuMega VB/Namer show you the changes made and prompt you accept or reject them before overwriting the original file. You can choose to reject the changes, accept the changes or cancel the process.

Accept All Changes

Set this option to have NuMega VB/Namer overwrite without prompting you to save the original file.

Show Tool Tips

Set this option to have tool tips shown as the mouse moves over tool bar buttons.

File Backups

A backup system is provided as processing can change file data. If the backup system is enabled, there are two methods of backup provided, Automatic and Prompted. Automatic backup is reccomened and it the default.

Backup Files Before Changing

Set this option enable backups of the entire project before any processing is done. There are two methods of backup available, Automatic and Prompted.

Automatic File Backup

Set this option to automatically make backups of the entire project.

Prompted File Backup

Set this option to prompt and let you choose to make backups of the entire project.


Learn New Class

While scanning a form for object names, an object classname was found that is not in the known classes of the NameBase. The dialog shows the file objects classnameand prompts for you to enter a unqiue prefix to use for objects of this class.

You can choose:

•	OK when done entering new prefix.

•	Cancel to stop processing.

Learn New Class

11024


Print Dialog

This dialog lets you print.

You can choose:

•	OK to print.

•	Setup to set the page orientation (landscape or portrait) and choose the printer to use.

•	Cancel to exit without saving any changes to the print setup.

Also see the Print Setup dialog.

Print Dialog

1300


Printer Setup Dialog

This dialog lets you set or view printing options, and choose a printer to use.

You can choose:

•	OK to accept the printer as defined.

•	Cancel to exit without saving any changes to the print setup.

•	Font to set the font to use when printing.

Also see the Print dialog.

Printer Setup Dialog

711


Query Confirm Process

You are about to process a project file, and you are now prompted to backup the project before any changes are made to it.

You can choose:

•	Yes to backup the project and proceed.

•	No to skip backing up the project, and then proceed.

•	Cancel to cancel the processing.

Query Confirm Process

11087


No Printers Defined

There are no printers defined on this system. You need to define a printer and then try to print.

No Printers Defined

11086


Choose Print Item

You chose the OK button, but you did not select anything to print.

Print Dialog

Print Setup Dialog

Choose Print Item

11085


Long Filenames
File Not Found

The file your tried to open could not be opened for some reason.

•	Check network connections and try again.

•	Long filenames are not supported under Windows 3.x.

Long Filenames

716


Backup System

Before modification, if the backup options are set, files are backed up to a subdirectory labeled \Backup under the program directory. For example, if the program directory is C:\NuMega, then the root backup directory would be C:\NuMega\Backup.

Each project to be backed up is then given its own sub directory under the backup root directory. An extension in the range of 000 to 999 is assigned to the subdirectory. This extension is the backup version number. If it seems strange to have a directory with an extension don’t worry! Its perfectly legal and fully supported under Windows 3.x, Windows95 and Windows NT, its just not common!

As each project is saved into its backup directory, the backup directory extension is incremented. For example, if you were backing up C:\Program Files\Microsoft Visual Basic\Redtop.vbp, then the first time this project would be saved it would be under C:\NuMega\Backup\Redtop.000. The next would be C:\NuMega\Backup\Redtop.001 and so on. When extension 999 is hit, the number wraps around and starts overwriting the oldest backup copy.

The files are placed into their subdirectory without modification. To restore a project copy the files from the backup directory or load them into Visual Basic.

Note that the oldest backup copy is not necessarily the backup with the lowest extension number.

Backup System

12005


Processing Interrupted

The processing of the selected file(s) has been interrupted; either from a menu action that requires processing to stop, or from pressing the escape key. To re-start processing press F5.

Processing Interrupted

13008


Query Cancel Format

The escape key was pressed while processing was underway. You are now prompted to cancel or continue the processing.

You can choose:

•	Yes to save stop processing now.

•	No to resume processing.

Query Cancel Format

12007


wiz_browse
Wizard - Browse

Choose this button to select a project file to process.

wiz_browse

13006


wiz_options
Wizard - Options

Choose this button to set program options for this formatting session.

wiz_options

13007


Answer Wizard
NuMega Answer Wizard

The NuMega Answer Wizard is used in many new NuMega products. It provides a more user friendly means to access help. Type in your question in plain english; or choose a previous help topic from the drop down. Press enter or choose search.

If the Answer Wizard cannot match your request or you simply want to search help directly just press F1 anywere. Choosing the Help Options tab of the Answer Wizard will let you access the most common help functions.

Answer Wizard

1961