本章节将演示如何在文档中添加超链接和锚点，以及如何响应超链接的单击操作。
本章节相应的源代码可以在TX Text Control.NET的安装目录中找到： Samples\WinForms\VB.NET\ Hyperlinks Samples\WinForms\CSharp\ Hyperlinks 第一步：插入超链接 在这个示例程序中将在文档里插入一个超链接，并将该文档保存为HTML格式，便于在浏览器中显示。1 [C#] 2 private void cmdInsertHyperlink_Click(object sender, System.EventArgs e) 3 { 4 // Create a HypertextLink object 5 TXTextControl.HypertextLink MyLink = 6 new TXTextControl.HypertextLink( 7 "Text Control Web Site", 8 "http://www.gcpowertools.com.cn"); 9 // Insert the hyperlink into the document 10 textControl1.HypertextLinks.Add(MyLink); 11 } 需要注意的是上面的例子并没有处理Click事件，所以点击超链接时并没有跳转到指定的网页，而且超链接也没有蓝色下划线的字体样式。事件处理以及显示样式将在第二步中完成。
下面调用TextControl.Save方法来讲文档保存为HTML格式的文件：1 [C#] 2 private void cmdSaveAs_Click(object sender, System.EventArgs e) 3 { 4 textControl1.Save(TXTextControl.StreamType.HTMLFormat); 5 } 使用浏览器打开刚才保存的HTML文件，可以看到刚才添加的超链接
1 [C#] 2 private void mnuInsert_Hyperlink_Click(object sender, System.EventArgs e) 3 { 4 frmHyperlinks Hyperlinks = new frmHyperlinks(); 5 Hyperlinks.tx = textControl1; 6 Hyperlinks.ShowDialog(); 7 HighlightHyperlinks (textControl1, mnuView_Hyperlinks.Checked); 8 } 当该对话框加载时会根据当前输入位置来决定链接文本和链接地址中应该显示的信息：
1 [C#] 2 private void frmHyperlinks_Load(object sender, System.EventArgs e) 3 { 4 TXTextControl.HypertextLink HyperLink = tx.HypertextLinks.GetItem(); 5 if (HyperLink != null) 6 { 7 // If there is an existing hypertext link at the input position, 8 // copy its text and target to the text boxes on the form. 9 txtLinkedText.Text = HyperLink.Text; 10 txtLinkTo.Text = HyperLink.Target; 11 } 12 else 13 { 14 // If there is no hypertext link at the input position, but 15 // some text has been selected, then copy this text to the 16 // Linked Text text box. 17 if (tx.Selection.Length > 0) 18 txtLinkedText.Text = tx.Selection.Text; 19 } 20 } 用户修改链接文本和链接地址之后点击【OK】按钮，输入的信息将被更新到文档中：
1 [C#] 2 private void cmdOK_Click(object sender, System.EventArgs e) 3 { 4 TXTextControl.HypertextLink HyperLink = tx.HypertextLinks.GetItem(); 5 if (HyperLink == null) 6 { 7 // Insert a new link 8 TXTextControl.HypertextLink NewLink = 9 new TXTextControl.HypertextLink( 10 txtLinkedText.Text , txtLinkTo.Text); 11 tx.HypertextLinks.Add(NewLink); 12 } 13 else 14 { 15 // Update an existing link 16 HyperLink.Text = txtLinkedText.Text; 17 HyperLink.Target = txtLinkTo.Text; 18 } 19 Close(); 20 } 最后，添加一个【View】菜单项用于设置超链接文字的格式，包括蓝色字体和下划线样式：
1 [C#] 2 void HighlightHyperlinks(TXTextControl.TextControl tx, bool bHighlight) 3 { 4 int PreviousStart = tx.Selection.Start, 5 PreviousLength = tx.Selection.Length; 6 7 foreach (TXTextControl.HypertextLink Link in tx.HypertextLinks) 8 { 9 tx.Selection.Start = Link.Start-1; 10 tx.Selection.Length = Link.Length; 11 if (bHighlight) 12 { 13 tx.Selection.ForeColor = Color.Blue; 14 tx.Selection.Underline = TXTextControl.FontUnderlineStyle.Single; 15 } 16 else 17 { 18 tx.Selection.ForeColor = Color.Black; 19 tx.Selection.Underline = TXTextControl.FontUnderlineStyle.None; 20 } 21 } 22 tx.Selection.Start = PreviousStart; 23 tx.Selection.Length = PreviousLength; 24 }
第三步：添加文档锚点
在第一和第二步中使用的链接地址都是外部资源，在该示例中讨论如何链接到文档中的某个位置。这些链接叫做文档链接，而这些被指定的位置叫做文档目标，文档目标在HTML编辑器中也被当做锚点、在字处理器中被当做书签来使用。 在运行示例程序时，在文档添加一些文本，然后再通过Insert / Target来添加一些文档目标。1 [C#] 2 TXTextControl.DocumentTarget Target = 3 new TXTextControl.DocumentTarget(InsertTarget.TargetName); 4 textControl1.DocumentTargets.Add(Target);
为目标添加链接
需要对步骤二中使用的【Hypertext Link】对话框进行扩展，因为，链接目标不仅可以设置为URL，还可以设置为文档目标。将之前的【Link To】文本框替换为一个下拉框，下拉框中显示的DocumentTargets集合中的目标对象。1 [C#] 2 foreach (TXTextControl.DocumentTarget Target in tx.DocumentTargets) 3 cboLinkTo.Items.Add("#" + Target.TargetName); 跳转到目标
当点击文档中的链接时，文本区域应该滚动的链接对应的目标所在的位置。该功能可以在DocumentLinkClicked事件中调用ScrollTo方法来实现：1 [C#] 2 private void textControl1_DocumentLinkClicked(object sender, 3 TXTextControl.DocumentLinkEventArgs e) 4 { 5 e.DocumentLink.DocumentTarget.ScrollTo(); 6 } 显示和编辑目标
TX Text Control可以通过显示一个标识来指明文档目标所在的位置。但是，如果目标不可见，怎样才能在文档中来定位这些目标呢？解决办法是使用一个列表框来显示文档中的全部目标对象，你可以跳转到指定的目标，或者将其删除。