/clipContentsDesigner

NVDA add-on to manage clipboard text.

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

Clip Contents Designer

This add-on is used to add text to the clipboard, which can be useful when you want to join sections of text together ready for pasting. The clipboard content can also be cleared an shown in browse mode.

Keyboard commands

  • NVDA+windows+c: Add selected text, Unicode braille characters which represent MathML objects, or the string which has been marked with the review cursor, to the clipboard.
  • NVDA+windows+x: Clear clipboard contents.
  • Not assigned: Copies to (or cuts from) the clipboard, with the possibility of being asked for a previous confirmation.
  • Not assigned: Shows the clipboard text in browse mode, or announces if clipboard is empty or has contents which can't be presented in a browseable message, for instance if files or folders are been copied from Windows Explorer.

Note: The above commands can be changed from NVDA menu, Preferences submenu, Input gestures dialog, Text review category.

Preferences Menu

  • Clip Contents Designer settings: Allows to set a separator which can be used to find the text segments once the entire added text is pasted. It's also possible to choose if the added text will be appended or prepended, if available actions (add, clear clipboard, emulate copy and emulate cut) should be performed inmediately or after confirmation, and if confirmations will be requested always, just if text is contained in the clipboard, or if clipboard is not empty. Furthermore, it's possible to change the format and maximum number of characters of the clipboard text which will be shown in browse mode. Please, be aware that increasing this limit may produce issues if the clipboard contains large strings of text. The default limit is 100000 characters.

Notes:

  • The above command can be changed from NVDA menu, Preferences submenu, Input gestures dialog, Configuration category.
  • Confirmations won't be requested when a message box of NVDA is still opened. In those cases, actions will be inmediately performed.

Changes for 11.0

  • Now it's possible to add text marked with the review cursor using standard commands of NVDA (NVDA+f9 and NVDA+f10). NVDA+windows+f9 is no longer used, for a better integration with the new NVDA+shift+f9 command.
  • Requires NVDA 2019.3 or later.

Changes for 10.0

  • Fixed a bug in the dialog used to show the clipboard text, when its title contains non latin characters.
  • Fixed a bug when using the emulate cut and copy features with an Arabic keyboard layout. This has been fixed by Abdel, added as an add-on author.

Changes for 9.0

  • Added the possibility of showing the clipboard text in browse mode.
  • Added an option to choose if confirmations will be required if clipboard is not empty, for instance, if files or folders are been copied.
  • Requires NVDA 2018.4 or later.

Changes for 8.0

Changes for 7.0

  • In the dialog to configure the Emulate copy and Emulate cut functionalities at installation, if you choose no, the commands for these features will be removed, so that you can restore the normal behavior for control+c and control+x.

Changes for 6.0

  • Added options to choose if available actions should be performed after confirmation.
  • Added Emulate copy and Emulate cut commands, which could be assigned from the Input gestures dialog.
  • Added a dialog to configure the Emulate copy and Emulate cut functionalities at installation. This allows to add the control+c and control+x commands to copy and cut, and be asked if you want to replace the clipboard contents when pressing these keystrokes.
  • Fixed documentation for script_add (Windows+NVDA+c).

Changes for 5.0

  • The visual presentation of the dialog has been enhanced, adhering to the appearance of the dialogs shown in NVDA.
  • Requires NVDA 2016.4 or later.

Changes for 4.0

  • Add-on settings are managed from NVDA configuration, so that standard profiles can be used to save different separators, and it's not needed to copy the settings for importing at reinstallation.
  • Now it's possible to choose if the added text will be appended or prepended, using the Add text before clip data check box from the Clip Contents Designer settings dialog.

Changes for 3.0

  • Braille representation of MathML objects can be added to the clipboard if MathPlayer is installed.
  • If no separator is set, just a single line will be placed between the added text segments.
  • A shortcut can be assigned to open the Clip Contents Designer settings dialog.
  • Added a check box in the settings dialog, for choosing if the separator should be copied to be imported when reinstalling the add-on.

Changes for 2.0

  • Hindi characters can be used as the separator between added contents.

Changes for 1.0

  • Initial version.