TextHyperlink - Add URL to selected text
The action allows adding an URL to selected text (create hyperlink). The way hyperlinks are provided depends on the target system. Entering an HTTP URL is the save way. Within ODE and the ODE help system generation, one may also refer to topic names. After clicking the action button The image dialog pops up:
The dialog is a build-in GUI framework dialog, which does not require additional actions. In order to provide an application specific action, the action may be overloaded by implementing the action in an associated context class. Thus, ODE tools show the following dialog:
In order to use the ODE tools dialog, rich text control support from ODE has to be provided. For providing rich text support for other applications, one may import the RichTextSupport component from ode.dev database.
The text is the text that had been selected when calling the action. When changing the text, this will replace the selected text.
The URL for the hyperlink is usually an http protocol address. When not prefixing the URL with the protocol name (which may als be file or something else), in some environments (ODE) the reference is assumed to be a topic reference and the URL will be calculated from the topic name and the proper URL will be used instead.
When referring to topics, the topic name for a NamedTopic has to be referenced (never use the hierarchy topic name). Unsually, those names are identical.
The function checks, whether the URL defined for the hyperlink is correct. An error message appears when this is not the case.