The purpose of this chapter is to help you get started with Text Control Enterprise and its XML features. It will show you how to open an XML file, and how to use it in conjunction with a CSS stylesheet and a DTD.
There is a more detailed description of the XML related propertiesand methods in the Technical Articles section, see Working with XML Files.
The source code for this example is contained in the following directories:
Used TX Text Control controls:
Relevant API links:
The sample program has only one menu item, which is Open File.... Looking at the source code reveals nothing unusual: The main difference to the Open File routine in other Text Control sample programs is the Load method being called with the StreamType value XMLFormat as a parameter, so that the Open File dialog box will only display XML files:
private void Open_Click(object sender, RoutedEventArgs e) {
m_txTextControl.Load(TXTextControl.StreamType.XMLFormat);
}Private Sub Open_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
m_txTextControl.Load(TXTextControl.StreamType.XMLFormat)
End SubThere is quite a bit happening behind the scenes, however. If you load the address.xml sample file, Text Control will not only load the xml file, but will
Let us take a closer look at the 3 files involved.
The XML file contains a simple list of addresses:
<?xml version="1.0"?>
<?XML:stylesheet type="text/css" href="address.css"?>
<!DOCTYPE address SYSTEM "address.dtd">
<address>
<address_record>
<name>Paul</name>
<street>Baker Street</street>
<city>London</city>
<email>paul@hotmail.com</email>
</address_record>
<address_record>
<name>George</name>
<email>george@hotmail.com</email>
</address_record>
</address>Note that, unlike an HTML or RTF file, an XML file does not contain any information about how the text is to be displayed or formatted.
In line 2 of the XML file (above), you can see a reference to a stylesheet file called address.css. This CSS file tells Text Control that an address entry should be displayed as a table, and that the individual elements are table cells, having a 1 pixel wide border and a font size of 1 point:
address { display: table }
address_record { display: table-row}
name, street, city, email { display: table-cell; border: 1px; font-size: 11pt }When you load address.xml with the sample program, Text Control will display it according to this stylesheet.
Changing the CSS file can make the text appear in a completely different way. For instance, a list can be used instead of a table, as in this example:
name { display: block; font-size: 14pt; color: blue }
street, city, email { display: list-item; font-size: 11pt}This is how Text Control will display the XML data (address_list.xml) using the new stylesheet (address_list.css):
The DTD specifies which elements may occur in an XML file, and in which way the elements should be ordered or nested. The sample DTD specifies that an address contains one or more address_record elements, which in turn can contain a name, street, city, and email. street and city are defined as optional elements.
<!ELEMENT address ( address_record+ )>
<!ELEMENT address_record ( name, street?, city?, email )>
<!ELEMENT name (#PCDATA )>
<!ELEMENT street (#PCDATA )>
<!ELEMENT city (#PCDATA )>
<!ELEMENT email (#PCDATA )>When loading an XML file, Text Control checks whether the XML code is valid according to the DTD. If it is invalid, an XmlInvalid event is fired, that provides data about it. In this example the required <name> has been removed from the address_invalid.xml file:
<?xml version="1.0"?>
<? XML:stylesheet type="text/css" href="address.css"?>
<!DOCTYPE address SYSTEM "address.dtd">
<address>
<address_record>
<street>Baker Street</street>
<city>London</city>
<email>paul@hotmail.com</email>
</address_record>
</address>When loading this XML file, the XmlInvalid event is fired and handled by displaying a MessageBox that informs the user about the reason of the error.