Toolbar Browser
3. Reference
Triggers
Controls
TOOLBAR
CONTROL
BUTTON
MENU
SUBMENU
OPTION
SEPARATOR
COMMAND
COMMANDS
MENUDEFINITIONS
UNINSTALL
Common Parameters
TIMER
Variables
System Variables
Global Values
Functions
Text Functions
 

BUTTON

The BUTTON tag defines a toolbar button.

Syntax:

    <BUTTON

      caption=""
      image=""
      action=""
      default=""
      tooltip=""
      style=""
      hidden=""
      hidecaption=""
      hidechevron=""
      cache=""
      onbeginload=""
      onload=""
      onchange=""

      _b="" (reserved)
      _i="" (reserved)
      _cid="" (reserved)

    ></BUTTON>


    Parameters:


      ParameterDescription
      captionButton Caption
      imageButton Image. The image parameter can specify a link to a ico,bmp,jpeg, or gif format file. Icon functions can also be used to assign system icon.
      actionAction to take whethe button is clicked. This can be a URL or one or more functions separated by semicolons.
      defaultSet the value to 1 to make it the default button. This is only used by the Search() function when one more search commands are defined in the one toolbar.
      tooltipButton tooltip. The value of the tooltp parameter is display when the mouse hovers over the button.
      styleButton style. Can have one of the following values:

        dropdown - Adds a dropdown
        check - check button. A button with this style when clicked stays in the on position.

      hiddenSpecifies whether the button is hidden. Possible values are:

          0 - Button is visible (default)
          1 - Button is hidden
          2 - Button is always hidden. If a button is always hidden, it can not be displayed through the customize toolbar dialog.

      hidecaptionA value of 1 indicates that only the button image will be displayed without the caption.
      hidechevronIf true, the button will not be displayed in the RHS chevron menu. The default value is zero. (requires v2.4.1 or later)
      cacheCache timeout in hours.
      onbeginloadCommands to execute when a new page is about to be loaded.
      onloadCommands to execute when new page finishes loading.
      onchageCommand to execute when the control's value changes



    Remarks:

    • All button parameters are optional. You should however specify at least a caption or an image.


    Compatibility

      The hidechevron parameter is supported in version 2.4.1 or above.