PxPlus Visual Studio Code Extension
The PxPlus Visual Studio Code extension is an extension for Visual Studio Code to enable working with PxPlus programs.
⚠️ Important: A local PxPlus 2024 or a WindX PxPlus 2026 (or newer) that is properly activated with any license type is required.
Functionality
- Create new PxPlus programs
- Opening and editing existing PxPlus programs
- Working with binary PxPlus programs
- Working with text-based PxPlus programs
- PxPlus syntax highlighting
- PxPlus code navigation
- PxPlus program error diagnostics
- Compiling and listing of PxPlus programs
- Auto Complete based on PxPlus language elements (directives, mnemonics, system functions, system parameters, system variables) and the current document
- Compare binary PxPlus programs
- View properties for binary PxPlus programs
How To Setup
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.
⚠️ Important: A local PxPlus 2024 or a WindX PxPlus 2026 that is properly activated with any license type is required.
Open the Visual Studio Code settings by clicking the Gear button in the bottom left corner and then click Settings.
Expand the Extensions node and then expand the PxPlus node.
Under PxPlus Path, 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, then you also need to specify which file extensions Visual Studio Code should consider a text-based PxPlus program.
- Under Text Program File Extensions, you can add a file extension to the list by clicking the Add Item button and entering a .xxx file extension and clicking OK. You can repeat this step multiple times to add more then one file extension. By default the only extension on the list is .pxprg.
If pointing to a WindX Plugin you also need setup the WindX connection.
- Under the WindX sub-heading, you can specify what type of WindX connection to use and then provide the WindX server IP address or hostname, the port, and whether the host is using SSL/TLS.
If using WindX SSH you also need to setup the SSH connection info.
- Under the WindX-SSH sub-heading you can enter the Username and then click Set password to securely save the SSH password. You will also need to specify the path to PxPlus on the WIndX SSH host.
If you plan to compile or list PxPlus programs, then you also should specify the output directories and file extensions.
- Under the Conversion sub-heading you can enter the Compiled Output Directory and/or the Listed output Directory. You can also optionally specify a file extension to be added to the out file for both compile and list.
For more details on these settings click Here.
Workspace Specific Settings
If you work on multiple projects you may want different settings for the different projects. For example for one project you want Suppress LET on and 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 uncommenting 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 tool tip with the name without spaces.
Using the Extension
With the extension set up, you can now work with PxPlus programs. You can create new PxPlus programs, open and edit existing PxPlus programs, as well as compile and list PxPlus programs.
To Create New PxPlus Programs:
From the File menu or from the Welcome screen, select New File. You can also right click in the Explorer and select PxPlus -> Create New PxPlus Program.
A list of possible file types to create will display. From the list, select Create a PxPlus Program.
Use the Save dialog to choose a pathname for your new program.
To 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:
- Click on the PxPlus icon on the top right of an Edit window and select Add PxPlus Folder to Workspace.
- Click the Open PxPlus Folder button in the Explorer window when no folders are open.
- Click the PxPlus -> Add PxPlus Folder to Workspace menu item from the Explorer right click menu.
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:
- Click on the PxPlus icon on the top right of an Edit window and select Compile or List. This will allow you to select a folder or folders to perform the operation on the contents.
- Click the PxPlus -> Compile or PxPlus -> List menu item from the Explorer right click menu. This will take the current selection of file and folders in the Explorer and perform the operation on the contents.
Any PxPlus programs or text-based PxPlus programs that are selected or in the selected directories or sub-directories of the selected directories will be compiled or listed.
Code Navigation
You can navigate to different parts of PxPlus programs using either the bread crumb menu at the top of the tab by clicking the .... You can also us the Outline section in the Explorer.
You will see all labels, functions, classes and methods defined in the program listed and you can jump between them by just clicking on them.
Compare Binary Programs
⚠️ Important: PxPlus 2026 is required.
If you have a binary PxPlus program open in the editor you can right click anywhere in the editor and select the PxPlus submenu and then click Compare Programs. This will launch the PxPlus program compare utility. For details about this utility see Here.
Program Properties
⚠️ Important: PxPlus 2026 is required.
If you have a binary PxPlus program open in the editor you can right click anywhere in the editor and select the PxPlus submenu and then click Program Properties. This will launch the PxPlus program properties utility. For details about this utility see Here.
Settings
PxPlus
| Setting |
Description |
Default |
| Pxplus Path |
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. - You can add new extensions via the Add Item button - Edit existing extensions via the pencil icon beside the item. - Delete extensions via the X icon beside the item. |
.pxprg |
| Max Number Of Problems |
Controls the maximum number of problems reported for PxPlus programs. |
100 |
WindX
| Setting |
Description |
Default |
| Using Windx |
Specify WindX connection type (No, Simple CS, NThost, SSH ). |
No |
| Server |
Specify IP address or host name of the WindX host (ignored if Using Windx is set to No). |
|
| Port |
Specify port of the WindX host (ignored if Using Windx is set to No). Reminder: Default port 4093 is used by the Simple Client Server and default port 10000 for NTHost or the Application Server. |
|
| Secure |
Specify if WindX host is using SSL/TLS (ignored if Using Windx is set to No or SSH). |
off |
WindX-SSH
| Setting |
Description |
Default |
| User |
Specify 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 a SSH password securely. - Click the Clear password button to remove a saved SSH password. |
|
| Pxplus Path |
Specify remote path of PxPlus on the WindX host (ignored unless Using WindX is set to SSH). |
|
Conversion
⭐ Reminder: These settings can be overridden by workspace specific settings. For more details click Here.
| Setting |
Description |
Default |
| Compiled Output Directory |
Specify path where compiled programs are created. |
|
| Compiled File Extension |
Specify file extension used for compiled programs. |
|
| Listed Output Directory |
Specify path where listed programs are created. |
|
| Listed File Extension |
Specify file extension used for listed programs. |
|
Language Preferences
⭐ Reminder: These settings can be overridden by workspace specific settings. For more details click Here.
| Setting |
Description |
Default |
| Lowercase Directives |
Displays the code with lowercase directives. |
off |
| Lowercase Variables |
Displays the code with lowercase variables. |
off |
| Mixed Case Variables |
Displays the code with mixed case variables. |
on |
| Suppress LET |
Displays the code without LET directives. |
off |