Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ttk_radiobutton (1t)

Name

ttk_radiobutton - Mutually exclusive option widget

Synopsis

ttk::radiobutton pathName ?options?

Description

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



______________________________________________________________________________

NAME
       ttk::radiobutton - Mutually exclusive option widget

SYNOPSIS
       ttk::radiobutton pathName ?options?
______________________________________________________________________________

DESCRIPTION
       ttk::radiobutton  widgets are used in groups to show or change a set of
       mutually-exclusive options.  Radiobuttons are linked to a Tcl variable,
       and  have  an  associated value; when a radiobutton is clicked, it sets
       the variable to its associated value.

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 Tcl script to evaluate whenever the widget is invoked.

       Command-Line Name:-value
       Database Name:  Value
       Database Class: Value

              The value to store in the associated -variable when  the  widget
              is selected.

       Command-Line Name:-variable
       Database Name:  variable
       Database Class: Variable

              The  name of a global variable whose value is linked to the wid-
              get.  Default value is ::selectedButton.

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

       pathname invoke
              Sets the -variable to the -value, selects the widget, and evalu-
              ates  the  associated -command.  Returns the result of the -com-
              mand, or the empty string if no -command is specified.

WIDGET STATES
       The widget does not respond to user input if the disabled state is set.
       The widget sets the selected state whenever the linked -variable is set
       to the widget's -value, and clears it otherwise.  The widget  sets  the
       alternate state whenever the linked -variable is unset.  (The alternate
       state may be used to indicate a "tri-state" or  "indeterminate"  selec-
       tion.)

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


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), ttk::checkbutton(n), radiobutton(n)

KEYWORDS
       widget, button, option



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::radiobutton(1t)