In addition to simple user-defined counters, Help+Manual also supports specialized figure and table counters and an additional related user counter. These allow you to create numbered tables of figures and tables in your projects and to include cross-references to the individual figures and tables.
Figure counters in image dialogs
Figure counters can be integrated in image references (both static images and image toggles). The options for this are included in the normal image and toggle insertion dialogs.
The Figure <%HMFIGCOUNTER%>: entry is created automatically when you activate the Add to Table of Figures option. If you edit the Figure text your edit will be used the next time you use the dialog. See further below in this topic to learn how to use these captions.
Figure and table counters in "figure captions"
In addition to the integrated image references you can also create special "figure captions" with the Caption tool. In addition to images, these captions can also be used for tables (which don't have their own captions) and for your own custom captions for anything else you like. The Caption tool is located in Write > Insert Object.
Here too, the Figure <%HMFIGCOUNTER%>: entry is created automatically when you activate the Add to Table of Figures option. If you edit the Figure text your edit will be used the next time you use the dialog.
These captions are very flexible. They allow you to create numbered references to any class of items in your project, not just tables and images. For example, you could create a numbered list of equations or quotations or anything else you like. See further below in this topic to learn how to use them.
The variables used:
There are three variables used for figure and table counters.
The incrementation of these counter variables is "smart". Their values are only increased in the locations listed above. If you insert them in the body text of your project or anywhere else except these "incrementing locations" their values will not be incremented. This makes it much easier to insert references to your figures, tables and other listed items than in the past.
The <%HMFIGURECOUNTER%> and <%HMTABLECOUNTER%> variables introduced in Help+Manual 7 will still work, but they are deprecated and no longer documented. If you have used them in your projects you don't need to replace them immediately. However, support for them will be removed in the future, so in the long run you should replace them with the new counter variables described below. Also, any new counters you add should use the new variables.
The old variables don't support tables of figures and tables
Note that the old variables won't be used in the new tables of figures and tables. You need to update to the new variables for that.
No automatic conversion
Unfortunately, it was not possible to include automatic conversion for the old figure and table counters. The differences are simply too large. To update existing counters you need to delete the old ones and create the new ones as described below.