IupGLLink (since 3.11)

Creates an embedded OpenGL label that displays an underlined clickable text. It inherits from IupGLLabel. It exists only inside an IupGLCanvasBox.


Ihandle* IupGLLink(const char *url, const char * title); [in C]
iup.gllink{[url = url: string], [title = title: string]} -> (elem: ihandle) [in Lua]
gllink(url, title) [in LED]

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.

Returns: the identifier of the created element, or NULL if an error occurs.


The IupGLLink element handle 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".


The IupGLLink element handle all callbacks defined for the IupGLSubCanvas control.

ACTION: Action generated when the link is activated.

int function(Ihandle* ih, char *url); [in C]
elem:action(url: string) -> (ret: number) [in Lua]

ih: identifier of the element that activated the event.
url: 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.


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.

See Also

IupGLLabel, IupHelp.