Skip to content

Commit 070c974

Browse files
authored
Update hyperlink.md
1 parent a6a54b9 commit 070c974

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

controls/richtexteditor/features/hyperlink.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Hyperlink
33
page_title: Hyperlink - WinForms RichTextEditor Control
4-
description: WinForms RichTextEditor supports having a hyperlink span several paragraphs and being able to embed all kind of elements inside hyperlinks, e.g. images, tables and table elements.
4+
description: WinForms RichTextEditor supports having a hyperlink span several paragraphs and being able to embed all kinds of elements inside hyperlinks, e.g. images, tables, and table elements.
55
slug: winforms/richtexteditor-/features/hyperlink
66
tags: hyperlink
77
published: True
@@ -15,13 +15,13 @@ The following functionality is supported in the __RadRichTextEditor__:
1515

1616
* having a hyperlink span several paragraphs;
1717

18-
* being able to embed all kind of elements inside hyperlinks, e.g. images, tables and table elements;
18+
* being able to embed all kinds of elements inside hyperlinks, e.g. images, tables, and table elements;
1919

2020
* making bookmarks in the document the targets of hyperlinks.
2121

2222
The classes that encapsulate the functionality of hyperlinks are [HyperlinkInfo](#hyperlinkinfo),[HyperlinkRangeStart and HyperlinkRangeEnd](#hyperlinkrangestart-and-hyperlinkrangeend).
2323

24-
[Other customization options](#othercustomizationoptions) include setting the tool tip format and detecting the click of hyperlinks.
24+
[Other customization options](#othercustomizationoptions) include setting the tooltip format and detecting the click of hyperlinks.
2525

2626
## HyperlinkInfo
2727

@@ -174,7 +174,7 @@ The result (`Ctrl` + `Click` to follow):
174174

175175
![WinForms RadRichTextEditor Hyperlink Review](images/richtexteditor-features-hyperlink001.png)
176176

177-
You will also need to use **HyperlinkRangeStart** and **HyperlinkRangeEnd**, if you are using hyperlinks for the implementation of a custom logic and want to get all hyperlinks from the document, manipulate the properties of the **HyperlinkInfo** or the whole part of the document that is included in the hyperlink.
177+
You will also need to use **HyperlinkRangeStart** and **HyperlinkRangeEnd**, if you are using hyperlinks for the implementation of custom logic and want to get all hyperlinks from the document, manipulate the properties of the **HyperlinkInfo** or the whole part of the document that is included in the hyperlink.
178178

179179
For instance, here is how you can delete all hyperlinks in the document and replace them with some text:
180180

@@ -209,18 +209,18 @@ Next link
209209

210210
### ToolTip
211211

212-
By default, hyperlinks take a fixed string as a tool tip. The default format is:
212+
By default, hyperlinks take a fixed string as a tooltip. The default format is:
213213

214-
>note "{0}{1} to follow link" - The first parameter is the URL, the second is "Ctrl + Click" which is taken from the localization file.
214+
>note "{0}{1} to follow link" - The first parameter is the URL, and the second is "Ctrl + Click" which is taken from the localization file.
215215
>
216216
217217
You have control over it using the __HyperlinkToolTipFormatString__ of **RadRichTextEditor**, which will set the format for all hyperlinks in the document.
218218

219219
### HyperlinkClicked event
220220

221-
When a hyperlink is clicked, the __HyperlinkClicked__ event of __RadRichTextEditor__ is fired. The sender of the event is the document element, which you have clicked, e.g. a **Span**, an **Image**, **InlineUIContainer**, etc. The __HyperlinkClickedEventArgs__ provide the possibility either to cancel or replace the navigation action. This is helpful when you need to validate the clicked hyperlink and prevent it from navigating to an unsecure address or from starting a local process.
221+
When a hyperlink is clicked, the __HyperlinkClicked__ event of __RadRichTextEditor__ is fired. The sender of the event is the document element, that you have clicked, e.g. a **Span**, an **Image**, **InlineUIContainer**, etc. The __HyperlinkClickedEventArgs__ provides the possibility either to cancel or replace the navigation action. This is helpful when you need to validate the clicked hyperlink and prevent it from navigating to an unsecured address or from starting a local process.
222222

223-
With the 2024 Q3 (2024.3.924), the default navigation behavior of the hyperlinks is to automatically open only valid and trusted addresses. The hyperlink navigation can be cancelled by either setting the __Handled__ property of the HyperlinkClickedEventArgs to _true_ or __IsTrustedUrl__ to _false_.
223+
With the 2024 Q3 (2024.3.924), the default navigation behavior of the hyperlinks is to automatically open only valid and trusted addresses. The hyperlink navigation can be canceled by either setting the __Handled__ property of the HyperlinkClickedEventArgs to _true_ or __IsTrustedUrl__ to _false_.
224224

225225
Here is an example of using the HyperlinkClicked event prompting that the clicked hyperlink might be unsafe and allows to cancel the navigation process upon receiving the end user confirmation:
226226

@@ -294,7 +294,7 @@ Me.radRichTextEditor1.HyperlinkNavigationMode = Telerik.WinForms.Documents.UI.Hy
294294
{{endregion}}
295295

296296

297-
# See Also
297+
## See Also
298298

299299
* [Document Elements]({%slug winforms/richtexteditor-/document-elements%})
300300

0 commit comments

Comments
 (0)