# toolbar.addbutton

Creates a toolbar button

Syntax

    toolbar.addbutton [-q] [-d] (<toolbar>,<name>[,<icon>,<text>])<callback command>

Description

Creates a toolbar button named <name> and adds it to the toolbar named <toolbar>.
The toolbar must be existing but not necessairly visible.
The <icon> parameter must be a valid image identifier and defines the image shown in the button.
<text> will be used as "tooltip" text for the button and should contain a short description of the button functionality.
[callback command] is the command that will be called on button press (bound to the active window).
The [-d] switch causes the button to be disabled.
If the button with the same <name> already exists in the <toolbar> then its icon, tooltip text and callback command are updated: this means that you can safely use this command to update some of the button features. toolbar.setbutton is faster function for updating the icon the text or enable state (eventually in a single frame), but the only way to change the button code is to use this command.
The button can be removed from the toolbar by using toolbar.removeitem -q causes the command to run in quiet mode.

See also
toolbar.setbutton toolbar.removeitem

Main index, Command index

KVirc 3.0.0 documentation
Generated by root at Thu Apr 29 12:41:05 2004