📄 ch21_05.htm
字号:
<html><head><title>The Checkbutton Widget (Perl in a Nutshell, 2nd Edition)</title><link rel="stylesheet" type="text/css" href="../style/style1.css" /><meta name="DC.Creator" content="Stephen Spainhour" /><meta name="DC.Format" content="text/xml" scheme="MIME" /><meta name="DC.Language" content="en-US" /><meta name="DC.Publisher" content="O'Reilly & Associates, Inc." /><meta name="DC.Source" scheme="ISBN" content="0596002416L" /><meta name="DC.Subject.Keyword" content="stuff" /><meta name="DC.Title" content="Perl in a Nutshell, 2nd Edition" /><meta name="DC.Type" content="Text.Monograph" /></head><body bgcolor="#ffffff"><img src="gifs/smbanner.gif" usemap="#banner-map" border="0" alt="Book Home" /><map name="banner-map"><area shape="rect" coords="1,-2,616,66" href="index.htm" alt="Java and XSLT" /><area shape="rect" coords="629,-11,726,25" href="jobjects/fsearch.htm" alt="Search this book" /></map><div class="navbar"><table width="684" border="0"><tr><td align="left" valign="top" width="228"><a href="ch21_04.htm"><img src="../gifs/txtpreva.gif" alt="Previous" border="0" /></a></td><td align="center" valign="top" width="228" /><td align="right" valign="top" width="228"><a href="ch21_06.htm"><img src="../gifs/txtnexta.gif" alt="Next" border="0" /></a></td></tr></table></div><h2 class="sect1">21.5. The Checkbutton Widget</h2><p><a name="INDEX-2849" /><a name="INDEX-2850" /><a name="INDEX-2851" />Create a checkbutton with the<tt class="literal">Checkbutton</tt> command. A checkbutton has anindicator to the left of the label indicating whether the button isselected. The boolean status of the button (<tt class="literal">0</tt>,<tt class="literal">1</tt>, or values as specified by the<tt class="literal">-onvalue</tt> and <tt class="literal">-offvalue</tt> options)is stored in the variable specified with the<tt class="literal">-variable</tt> option.</p><blockquote><pre class="code">$parentwidget->Checkbutton (<em class="replaceable"><tt>options</tt></em>)</pre></blockquote><p>The standard configuration options that apply to<tt class="literal">Checkbutton</tt> are:<tt class="literal">-activeback</tt>-<tt class="literal">ground</tt>,<tt class="literal">-activeforeground</tt>, <tt class="literal">-anchor</tt>,<tt class="literal">-background</tt>, <tt class="literal">-bg</tt>,<tt class="literal">-bitmap</tt>, <tt class="literal">-borderwidth</tt>,<tt class="literal">-bd</tt>, <tt class="literal">-cursor</tt>,<tt class="literal">-disabledforeground</tt>, <tt class="literal">-font</tt>,<tt class="literal">-foreground</tt>, <tt class="literal">-fg</tt>,<tt class="literal">-height</tt>,<tt class="literal">-highlight</tt>-<tt class="literal">background</tt>,<tt class="literal">-highlightcolor</tt>,<tt class="literal">-highlightthickness</tt>, <tt class="literal">-image</tt>,<tt class="literal">-justify</tt>, <tt class="literal">-padx</tt>,<tt class="literal">-pady</tt>, <tt class="literal">-relief</tt>,<tt class="literal">-state</tt>, <tt class="literal">-takefocus</tt>,<tt class="literal">-underline</tt>, <tt class="literal">-width</tt>, and<tt class="literal">-wraplength</tt>.</p><p>Other options are:</p><dl><dt><b><tt class="literal">-command =></tt> <em class="replaceable">callback</em></b></dt><dd><a name="INDEX-2852" />Pointer to a function that will becalled when the checkbutton is pressed.</p></dd><dt><b><tt class="literal">-indicatoron =></tt> <em class="replaceable">boolean</em></b></dt><dd><a name="INDEX-2853" />Determines whether to display theindicator. Default is on (<tt class="literal">1</tt>).</p></dd><dt><b><tt class="literal">-offvalue =></tt> <em class="replaceable">newvalue</em></b></dt><dd><a name="INDEX-2854" />Specifies the value used when thecheckbutton is off. Must be a scalar. Default is<tt class="literal">0</tt>. </p></dd><dt><b><tt class="literal">-onvalue =></tt> <em class="replaceable">newvalue</em></b></dt><dd><a name="INDEX-2855" />Specifies the value used when thecheckbutton is on. Must be a scalar. Default is <tt class="literal">1</tt>.</p></dd><dt><b><tt class="literal">-selectcolor =></tt> <em class="replaceable">color</em></b></dt><dd><a name="INDEX-2856" />Color of the indicator when thecheckbutton is on.</p></dd><dt><b><tt class="literal">-selectimage =></tt> <em class="replaceable">imgptr</em></b></dt><dd><a name="INDEX-2857" />Defines the image to be displayedinstead of text when the checkbutton is on. Ignored if<tt class="literal">-image</tt> is not used.</p></dd><dt><b><tt class="literal">-text =></tt> <tt class="literal">'</tt><em class="replaceable">text</em><tt class="literal">'</tt></b></dt><dd><a name="INDEX-2858" />Defines the text string displayed inthe checkbutton. See also <tt class="literal">-textvariable</tt>.</p></dd><dt><b><tt class="literal">-textvariable =></tt> <tt class="literal">\$</tt><em class="replaceable">variable</em></b></dt><dd><a name="INDEX-2859" />Points to the variable containing textto be displayed in the checkbutton. Button text will change as<tt class="literal">$</tt><em class="replaceable"><tt>variable</tt></em> does.</p></dd><dt><b><tt class="literal">-variable =></tt> <tt class="literal">\$</tt><em class="replaceable">variable</em></b></dt><dd><a name="INDEX-2860" />Associates the on/off value of theindicator with the specified variable.</p></dd></dl><a name="perlnut2-CHP-21-SECT-5.1" /><div class="sect2"><h3 class="sect2">21.5.1. Checkbutton Methods</h3><p>In addition to <tt class="literal">configure</tt> and<tt class="literal">cget</tt>, the following methods are supported byCheckbutton:</p><dl><dt><b><tt class="literal">deselect</tt></b></dt><dd><a name="INDEX-2861" />Sets the indicator to off.</p></dd><dt><b><tt class="literal">select</tt></b></dt><dd><a name="INDEX-2862" />Sets the indicator to on.</p></dd><dt><b><tt class="literal">flash</tt></b></dt><dd><a name="INDEX-2863" />Causes the button to flash from thenormal to active state colors.</p></dd><dt><b><tt class="literal">invoke</tt></b></dt><dd><a name="INDEX-2864" />Invokes the callback command as if thecheckbuttons were clicked.</p></dd><dt><b><tt class="literal">toggle</tt></b></dt><dd><a name="INDEX-2865" />Toggles the indicator from on tooff, or from off to on.</p></dd></dl></div><hr width="684" align="left" /><div class="navbar"><table width="684" border="0"><tr><td align="left" valign="top" width="228"><a href="ch21_04.htm"><img src="../gifs/txtpreva.gif" alt="Previous" border="0" /></a></td><td align="center" valign="top" width="228"><a href="index.htm"><img src="../gifs/txthome.gif" alt="Home" border="0" /></a></td><td align="right" valign="top" width="228"><a href="ch21_06.htm"><img src="../gifs/txtnexta.gif" alt="Next" border="0" /></a></td></tr><tr><td align="left" valign="top" width="228">21.4. The Button Widget</td><td align="center" valign="top" width="228"><a href="index/index.htm"><img src="../gifs/index.gif" alt="Book Index" border="0" /></a></td><td align="right" valign="top" width="228">21.6. The Radiobutton Widget</td></tr></table></div><hr width="684" align="left" /><img src="../gifs/navbar.gif" usemap="#library-map" border="0" alt="Library Navigation Links" /><p><p><font size="-1"><a href="copyrght.htm">Copyright © 2002</a> O'Reilly & Associates. All rights reserved.</font></p><map name="library-map"><area shape="rect" coords="1,0,85,94" href="../index.htm"><area shape="rect" coords="86,1,178,103" href="../lwp/index.htm"><area shape="rect" coords="180,0,265,103" href="../lperl/index.htm"><area shape="rect" coords="267,0,353,105" href="../perlnut/index.htm"><area shape="rect" coords="354,1,446,115" href="../prog/index.htm"><area shape="rect" coords="448,0,526,132" href="../tk/index.htm"><area shape="rect" coords="528,1,615,119" href="../cookbook/index.htm"><area shape="rect" coords="617,0,690,135" href="../pxml/index.htm"></map></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -