ArrowButton

NAME
  ArrowButton - Button widget with an arrow shape.

CREATION
  ArrowButton pathName ?option value...?

STANDARD OPTIONS

  -activebackground
  | -activeforeground -background or -bg | -borderwidth or -bd
  -disabledforeground
  | -foreground or -fg
  -highlightbackground
  | -highlightcolor -highlightthickness
  | -relief -repeatdelay
  | -repeatinterval -takefocus
  | -troughcolor

WIDGET-SPECIFIC OPTIONS

  -armcommand
  | -arrowbd -arrowrelief
  | -clean -command
  | -dir -disarmcommand
  | -height -helptext
  | -helptype -helpvar
  | -ipadx -ipady
  | -state -type
  | -width

WIDGET COMMAND
  pathName cget option
  pathName configure ?option? ?value option value ...?
  pathName invoke

DESCRIPTION

ArrowButton can be of two types following type option: for button type, it is standard button with an arrow drawn on it; for arrow type, it is an arrow like scrollbar's arrow.

WIDGET-SPECIFIC OPTIONS

-armcommand
  Specifies a Tcl command to associate with the ArrowButton when mouse button 1 is pressed over the ArrowButton. When repeatdelay or repeatinterval option is positive integer, this command is repeatedly called if mouse pointer is over the button and until mouse button 1 is released.

-arrowbd
  When ArrowButton type is arrow, specifies the border width of the arrow. Must be 1 or 2.

-arrowrelief
  When ArrowButton type is arrow, specifies the relief of the arrow. Must be raised or sunken.

-clean
  Specifies a level of quality, between 0 and 2, for the arrow. If 0, the arrow is drawn with its maximum width and height. If 1, the base of arrow is arranged to be odd to have same edges. If 2, the base of arrow is arranged to be odd and the orthogonal to be (base+1)/2 to have 'straight' diagonal for edges.

-command
  Specifies a Tcl command to associate with the ArrowButton. This command is typically invoked when mouse button 1 is released over the ArrowButton window.

-dir
  Specifies the direction of the arrow: top, bottom, left or right.

-disarmcommand
  Specifies a Tcl command to associate with the ArrowButton when mouse button 1 is released. This command is called even if pointer is not over the ArrowButton, and always before the command specified by command option. It is typically used in conjuntion with armcommand, repeatdelay and repeatinterval.

-height
  Specifies a desired height for the ArrowButton. The value is in screen units.

-helptext
  Text for dynamic help. If empty, no help is available for this widget. See also DynamicHelp.

-helptype
  Type of dynamic help. Use balloon or variable. See also DynamicHelp.

-helpvar
  Variable to use when helptype option is variable. See also DynamicHelp.

-ipadx
  Specifies a minimun pad between the ArrowButton border and the right and left side of the arrow. The value is in screen units.

-ipady
  Specifies a minimun pad between the ArrowButton border and the top and bottom side of the arrow. The value is in screen units.

-state
  Specifies one of three states for the ArrowButton: normal, active, or disabled.
  If ArrowButton type is button:
    In normal state the ArrowButton is displayed using the foreground and background options. The active state is typically used when the pointer is over the ArrowButton. In active state the ArrowButton is displayed using the activeforeground and activebackground options. In disabled state the disabledforeground and background options determine how the ArrowButton is displayed.
  If ArrowButton type is arrow:
    Only colors of arrow change. The background of ArrowButton is always displayed using troughcolor option. In normal state the ArrowButton is displayed using the background option. The active state is typically used when the pointer is over the ArrowButton. In active state the ArrowButton is displayed using the activebackground option. In disabled state the ArrowButton is displayed with a dark stipple.
  Disabled state means that the ArrowButton should be insensitive: the default bindings will refuse to activate the widget and will ignore mouse button presses.

-type
  Determines the type of the ArrowButton: button for standard button look, or arrow scrollbar's arrow look.

-width
  Specifies a desired width for the ArrowButton. The value is in screen units.

WIDGET COMMAND

pathName cget option
  Returns the current value of the configuration option given by option. Option may have any of the values accepted by the creation command.

pathName configure ?option? ?value option value ...?
  Query or modify the configuration options of the widget. If no option is specified, returns a list describing all of the available options for pathName. If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). 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. Option may have any of the values accepted by the creation command. Read-only options are not be modified.

pathName invoke
  If ArrowButton state is not disabled, this invoke the commands of the button. ArrowButton is redisplayed with active color and sunken relief, and armcommand is called. Then ArrowButton is redisplayed with normal color and its defined relief, and disarmcommand then command are called.

  invoke is called when ArrowButton has input focus and user press the space bar.