Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ttk_button (1t)

Name

ttk_button - Widget that issues a command when pressed

Synopsis

ttk::button pathName ?options?

Description

ttk::button(1t)                Tk Themed Widget                ttk::button(1t)



______________________________________________________________________________

NAME
       ttk::button - Widget that issues a command when pressed

SYNOPSIS
       ttk::button pathName ?options?
______________________________________________________________________________

DESCRIPTION
       A  ttk::button widget displays a textual label and/or image, and evalu-
       ates a command when pressed.

STANDARD OPTIONS
       -class                -compound            -cursor
       -image                -state               -style
       -takefocus            -text                -textvariable
       -underline            -width

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

WIDGET-SPECIFIC OPTIONS
       Command-Line Name:-command
       Database Name:  command
       Database Class: Command

              A script to evaluate when the widget is invoked.

       Command-Line Name:-default
       Database Name:  default
       Database Class: Default

              May be set to one of  normal, active, or disabled.  In a  dialog
              box, one button may be designated the "default" button (meaning,
              roughly, "the one  that  gets  invoked  when  the  user  presses
              <Enter>").   active indicates that this is currently the default
              button; normal means that it may become the default button,  and
              disabled  means that it is not defaultable.  The default is nor-
              mal.

              Depending on the theme, the default button may be displayed with
              an extra highlight ring, or with a different border color.

       Command-Line Name:-width
       Database Name:  width
       Database Class: Width

              If  greater  than  zero,  specifies how much space, in character
              widths, to allocate for the text  label.   If  less  than  zero,
              specifies  a minimum width.  If zero or unspecified, the natural
              width of the text label is used.   Note  that  some  themes  may
              specify a non-zero -width in the style.

WIDGET COMMAND
       In  addition  to  the  standard cget, configure, identify, instate, and
       state commands, buttons support the following  additional  widget  com-
       mands:

       pathName invoke
              Invokes the command associated with the button.

STANDARD STYLES
       Ttk::button  widgets  support  the  Toolbutton  style  in  all standard
       themes, which is useful for creating widgets for toolbars.

COMPATIBILITY OPTIONS
       Command-Line Name:-state
       Database Name:  state
       Database Class: State

              May be set to normal or disabled to control the  disabled  state
              bit.  This is a "write-only" option: setting it changes the wid-
              get state, but the state widget  command  does  not  affect  the
              state option.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tk-8     |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       ttk::widget(n), button(n)

KEYWORDS
       widget, button, default, command



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source        was        downloaded        from         https://source-
       forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tk                                    8.5                      ttk::button(1t)