|
PxPlus Visual Studio Code Extension |
The PxPlus Visual Studio Code extension is an extension for Visual Studio Code to enable working with PxPlus programs.
It provides the following functionality:
See the tutorial How to Set Up PxPlus Visual Studio Code Extension.
(The PxPlus Visual Studio Code extension was added in PxPlus 2024.)
|
1. |
Download and install Visual Studio Code from the Visual Studio Code website https://code.visualstudio.com/ for your platform (i.e. Windows). If you are new to Visual Studio Code, this website is a great resource to learn more about it. |
|
2. |
On the Activity Bar on the left side of Visual Studio Code, click the Extension icon. This displays the Extensions view and the Extensions Marketplace. |
|
3. |
Find the PxPlus extension by entering PxPlus in the Search Extensions in Marketplace input box. |
|
4. |
In the displayed list, click on PxPlus and then click the Install button to install the PxPlus extension. |
Before you can use the PxPlus Visual Studio Code extension, you must tell the extension where PxPlus or a PxPlus WindX Plug-in is installed:
|
5. |
Open the Visual Studio Code settings. To do this, click the Gear icon in the bottom left corner and select Settings. |
|
6. |
Expand the Extensions node and select PxPlus. |
|
7. |
Under the PxPlus Path sub-heading, enter the path to the directory where the PxPlus executable is located (i.e. C:\PVX Plus Technologies\PxPlus 2024 or C:\PVX Plus Technologies\WindX Plugin 2026). |
If you plan to work with text-based PxPlus programs, you must specify which file extensions Visual Studio Code should consider as text-based PxPlus programs:
|
8. |
Under the Text Program File Extensions sub-heading, add a file extension to the list by clicking the Add Item button. Enter a .xxx file extension and then click OK. To add more than one file extension, repeat this step as many times as needed. By default, the only extension in the list is .pxprg. |
If pointing to a WindX Plug-in, you must also set up the WindX connection:
|
9. |
Under the WindX sub-heading, specify what type of WindX connection to use. Then provide the following: the WindX server IP address or host name, the port, and whether the host is using SSL/TLS. |
If using WindX SSH, you must also set up the SSH connection information:
|
10. |
Under the WindX-SSH sub-heading, enter the Username and then click Set password to securely save the SSH password. You must also specify the path to PxPlus on the WindX SSH host. |
If you plan to compile or list PxPlus programs, then you should also specify the output directories and file extensions:
|
11. |
Under the Conversion sub-heading, enter the Compiled Output Directory and/or the Listed Output Directory. You can also optionally specify a file extension to be added to the output file for both compile and list. |
For a description of these and other settings, see PxPlus Extension Settings.
(Support for WindX connections was added in PxPlus 2026.)
If you work on multiple projects, you may want different settings for different projects. For example, for one project, you may want Suppress LET On, and for another project, you want it Off. This can be accomplished with workspace-specific settings, which override global settings.
Click the PxPlus > Edit Workspace Settings menu item from the Explorer right click menu. This will create or open an existing pxpvsc.ini file in the workspace root directory. Within this file, you can uncomment the settings you want to override and specify the value you want to use for this project.
The settings name in the INI file match the settings name without spaces from within the Settings screen. If you hover over the setting in the Settings screen, you can see a tooltip with the name without spaces.
(Support for workspace-specific settings was added in PxPlus 2026.)
Once the extension is set up, you can work with PxPlus programs. You can:
To create a new PxPlus program, use one of the following methods:
Open and Edit Existing PxPlus Programs
To start editing PxPlus programs, you first need to add a PxPlus folder to the workspace. This is initiated by using one of the following methods:
This will allow you to select a PxPlus folder to add to the workspace.
Any PxPlus programs or text-based PxPlus programs that are opened via this workspace will be recognized as a PxPlus program by Visual Studio Code. This enables all the features and allows PxPlus programs to be edited.
Compile or List PxPlus Programs
To compile a text-based PxPlus program or to list a binary/tokenized PxPlus program, use one of the following methods:
Any PxPlus programs or text-based PxPlus programs that are selected or in the selected directories (or their sub-directories) will be compiled or listed.
(Support for compiling or listing PxPlus programs was added in PxPlus 2026.)
To navigate to different sections within a PxPlus program, use one of the following methods:
The list includes all labels, functions, classes and methods defined in the program. Select an item in the list to jump to its location in the code.
(Support for code navigation was added in PxPlus 2026.)
To compare binary programs:
|
1. |
Open a binary PxPlus program in the editor. |
|
2. |
Right click anywhere in the editor. |
|
3. |
Select the PxPlus sub-menu. Select the Compare Programs option. |
|
4. |
The PxPlus Program Compare Utility is launched. |
(Support for comparing binary programs was added in PxPlus 2026.)
View Properties for Binary Programs
To view binary program properties:
|
1. |
Open a binary PxPlus program in the editor. |
|
2. |
Right click anywhere in the editor. |
|
3. |
Select the PxPlus sub-menu. Select the Program Properties option. |
|
4. |
The PxPlus Program Properties Utility is launched. |
(Support for viewing binary program properties was added in PxPlus 2026.)
When a PxPlus program is open and you begin typing, Auto Complete displays suggestions for all PxPlus language components (directives, mnemonics, system functions, system parameters, system variables) and the current document.
Click the arrow to the far right of a suggestion to expand it and view its description. To manually trigger Auto Complete, press Ctrl + Spacebar.
(Support for Auto Complete based on PxPlus Language elements was added in PxPlus 2026.)
The PxPlus extension settings are described below, grouped by category: PxPlus, WindX, WindX-SSH, Conversion and Language Preferences.
|
Setting |
Description |
|
Pxplus Path |
(Required) Specify the path to the directory where the PxPlus executable is located (i.e. C:\PVX Plus Technologies\PxPlus 2024 or C:\PVX Plus Technologies\WindX Plugin 2026). |
|
Text Program File Extensions |
Specify which file extensions Visual Studio Code should consider a text-based PxPlus program. (Default: .pxprg) To add a new extension, click the Add Item button. To edit an existing extension, click the Pencil button beside the item. To delete an extension, click the X button beside the item. |
|
Maximum Number Of Problems |
Controls the maximum number of problems reported for PxPlus programs. (Default: 100) |
|
Setting |
Description |
|
Using Windx |
Specify the WindX connection type. Available selections are No, Simple CS, NThost, SSH. (Default: No) |
|
Server |
Specify the IP address or host name of the WindX host (ignored if Using Windx is set to No). |
|
Port |
Specify the port of the WindX host (ignored if Using Windx is set to No). Note: |
|
Secure |
Specify whether WindX host is using SSL/TLS (ignored if Using Windx is set to No or SSH). (Default: Off) |
|
Setting |
Description |
|
User |
Specify the operating system login username of the WindX host (ignored unless Using WindX is set to SSH). |
|
Password |
Securely manage the operating system login password of the WindX host (ignored unless Using WindX is set to SSH). Click the Set password button to save an SSH password securely. Click the Clear password button to remove a saved SSH password. |
|
Pxplus Path |
Specify the remote path of PxPlus on the WindX host (ignored unless Using WindX is set to SSH). |
|
Setting |
Description |
|
Compiled Output Directory |
Specify the path where compiled programs are created. |
|
Compiled File Extension |
Specify the file extension used for compiled programs. |
|
Listed Output Directory |
Specify the path where listed programs are created. |
|
Listed File Extension |
Specify the file extension used for listed programs. |
|
Setting |
Description |
|
Lowercase Directives |
Displays the code with lowercase directives. (Default: Off) |
|
Lowercase Variables |
Displays the code with lowercase variables. (Default: Off) |
|
Mixed Case Variables |
Displays the code with mixed case variables. (Default: On) |
|
Suppress LET |
Displays the code without LET directives. (Default: Off) |
How to Set Up PxPlus Visual Studio Code Extension
