IupGLLink

Definition: include pGUI.e

Ihandle ih = IupGLLink(nullable_string url=NULL, nullable_string title=NULL, [[nullable_string action=NULL,] cbfunc func=NULL,] string attributes="", sequence data={})
Description: Creates an embedded OpenGL label that displays an underlined clickable text.
It inherits from IupGLLabel. It exists only inside an IupGLCanvasBox.

url: the destination address of the link. Can be any text. If IupHelp is used should be a valid URL. It can be NULL. It will set the URL attribute.
title: Text to be shown on the link. It can be NULL. It will set the TITLE attribute.
action: Name of the action generated when the button is selected. It can be NULL.
func: a callback address, usually specified as Icallback("name").
For more information on the attributes and data parameters see IupSetAttributes.
This is a paranormalised function.

Returns: the identifier of the created element.
Notes: When the cursor is over the text, it is changed to the HAND cursor.

If the callback is not defined the IupHelp function is called with the given URL.
Attributes: The IupGLLink element handles all attributes defined for the IupGLLabel control, and consequently for the IupGLSubCanvas control too.
FGCOLOR Text color. Default: the global attribute LINKFGCOLOR.
URL the default value is "YES".
Callbacks The IupGLLink element handle all callbacks defined for the IupGLSubCanvas control.
ACTION Action generated when the link is activated.

function action_cb(Ihandle ih, atom pUrl)
ih: identifier of the element that activated the event.
url: (a char*) the destination address of the link.

Returns: IUP_CLOSE will be processed.
If returns IUP_DEFAULT or it is not defined, the IupHelp function will be called.
See Also: IupGLLabel, IupHelp