skip navigation

AB-Cursor-Highlight

Quickly find your cursor

AB-Cursor-Highlight is an add-on, so it functions a little differently from indicators and drawing tools. Once installed and after NinjaTrader has been restarted, the add-on will start functioning immediately. You can customize the settings and toggle it on/off using the main NinjaTrader menu in the Control Center. You can find everything related to this add-on in the Tools | AB-Trading | Cursor-Highlight menu. There you will see options for Enabled and Configure. Enabled is a toggle (checkmark means enabled, no checkmark means disabled) and Configure will open a settings window.

All settings are saved to an XML file in the NinjaTrader 8\bin\Custom\AddOns\ABTrading directory within your Documents folder. That way everything is preserved across restarts. The settings file is updated whenever the Enabled status is toggled and whenever the settings are updated via the Configure menu option.

This add-on is pretty straight-forward and doesn't have much to configure. The screenshots mostly provide all the information you need, however, this page will provide an overview just in case something doesn't make sense to you.

keep me updated!

Download Instructions

You can download the latest version of AB-Cursor-Highlight here . Make sure you save the file somewhere you can find it easily -- your Downloads folder or your Desktop are usually the easiest places. If you wish to verify your download, the SHA-256 checksum is displayed below the download button for each release on the Downloads page.

Installation, Upgrades & Removal

installation

  1. Open NinjaTrader and go to the main control window (the one with the main program menu) and select Tools | Import | NinjaScript Add-On... [Installation screenshot 1]

  2. Navigate and find the ZIP file you downloaded. Select it and click "Open". NinjaTrader will install the file for you.

  3. Since this is an add-on, you will see multiple confirmation boxes asking if you are sure you want to install it:

    a. The first confirmation box informs you that this add-on will run automatically. Answer 'Yes'. [Installation warning 1] b. The second confirmation box informs you that the add-on must be compiled so it can be run. Answer 'Yes'. [Installation warning 2] c. The final message informs you that NinjaTrader must be restarted before the add-on will operate. Click 'Ok' to close the message box. [Restart warning]

  4. Restart NinjaTrader at your convenience.

  5. That's it, you're done!

upgrading

Upgrading involves removing the previous version and then installing the new version just as you did in the initial installation.

You MUST remove the previous version or NinjaTrader will fail to perform the upgrade. If you don't remove the previous version, you will see a dialog box saying "Import failed..." [Screenshot showing upgrade error]

  1. Follow the steps in the "Uninstallation" section below to remove the current (old) version.

  2. Now, follow the steps in the "Installation" section above to install the newest version. Just make sure you choose the newest ZIP (it will have the highest version number) and that will do the "upgrade" for you. Upgrading really is just installing the latest version. Your existing templates will be unaffected and will be automatically reapplied after the upgrade.

removal

It is recommended you remove any custom indicators from within NinjaTrader instead of deleting the file manually (though I've never experienced any problems manually deleting files). We will go through the recommended procedure here.

  1. On the main NinjaTrader Control Center window (the one with the main program menu), select Tools | Remove NinjaScript Assembly [DLL uninstallation screenshot 1]

  2. A new window will appear asking you to select which assembly you want to remove. Select AB_Cursor_Highlight_version (where '_version' is the currently installed version number) and click "Remove". [DLL uninstallation screenshot 2]

  3. NinjaTrader will display a confirmation dialog box asking if you're sure. You are. Say Yes.

  4. Assuming no errors, you will get a message stating that you must restart NinjaTrader to complete the removal. Click OK to close the message box. [DLL uninstallation screenshot 3]

  5. Click CLOSE on the "Remove NinjaScript Assembly" dialog box to close it. [DLL uninstallation screenshot 4]

  6. Restart NinjaTrader at your convenience.

  7. AB-Cursor-Highlight is now uninstalled. If you removed the add-on as part of the upgrade process, please follow the "Installation" section above to complete the upgrade.

Using In NinjaTrader

AB-Cursor-Highlight is an add-on. Therefore, there is nothing to 'add' to your charts like with an indicator or drawing tool. Instead, it simply attaches itself to all open chart windows and highlights the cursor using the configured 'active' colour if the mouse is over that window. If the mouse is not over the window, it colours the cursor using the configured 'inactive' colour.

Enable/Disable

Clicking the Enabled item in the Control Center | Tools | AB-Trading | Cursor Highlight menu will toggle cursor highlighting. If enabled, the cursor will be coloured using the 'active' colour in any chart window over which the mouse is hovering. If disabled, all chart window cursors will be reset to the 'inactive' colour and no highlighting will take place. The current enabled/disabled state is saved to the setting file and, thus, persist across restarts.

Configuration

Clicking the Configure item in the Control Center | Tools | AB-Trading | Cursor Highlight menu will open the settings window. Starting in Version 1.5, the settings window is divided into sections for the 'active' and 'inactive' cursor.

cursor colours

You can use the dropdown boxes to select the 'active' and/or 'inactive' colours. By default, the 'active' colour is 'Yellow' and the 'inactive' colour is 'DimGray'. This will affect the cursor while in 'crosshair' or 'global crosshair' modes.

label colours

Starting in Version 1.5, you can change the label colours independently of the cursor colour. By default, they are matched. If the "Match..." checkboxes are selected, labels will automatically use the cursor colour and the label colour selections will be ignored. If either "Match..." checkbox is cleared, the corresponding labels ('active' or 'inactive') will use the selected colour in the relevant label color dropdown box.

buttons

If you click the Apply button, your changes will be propagated to all chart windows immediately and will be written to the settings file so they persist across restarts. If you click the Cancel button, no changes will be made and the settings file will NOT be changed.

Parameters

Click on any of the options below to expand it and read a more detailed explanation of what the particular parameter does. This section will be updated with each new release version.

Active Cursor

Active crosshair colour

This colour will be used to 'highlight' the cursor within the chart window over which the mouse is hovering.
Default: Yellow

Match active label and cursor

If checked, the axis labels in the active chart window (where the mouse is hovering) will be coloured using the 'Active crosshair colour'. If unchecked, labels will use the 'Active label colour'.
Default: Checked

Active label colour

This colour will be used for axis labels within the chart window over which the mouse is hovering. If 'Match active label and cursor' is checked, this setting will be ignored.
Default: Yellow

Inactive cursor

Inactive crosshair colour

This colour will be used to colour the crosshair cursor within all chart windows over which the mouse is not hovering.
Default: DimGray

Match inactive label and cursor

If checked, the axis labels in the inactive chart windows (all windows where the mouse is not hovering) will be coloured using the 'Inactive crosshair colour'. If unchecked, labels will use the 'Inactive label colour'.
Default: Checked

Inactive label colour

This colour will be used for axis labels within all chart windows over which the mouse is not hovering. If 'Match inactive label and cursor' is checked, this setting will be ignored.
Default: DimGray

Buttons

Apply button

Clicking this button will close the settings window and propagate your choices to all open chart windows immediately. It will also update the settings file so your choices persist across restarts.

Cancel button

Clicking this button will close the settings window and discard any changes you have made. It will not update the settings file.

contact me

Want to stay updated on new releases? Have questions or found a bug? Want to submit a feature request? Feel free to email me by clicking the button below. I'll be happy to answer any questions you have, help you get the indicator set-up, or let you know about incorporating your suggestion(s) into future versions. If you know how to program for NinjaTrader or in C#/.NET in general and want to contribute, email me using the button below or file an issue or pull request in the git repo (preferred).

email me