XML Interface Definition Reference

In order to use XI you have to describe the desired interface using XML definitions. In general, your XML source will look like this:

<?xml version="1.0" encoding="ISO-8859-1"?>
<root dpix="96" dpiy="96">
  [some control nodes definions here]
</root>

Combining control nodes, you can implement virtually any interface to edit your data. There are several simple rules when desribing your interface with control nodes:

• All names are case-sensitive. If the name of the control node is "edit" it should be written exactly this way. The same goes for node parameters. For convenience, all standard control node names and parameters are in lower-case.
• Enclose node parameters in double quotes.
• Boolean values can be defined by "1" (true) and "0" (false). You can also use "true" and "false" as a substitution.
• Do not forget XML RFC — if you need to use "<", ">" or double quotes as your node parameter value, use "&lt;", "&gt;" and "&quot;" respectively.

Please note dpyx and dpiy parameters. They are used to make XI independent from DPI settings of the screen. When creating your XML script you have to specify them (in fact, they will be automatically inserted if you use XIEditor) and use XIScaleX and XIScaleY to scale all widths and heights in your own control nodes (The ReadParams method is most suitable). These functions simply compare DPI settings that were in effect when you created your script and in the run-time of your application and scale the values accordingly.

In this help file you will find descriptions for standard XI control nodes. Note that the descriptions have a tree-like structure. This is the case because each control node is based on the corresponding class so they derive from each other. You can create your own control nodes, deriving them from the appropriate class (i.e. TxiBaseControlNode, TxiPersistentControlNode, TxiCaptionedControlNode or TxiLabeledControlNode) and registering your class in XI by the XIRegisterControl procedure.

Also, the names of abstract control node classes will be enclosed in "corner brackets" ("<" and ">"). You can't use them in your XML source but they may have some parameters that will be inherited by the derived control nodes.