The following came as a result of a discussion with friend and former Word MVP Greg Maxey about a convenient method of determining the presence and value of any docvariables in the current document, and, like many projects we have started together, it sort of grew into the current offering, which is a tool that not only displays the names and values of any docvariables present, but provides the opportunity to edit their content and insert docvariable fields into the document at the current cursor position to display the stored content.
The current version has been extensively modified from the original (which is still available for reference) to encompass Content Controls.
Some of the built-in document properties, which this application can access, are not editable, but their values may be viewed and inserted, and some may only be inserted as content controls. The add-in caters for all these factors.
Where a function is not available for a given item or document, either the button which controls the function is disabled or the user is presented with an error message.
The functions have been designed to be self-evident, but there is a link to this page at the bottom of the user interface, where you will find a fuller description.
Extract the template from the ZIP file to your Word startup folder - defined in Word Options > Advanced > File Locations > StartUp, then if Word was running at the time, select it from the Developer toolbar > Templates.
Alternatively restart Word to load the template automatically.
The ZIP file also includes an EXE installer. This will automatically install the add-in to the default Word Startup folder (or can be redirected if you have changed that location) and will remove any previous version from that folder.
Note: The add-in contains functions that will not work with 64 bit versions of Office 2010. It will however work with 32 bit versions of Word in Windows 64 bit.
Development is on-going and will take account of user feedback and the inevitable issues that we have missed.
The dialogs shown in the illustrations may vary slightly from the downloadable version. Where significant changes are made, the illustrations will be updated to reflect those changes.
Each new update will have a different version number as part of the file name. Ensure that you remove any previous version before installing the latest.
When the add-in is installed, a new group is added to the Add-Ins tab of the ribbon
and a (removable) button is added to the Links group on the Insert Tab of the ribbon
There are four buttons in the group. The large button calls the application. From top to bottom the other buttons are:
1. Options - This toggles the display of a duplicate of the main button in the Links group on the Insert Tab of the ribbon and came from a difference of opinion as to where the button should be located. I felt that it was more logically placed amongst the Insert commands with which it is associated.
Greg felt that as it was an add-in it should be on the add-in tab – logic that you can't argue with, even if you prefer it somewhere else. So we both got our wish.
The Options also provide feedback with sound, and the ability to list Content Controls and Bookmarks sorted by their location in the document.
All the options are selected by default,
2. Info/Help - Links to this web page
3. Disclaimer - See text below. Click anywhere on this dialog to dismiss it.
On clicking the main button, the userform will display the 'Lists' tabbed page of the dialog which features various list boxes and an assortment of action buttons.
The userform will remain on screen until dismissed and is modeless, which means that you can switch to edit the document without dismissing the form.
Note especially the User Notification and Action Panel on the main page and the User Notification Panel on the subsequent pages. These provide context sensitive help and warning messages to accompany each process.
If one or other docvariables, bookmarks or custom document properties are not present, the associated list box will display a message to that effect. There will however always be built-in document properties present and thus listed.
Note: References may not be inserted into protected areas of documents.
Note that the values of some built-in docproperties, such as the 'Company' item displayed, are user editable. Others reflect values created by the document and thus are not editable, though reference may be made to them in the document.
This editor is not intended and not recommended to be used to complete Word protected forms, however it can be used to do so, and in particular it adds the ability to add list items to a dropdown form field - even in a password protected form, which cannot be normally achieved from Word while the form is protected. It does not provide the ability to add or delete form fields in a protected form, nor to change their properties.
Note that dropdown form fields have a maximum of 25 listed items.
Delete Items: Deletion provides the opportunity to unlink any cross references (retaining their content at the time) or to delete the cross references. In the case of bookmarks, there is also the opportunity to delete the bookmarked content.
When running the add-in on a document that contains unmapped content controls, a warning message is presented, providing the options to apply temporary or permanent labels to those controls as shown below.
From Version 3 the Content Controls
section of this add-in were completely redesigned by Greg. I had
no involvement with the changes, beyond some proof reading.
Please refer to his site for detailed information about that
part of the add-in.
The add-in employs a Microsoft TreeView Control 6.0 (SP6) to list the CustomXMLNodes available for content control mapping. This control requires a library reference to MSCOMCTL.OCX (Windows Common Controls ActiveX Control DLL) which may be missing or require registering on your system. The file MSCOMCTL.OCX is included in the add-in installation package. Where you locate/place this file will depend on your operating system.
C:\WINDOWS\SYSTEM32 if you are using a 32-bit version of Windows
C:\Windows\SysWOW64 if you are using a 64-bit version of Windows
Instructions for installing and registering the file are provided in the "Read Me" text file that is part of the installation package.
The add-in will also be available from Greg Maxey's web site
Word does not provide a convenient method of examining document variables, which thus tends to limit their usefulness to those who are comfortable with vba programming. Document variables are however extremely useful and can be used to store all manner of information to employ in in a document or macros used with that document.