Home Forums General XMetaL Discussion XMetal 5 custom dialogs – hhf files Reply To: XMetal 5 custom dialogs – hhf files

Derek Read

Reply to: XMetal 5 custom dialogs – hhf files

I would suggest upgrading to version 9 (the current release) unless there is some specific reason to be running an old version like 6.

Putting that aside…

The .hhf form file type was discontinued with the release of XMetaL Author and XMetaL Developer version 4 (in 2004). The new .xft format was introduced at the same time. XMetaL Author has continued to support the old .hhf format, or at least a concerted effort was made for several years not to break them. I wouldn't be surprised if something has finally broken in versions 7, 8, or 9 but since you are running version 6 (where QA was still actively testing backward compatibility of .hhf files) I think it is far more likely that something the forms needed on your system when they were first designed is not there on your current machine. The most likely thing would be a 3rd party control of some kind (ActiveX).

It's unfortunate that you have inherited such an old setup, and that you are “upgrading” to another old version. I haven't heard of anyone running into this problem for many years, since everyone that upgraded from XMetaL 3 to XMetaL Author 4 went through this long ago. At that time it would have been the people that originally created the .hhf forms and so recreating them in the new format would have been very easy for them.

If you want to continue to work with the .hff file format you will need to edit it with XMetaL 3, since it was the last version to provide the form creation and editing tool that could read those files. You would need a computer running Windows XP or older (version 3 won't run properly on Windows 7 or 8) where you can install XMetaL 3 to debug the .hhf, save it, then move it to another machine running XMetaL Author 6 to test it again. I would recommend moving to the new .xft format as I cannot say how long the .hhf format will function since we have not tested it for many years now.

There is no conversion utility, so converting the .hhf format to the .xft format is a manual process (done with XMetaL Developer version 4, 5, 6, 7, or 9). The clients that did this when upgrading to version 4 took this approach:

1) Take screen captures of the .hhf form running.
2) Make a note of all the controls used on the form. If the form relies on any 3rd party controls make a special note for those as they may need to be installed, or alternatives might need to be found if you are also upgrading Windows (to XP or Windows 7 in your case). Some older Windows controls available in Windows 95, 98, 2000 or NT might not be available so you might need to find alternatives that are similar. In that case any script code in the form would likely need to change as well.
3) Load the .hhf into the editor in XMetaL 3 and copy all the code out (usually JScript or VBScript) and save it in some organized fashion.
4) Using XMetaL Developer's “XMetaL Forms Toolkit” tool, recreate the look of the old form in the new format, then add in the code as appropriate, adjusting it where necessary.

For someone that created the original form that might take a few minutes, or for a complex form maybe an hour. If you aren't familiar with the original though I guess it will be quite a bit more difficult.