You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: controls/richtexteditor/features/hyperlink.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Hyperlink
3
3
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.
5
5
slug: winforms/richtexteditor-/features/hyperlink
6
6
tags: hyperlink
7
7
published: True
@@ -15,13 +15,13 @@ The following functionality is supported in the __RadRichTextEditor__:
15
15
16
16
* having a hyperlink span several paragraphs;
17
17
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;
19
19
20
20
* making bookmarks in the document the targets of hyperlinks.
21
21
22
22
The classes that encapsulate the functionality of hyperlinks are [HyperlinkInfo](#hyperlinkinfo),[HyperlinkRangeStart and HyperlinkRangeEnd](#hyperlinkrangestart-and-hyperlinkrangeend).
23
23
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.
25
25
26
26
## HyperlinkInfo
27
27
@@ -174,7 +174,7 @@ The result (`Ctrl` + `Click` to follow):
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.
178
178
179
179
For instance, here is how you can delete all hyperlinks in the document and replace them with some text:
180
180
@@ -209,18 +209,18 @@ Next link
209
209
210
210
### ToolTip
211
211
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:
213
213
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.
215
215
>
216
216
217
217
You have control over it using the __HyperlinkToolTipFormatString__ of **RadRichTextEditor**, which will set the format for all hyperlinks in the document.
218
218
219
219
### HyperlinkClicked event
220
220
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.
222
222
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_.
224
224
225
225
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:
0 commit comments