Formatter is a programers tool.   It uses your text to build Professional looking Comment Boxes to paste into your Visual Basic programs.   However, Formatter can be used for any text that you want to reformat.

The Formatter Screen with sample text. If you would like to see an example, click the Show Sample option in the menu.   After you have read the short text, press the Format button.   The program will then display the same text, but it is now reformatted using the current parameters.   You may change the parameters as often as you like.   Just remember to click the Show Sample option each time to renew the text.

There is a text field at the top of the screen that says: Enter the Top and Bottom line format above.   This is what will form the top and bottom lines of the Format box (the solid rows of asterisks '*').

Below that is another text field that controls the left and right sides of the formatted text.

Both of these Format fields may be changed to any format or length you like, or you may delete them completely.   Instead of asterisks '*' you may prefer the Pound sign '#' or any other character.   You may replace them with your name or E-mail address if you like.   They may include Spaces as well as any Numbers, Letters or Special Characters.   So you can set this up any way you want and change it as often as you like.

Between the 2 text fields are the controls for the Format box itself.   The control on the left determines the number of Separator Bars above and below the Text!   The default is 2 rows of asterisks '*' at the Top and Bottom.   If you decide to use one or more special formats, I would suggest that you save the format lines in a Text file.   Then all you have to do is to Copy & Paste them into the program when you want to use them.

The control on the right determines the number of spaces between the Border and the Text!   The default is 4 spaces.   This lines up with the standard tabbing in VB but you may change it to whatever you like.

The Command Buttons:

Clear! Clears the Text Box.
Format! Formats whatever is in the Text Box according to the controls above.
Copy! Copies the formatted text to the clipboard where you can paste it into your VB program.
Save text! Temporarily saves the data in the Text Box so you can try different settings with the same text.   It is only saved for as long as Formatter is running.
Restore text! Restores the Text the way it was the last time you pressed the Save button.

The Left Align Check Box is used in conjunction with the RandyGrams program called Comments.   When you run Comments and the Left Align statement is encountered, it will automatically adjust the comments to be aligned with the Left Align statement instead of the code.   I use it when I want a block of comments but I don't want it indented several layers.

The Menu Options:

File >>> Open:   Opens a Text File on your PC.   You may have a special disclaimer or other text that you put into every VB file.
Edit >>> Un-Format:   Removes all the asterisks '*' and spaces at the front and back of the text.

Show Sample:   Prints brief instructions in the Text Box.   It's purpose is to test the way you have the controls set up.

There are other Menu Options available that should be self explanatory.
The actual program colors may be slightly different than the example above.

  • DownLoad   your free copy of   Formatter.Exe                         DownLoad   the   Formatter   VB.NET source files.