Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
iwidgets::extbutton(1)		[incr Widgets]		iwidgets::extbutton(1)

______________________________________________________________________________

NAME
       iwidgets::extbutton - Extends the behavior of the Tk button by allowing
       a bitmap	or image to coexist with text.

SYNOPSIS
       iwidgets::extbutton pathName ?options?

INHERITANCE
       itk::Widget <- iwidgets::Extbutton

STANDARD OPTIONS
       activebackground	   activeforeground  bitmap
       background	   bd		     cursor
       disabledforeground  font		     foreground
       image		   justify	     relief	 text

       See the "options" manual	entry for details on the standard options.

WIDGET-SPECIFIC	OPTIONS
       Name:	       bitmapforeground
       Class:	       Foreground
       Command-Line Switch:	      -bitmapforeground

	      Configures the foreground	color of the bitmap.

       Name:	       command
       Class:	       Command
       Command-Line Switch:	      -command

	      Associate	a command with the extbutton. Simulates	a Tk  button's
	      -command	option.	 Invoked by either <1> events or by explicitly
	      calling the public invoke() method.

       Name:   defaultring
       Class:  DefaultRing
       Command-Line Switch:    -defaultring

	      Boolean describing whether the extbutton	displays  its  default
	      ring  given  in  any  of the forms acceptable to Tcl_GetBoolean.
	      The default is false.

       Name:   defaultringpad
       Class:  Pad
       Command-Line Switch:    -defaultringpad

	      Specifies	the amount of space to be allocated to the indentation
	      of the default ring ring given in	any of the forms acceptable to
	      Tcl_GetPixels.  The option has no	effect if the defaultring  op-
	      tion is set to false.  The default is 4 pixels.

       Name:   imagePos
       Class:  Position
       Command-Line Switch:    -imagepos

	      Specifies	 the  image  position relative to the message text: n,
	      ne, nw, s, se, sw, w, wn,	ws, e, en, or es. The default is w.

       Name:	       ringBackground
       Class:	       Background
       Command-Line Switch:	      -ringbackground

	      Configures the background	color of the default  ring  frame  (if
	      -defaultring is set to boolean true).

______________________________________________________________________________

DESCRIPTION
       The  extbutton extends the behavior of the atomic Tk button by allowing
       text and	an image or bitmap to coexist. The user	may use	the -image  or
       -bitmap	options	to specify an image as well as the -imagepos option to
       specify image position relative to the text.  Note that	the  extbutton
       is  not	intended  to be	used without an	image/bitmap. There will be an
       emtpy space next	to the text if no image/bitmap is specified.

METHODS
       The iwidgets::extbutton command creates a new Tcl command whose name is
       pathName.  This command may be used to invoke various operations	on the
       widget.	It has the following general form: pathName  option  ?arg  arg
       ...?

INHERITED METHODS
       Each  of	 the  following	methods	are inherited from itk::Archetype. See
       that man	page for details.  pathName cget pathName  component  pathName
       config pathName configure

WIDGET-SPECIFIC	METHODS
       pathName	invoke
	      Evaluates	 the command fragment associated with the -command op-
	      tion.

       pathName	flash
	      Simulates	the Tk button's	flash command.

EXAMPLES
       package require Iwidgets	4.0 iwidgets::extbutton	.eb -text "Bitmap  ex-
       ample" -bitmap info \
	 -background bisque -activeforeground red -bitmapforeground blue \
	 -defaultring 1	-command {puts "Bisque is beautiful"} pack .eb -expand
       1

       iwidgets::extbutton .eb -text "Image example" -relief ridge -image \
	 [image	  create   photo   -file   $itk::library/../iwidgets/demos/im-
       ages/clear.gif] \
	 -font 9x15bold	-background lightgreen -imagepos e \
	 -activebackground lightyellow pack .eb	-expand	1

AUTHOR
       Chad Smith

KEYWORDS
       button, pushbutton

Tk							iwidgets::extbutton(1)

NAME | SYNOPSIS | INHERITANCE | STANDARD OPTIONS | WIDGET-SPECIFIC OPTIONS | DESCRIPTION | METHODS | INHERITED METHODS | WIDGET-SPECIFIC METHODS | EXAMPLES | AUTHOR | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=iwidgets_extbutton&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help