v5.5 Spell Checker

[rewers08]

Hi,

maybe my question is a little bit foolish. But I can't get the idea of how I can get a certain object. It's about the spell checker respectively the “XMetaL XMAX object” which is always refered to as myXMControl in the documentation. How can I get access to this object from a JavaScript method that is running inside XMetaL respectively XMAX? If I got it right the XMetaL XMAX object represents the running instance of XMetaL resp. XMAX. So is it possible to get this object from inside the running instance?
We are using XMAX running inside a Java based rich client. Do we have to start the spell checker from the java side from where we also start the XMAX instance or can we do it from within XMAX?

Thanks,
rewers.

Reply

[Derek Read]

The details of this depend on the application you have embedded XMAX into and the programming language being used and the development environment. Essentially any application that allows you to embed an ActiveX control typically requires you to give that embedded copy of the control a name. In some cases this may be done automatically by suggesting a name for you. This name is what our documentation calls “myXMControl” which is a hint that you may use any name you like. You might prefer to call it simply “xmax1”, “xmlEditor”, or whatever you like (provided your environment does not have any restrictions on the naming).

If your development environment provides a graphical layout tool for designing forms, etc, and you have placed XMAX on a form it may have a “properties” window or dialog that lets you examine properties associated with XMAX. In many environments the property you would be looking for in this case would probably be  called “name” or “control name” or something along those lines.

Consult the documentation for your particular environment regarding embedding ActiveX controls. Hopefully they will provide an example that shows how to work with a commonly available control, such as the Windows “calendar control” or another control that has a GUI.

Once you are able to embed XMAX it must have a property you can refer to in order to pass commands to it (this is the “myXMControl” in our documentation examples). XMAX automatically finds the spell checker if it is installed and launches it when you call the method myXMControl.ShowSpellChecker(), substituting “myXMControl” with the name you have chosen to declare the control as, like xmax1.ShowSpellChecker() or xmlEditor.ShowSpellChecker().

If you cannot be sure the spell checker is installed (perhaps your system allows some users to opt out of running the spell checker installation or for some other reason) you may wish to wrap the call to ShowSpellChecker() within an if…then statement that checks the boolean property myXMControl.IsSpellCheckerInstalled or you may wish to use that property to disable the portion of your UI that allows the user to launch the spell checker.

Reply

[Derek Read]

Note that the spell checker is also called “Writing Tools” in some places in the documentation and that is listed as in the installation options when you run the XMAX installer.

Reply

[rewers08]

Thank you very much. It works just fine. The only problem that we have now is that we need to localize the dialog. Is there only an English translation of the dialog? Is it possible to change the dialogs appearance?

Greetings,
rewers.

Reply

[Derek Read]

Unfortunately, this is not possible with any current versions.

Reply

[Author]

Posts