Blitz3D+ Command Reference

CreateLinkLabel ( text$,x,y,width,height,group[,style] )

Parameters

text$ - link text to display

x,y - position of the link's top-left corner within the group's client area

width,height - size of the link label

group - window or gadget group that owns the link label

style (optional) - 0 (default); other values are reserved

Description

Creates a clickable, hyperlink-styled action link and returns its handle.

Requires Extended language mode.

A link label looks like a hyperlink but is really a lightweight action trigger - ideal for low-emphasis commands in an inspector where a full button would be heavy, like "Reset transform" or "Show advanced options". The text is treated as plain text and displayed literally.

Activating the link with the mouse or keyboard posts a critical gadget-action event ($401) with EventData 0 and the link's handle in EventSource. The runtime never opens a URL for you - what the click does is entirely up to your event loop, so a link can just as well toggle a panel as open a web page.

SetGadgetText and GadgetText operate on the link's plain text like any other gadget, and the text is UTF-8.

See it working in the native input controls sample.

See also: CreateLabel, CreateButton, SetGadgetText, EventSource, SetGadgetToolTip.

Index