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 |