HyperLinkURLFile property

This property sets an xml file that allows hyperlinks to be used when thumbnail images are clicked.

[Visual Basic] Public Property HyperLinkURLFile String

[C#] public string HyperLinkURLFile {get; set;}

Property Value

The default value is "URL.xml".

Explanation

The HyperLinkURLFile property sets an xml file that allows hyperlinks to be used when thumbnail images are clicked. Without this xml file, clicking a thumbnail image displays the original image file. When this xml file is used, hyperlinks can be set so that clicking the thumbnail images executes the hyperlinks.

The default name of this xml file is "URL.xml". It should be placed in the same directory as the images whose hyperlinks it sets. The xml tags in the xml file must correspond to the file names of the images.

For example, if the following xml file, named "URL.xml", exists in the same directory as these images "001.jpg", "abc.tif", and "002.jpg", then the following hyperlinks will be enabled when the corresponding thumbnail images are clicked.

URL.xml"

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<UrlData>
<_001.jpg>http://www.newtone.co.jp/</_001.jpg>
<abc.tif-1>http://msdn.microsoft.com/library/ja/</abc.tif-1>
<abc.tif-2>http://www.yahoo.co.jp/</abc.tif-2>
<_002.jpg>http://www.google.co.jp/</_002.jpg>
</UrlData>

Note: Because xml tags cannot contain a numeral as the first character, an underbar is added at the beginning of the xml tags for images "001.jpg" and "002.jpg". The Thumbnail Control will ignore the initial underbar in any tag within the xml file. Also, the image abc.tif is a multipage tiff image. The xml tag that designates the second page of this multipage tiff image is <abc.tif-1> and the xml tag designating the third page is <abc.tif-2> (The page index starts with 0).

Although we recommend that you keep the xml file in the same directory as the images that it modifies, it is possible to change the directory of the xml file. To do this, set a virtual path from the xml file to the directory containing the images that it modifies. In other words, setting the HyperLinkURLFile property to "/../../URL.xml" means that the xml file called "URL.xml" is contained in the directory two directories above the directory containing the images.

Newtone.ImageKit.WPF.Web.Thumbnail.HyperLinkURLFile Property

Property Value

Explanation

See Also