hwtk::hyperlink
Displays a hypertext string and/or image. Widget that issues a command when pressed.
Format
hwtk::hyperlink - pathName ?option value? …
Description
A hwtk::hyperlink widget displays a hypertext string and/or image, and evaluates a command when clicked.
Standard Options
- -clientdata
- Database name: clientData
- -compound
- Database name: compound
- -cursor
- Database name: cursor
- -help
- Database name: help
- -helpcommand
- Database name: helpcommand
- -image
- Database name: image
- -state
- Database name: state
- -takefocus
- Database name: takeFocus
- -text
- Database name: text
- -textvariable
- Database name: textVariable
- -underline
- Database name: underline
Widget-Specific Options
- -command
- Database name: command
- -justify
- Database name: justify
Widget Command
In addition to the standard configure, cget, identify, instate, and state commands, this command support the following additional widget commands:- pathName configure ?option? ?value option value …?
- Query or modify the configuration options of the widget. If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. If option is specified with no value, then the command returns a list describing the named option: the elements of the list are the option name, database name, database class, default value, and current value. If no option is specified, returns a list describing all of the available options for pathName.
- pathName cget option
- Returns the current value of the configuration option given by option.
- pathName identify element x y
- Returns the name of the element under the point given by x and y, or an empty string if the point does not lie within any element. x and y are pixel coordinates relative to the widget. Some widgets accept other identify subcommands.
- pathName instate statespec ?script?
- Test the widget’s state. If script is not specified, returns 1 if the
widget state matches statespec and 0 otherwise. If script is specified,
equivalent to
if{[pathNameinstatestateSpec]}script
- pathName state ?stateSpec?
- Modify or inquire widget state. If stateSpec is
present, sets the widget state: for each flag in
stateSpec, sets the corresponding flag or clears it
if prefixed by an exclamation point. Returns a new state spec indicating
which flags were changed:
will restore pathName to the original state. If stateSpec is not specified, returns a list of the currently-enabled state flags.setchanges[pathNamestatespec]
pathNamestate$changes
- pathName invoke
- Executes command provided by -command option.
Example
::hwtk::dialog .dlg -title "::hwtk::hyperlink" -height 8
set w [.dlg recess]
namespace eval ::test {
proc OnClick { i } {
tk_messageBox -message "You clicked on link $i !!"
}
}
for {set i 1} {$i < 11} {incr i} {
grid [hwtk::label $w.l$i -text "This is a"] \
[hwtk::hyperlink $w.l1$i -text "Hyper link ($i)" -command "::test::OnClick $i"] \
[hwtk::label $w.l2$i -text "widget"]
}
.dlg post