Using BlueZone VBA

BlueZone Plus VBA

Using BlueZone Plus VBA

In order to run BlueZone Plus VBA, you must install BlueZone Plus VBA using the BlueZone InstallShield Wizard.

SEE Installing BlueZone VBA for more information.

Once BlueZone Plus VBA have been successfully installed, BlueZone Plus VBA is accessed by selecting Macro from the BlueZone MenuBar.

NOTE Once BlueZone Plus VBA is installed, the native BlueZone Macro feature will be disabled and replaced by BlueZone Plus VBA.

The first time you launch a BlueZone session, a VBA project (.bvp) will automatically be created using the same name as the configuration file that launched the BlueZone session. A BlueZone Macro ToolBar will appear, and the BlueZone Plus VBA menu will look similar to the one shown here:

BlueZone VBA Menu Items

New

New is used to create a new BlueZone Plus VBA project. You can create a project with any name you wish by selecting New from the BlueZone Plus VBA Macro menu.

A standard Windows file dialog will be presented. Choose any name you wish and click the Open button. A BlueZone Plus VBA project with that name will be created. The new project name will now appear at the top of the BlueZone Plus VBA menu.

Open

Open is used to open an existing BlueZone Plus VBA project. Only one BlueZone Plus VBA project can be active at a time.

Save

Save is used to save the currently active BlueZone Plus VBA project.

Save As

Save As is used to save the currently active BlueZone Plus VBA project under a different name.

Close is used to "close down" BlueZone Plus VBA. If you are not going to be using BlueZone Plus VBA for a while you may want to close it down so it is not active.

ToolBar

ToolBar is a toggle used to either turn on or off the BlueZone Plus VBA Macro ToolBar.

Macros

Macros is used to display the BlueZone Plus VBA Macro dialog which will display all of the existing macros in the currently active BlueZone Plus VBA project.

Record New Macro

Record New Macro is used to start the recording of a new BlueZone Plus VBA macro.

Visual Basic Editor

Visual Basic Editor is used to launch the Visual Basic Editor or sometimes called the IDE.

Properties

Properties is used to access the configurable properties of BlueZone Plus VBA. The configurable properties of BlueZone Plus VBA are:

Auto Play ----

Play Macro on Startup: If you want a macro to automatically play when the BlueZone session is launched, check the checkbox and enter the name of the macro you wish to play. The "path" is not necessary, just the name of the macro.
Play Macro on Connect: If you want a macro to automatically play upon connection to the host, check the checkbox and enter the name of the macro you wish to play.
Play Macro on Disconnect: If you want a macro to automatically play upon disconnection from the host, check the checkbox and enter the name of the macro you wish to play.

ToolBar ----

Show Button Labels on Toolbar: This option toggles the text labels on the ToolBar on or off.
Customize: Use the Customize button to access the following options that are used to customize the way the VBA ToolBar is presented.

Menu Buttons ----

Use the following three options to control what features show on the VBA ToolBar.

Show Play Macro Button

Show Record Macro Button
Show VBA IDE Button

Macro Buttons ----

The Add, Rename and Delete buttons are used to add macros to the VBA Toolbar. When you add a macro, a button will also be assigned to that macro.

Add
Rename
Delete

Creating a BlueZone Macro Project

To create a project:

Select Macro:New from the MenuBar.
Give the project a name, and click the Open button. BlueZone Plus VBA project names can contain spaces.
You will be prompted to the create the file. Click the Yes button.

The name of the project will be displayed at the top of the Macro menu as shown in the above example. You can now start recording macros which will be part of the newly created project.

The BlueZone Plus VBA Macro Dialog

The BlueZone Plus VBA Macro Dialog is used to run, debug, edit and delete BlueZone Plus VBA macros.

To launch the BlueZone Plus VBA Macro dialog, select Macros from the Macro menu. The Macros dialog will be displayed as shown:

NOTE Only macros that are part of the active BlueZone Plus VBA project will be displayed.

Dialog Buttons

Run

The Run button is used to run BlueZone Plus VBA macros.

To run a BlueZone Plus VBA macro:

Choose the desired macro from the list and click the Run button.
The macro will now run.

Cancel

The Cancel button is used to close the BlueZone VBA Plus Macro dialog.

Step Into

The Step Into button is used for debugging purposes and will launch the Visual Basic Editor in the debug mode.

To step into a BlueZone Plus VBA macro:

Choose the desired macro from the list and click the Step Into button.
The Visual Basic Editor will launch in the debug mode.
You can start debugging the macro.

Edit

The Edit button is used for editing purposes and will launch the Visual Basic Editor in the edit mode.

To edit a BlueZone Plus VBA macro:

Choose the desired macro from the list and click the Edit button.
The Visual Basic Editor will launch in the edit mode.
You can start editing the macro.

Create

The Create button is used if you want to create a macro from scratch inside the Visual Basic Editor.

To create a macro from scratch:

Enter the name of the macro you want to create in the Macro name edit box.
Click the Create button.
The Visual Basic Editor will launch.
You can start creating the macro.

Delete

The Delete button is used to delete a macro.

To delete a macro:

Select the desired macro from the list.
Click the Delete button.
The macro will be deleted.

Recording a BlueZone Plus VBA Macro

To record a macro:

Select Record New Macro from the Macro menu or click the Record Macro button on the BlueZone Macro ToolBar. The Record Macro dialog will be displayed as shown:

Give the macro a name and an optional description. Macro names can not contain spaces.
Choose whether or not you want to create a Toolbar Button for this macro.
Choose whether or not you wish for the macro to Auto-Play on Connect.
Choose whether or not you want to Edit Macro when Done Recording.
Click the OK button.
Start entering the keystrokes that create the macro.
When you are finished recording, select Stop Macro Recording from the Macro menu or click the Stop Recording macro button on the BlueZone Macro ToolBar.