The Checkbutton Widget
Creates a checkbutton with the Checkbutton
command. A checkbutton has an indicator to the left of the
label indicating whether the button is selected. The boolean
status of the button (“0” or “1”, or values as specified by
the -onvalue
and -offvalue
options) is stored
in the variable specified with the -variable
option.
$parentwidget->Checkbutton (options)
The standard configuration options that apply to CheckButton
are:
-activebackground
,
-activeforeground
,
-anchor
,
-background
,
-bg
,
-bitmap
,
-borderwidth
,
-bd
,
-cursor
,
-disabledforeground
,
-font
,
-foreground
,
-fg
,
-height
,
-highlightbackground
,
-highlightcolor
,
-highlightthickness
,
-image
,
-justify
,
-padx
,
-pady
,
-relief
,
-state
,
-takefocus
,
-underline
,
-width
,
and
-wraplength
.
Other options are:
-
-command =>
callback
Pointer to a function that will be called when the checkbutton is pressed.
-
-indicatoron =>
boolean
Determines whether or not to display the indicator. Default is on (1).
-
-offvalue =>
newvalue
Specifies the value used when the checkbutton is “off.” Must be a scalar. Default is 0.
-
-onvalue =>
newvalue
Specifies the value used when the checkbutton is “on.” Must be a scalar. Default is 1.
-
-selectcolor =>
color
Color of the indicator when the checkbutton is “on.”
-
-selectimage =>
imgptr
Defines the image to be displayed instead of text when the checkbutton is “on.” Ignored if
-image
is not used.-
-text =>
'text
' Defines the text string displayed in the checkbutton. See also
-textvariable
.
Get Perl in a Nutshell now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.