gooderp18绿色标准版
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

806 lines
62KB

  1. <!DOCTYPE html>
  2. <html lang="en" data-content_root="../">
  3. <head>
  4. <meta charset="utf-8" />
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
  6. <meta property="og:title" content="tkinter.tix — Extension widgets for Tk" />
  7. <meta property="og:type" content="website" />
  8. <meta property="og:url" content="https://docs.python.org/3/library/tkinter.tix.html" />
  9. <meta property="og:site_name" content="Python documentation" />
  10. <meta property="og:description" content="Source code: Lib/tkinter/tix.py The tkinter.tix(Tk Interface Extension) module provides an additional rich set of widgets. Although the standard Tk library has many useful widgets, they are far fro..." />
  11. <meta property="og:image" content="https://docs.python.org/3/_static/og-image.png" />
  12. <meta property="og:image:alt" content="Python documentation" />
  13. <meta name="description" content="Source code: Lib/tkinter/tix.py The tkinter.tix(Tk Interface Extension) module provides an additional rich set of widgets. Although the standard Tk library has many useful widgets, they are far fro..." />
  14. <meta property="og:image:width" content="200" />
  15. <meta property="og:image:height" content="200" />
  16. <meta name="theme-color" content="#3776ab" />
  17. <title>tkinter.tix — Extension widgets for Tk &#8212; Python 3.12.3 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
  18. <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />
  19. <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=bb723527" />
  20. <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=b20cc3f5" />
  21. <script src="../_static/documentation_options.js?v=2c828074"></script>
  22. <script src="../_static/doctools.js?v=888ff710"></script>
  23. <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
  24. <script src="../_static/sidebar.js"></script>
  25. <link rel="search" type="application/opensearchdescription+xml"
  26. title="Search within Python 3.12.3 documentation"
  27. href="../_static/opensearch.xml"/>
  28. <link rel="author" title="About these documents" href="../about.html" />
  29. <link rel="index" title="Index" href="../genindex.html" />
  30. <link rel="search" title="Search" href="../search.html" />
  31. <link rel="copyright" title="Copyright" href="../copyright.html" />
  32. <link rel="next" title="IDLE" href="idle.html" />
  33. <link rel="prev" title="tkinter.ttk — Tk themed widgets" href="tkinter.ttk.html" />
  34. <link rel="canonical" href="https://docs.python.org/3/library/tkinter.tix.html" />
  35. <style>
  36. @media only screen {
  37. table.full-width-table {
  38. width: 100%;
  39. }
  40. }
  41. </style>
  42. <link rel="stylesheet" href="../_static/pydoctheme_dark.css" media="(prefers-color-scheme: dark)" id="pydoctheme_dark_css">
  43. <link rel="shortcut icon" type="image/png" href="../_static/py.svg" />
  44. <script type="text/javascript" src="../_static/copybutton.js"></script>
  45. <script type="text/javascript" src="../_static/menu.js"></script>
  46. <script type="text/javascript" src="../_static/search-focus.js"></script>
  47. <script type="text/javascript" src="../_static/themetoggle.js"></script>
  48. </head>
  49. <body>
  50. <div class="mobile-nav">
  51. <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"
  52. aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />
  53. <nav class="nav-content" role="navigation">
  54. <label for="menuToggler" class="toggler__label">
  55. <span></span>
  56. </label>
  57. <span class="nav-items-wrapper">
  58. <a href="https://www.python.org/" class="nav-logo">
  59. <img src="../_static/py.svg" alt="Python logo"/>
  60. </a>
  61. <span class="version_switcher_placeholder"></span>
  62. <form role="search" class="search" action="../search.html" method="get">
  63. <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">
  64. <path fill-rule="nonzero" fill="currentColor" d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"></path>
  65. </svg>
  66. <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" />
  67. <input type="submit" value="Go"/>
  68. </form>
  69. </span>
  70. </nav>
  71. <div class="menu-wrapper">
  72. <nav class="menu" role="navigation" aria-label="main navigation">
  73. <div class="language_switcher_placeholder"></div>
  74. <label class="theme-selector-label">
  75. Theme
  76. <select class="theme-selector" oninput="activateTheme(this.value)">
  77. <option value="auto" selected>Auto</option>
  78. <option value="light">Light</option>
  79. <option value="dark">Dark</option>
  80. </select>
  81. </label>
  82. <div>
  83. <h3><a href="../contents.html">Table of Contents</a></h3>
  84. <ul>
  85. <li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code> — Extension widgets for Tk</a><ul>
  86. <li><a class="reference internal" href="#using-tix">Using Tix</a></li>
  87. <li><a class="reference internal" href="#tix-widgets">Tix Widgets</a><ul>
  88. <li><a class="reference internal" href="#basic-widgets">Basic Widgets</a></li>
  89. <li><a class="reference internal" href="#file-selectors">File Selectors</a></li>
  90. <li><a class="reference internal" href="#hierarchical-listbox">Hierarchical ListBox</a></li>
  91. <li><a class="reference internal" href="#tabular-listbox">Tabular ListBox</a></li>
  92. <li><a class="reference internal" href="#manager-widgets">Manager Widgets</a></li>
  93. <li><a class="reference internal" href="#image-types">Image Types</a></li>
  94. <li><a class="reference internal" href="#miscellaneous-widgets">Miscellaneous Widgets</a></li>
  95. <li><a class="reference internal" href="#form-geometry-manager">Form Geometry Manager</a></li>
  96. </ul>
  97. </li>
  98. <li><a class="reference internal" href="#tix-commands">Tix Commands</a></li>
  99. </ul>
  100. </li>
  101. </ul>
  102. </div>
  103. <div>
  104. <h4>Previous topic</h4>
  105. <p class="topless"><a href="tkinter.ttk.html"
  106. title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.ttk</span></code> — Tk themed widgets</a></p>
  107. </div>
  108. <div>
  109. <h4>Next topic</h4>
  110. <p class="topless"><a href="idle.html"
  111. title="next chapter">IDLE</a></p>
  112. </div>
  113. <div role="note" aria-label="source link">
  114. <h3>This Page</h3>
  115. <ul class="this-page-menu">
  116. <li><a href="../bugs.html">Report a Bug</a></li>
  117. <li>
  118. <a href="https://github.com/python/cpython/blob/main/Doc/library/tkinter.tix.rst"
  119. rel="nofollow">Show Source
  120. </a>
  121. </li>
  122. </ul>
  123. </div>
  124. </nav>
  125. </div>
  126. </div>
  127. <div class="related" role="navigation" aria-label="related navigation">
  128. <h3>Navigation</h3>
  129. <ul>
  130. <li class="right" style="margin-right: 10px">
  131. <a href="../genindex.html" title="General Index"
  132. accesskey="I">index</a></li>
  133. <li class="right" >
  134. <a href="../py-modindex.html" title="Python Module Index"
  135. >modules</a> |</li>
  136. <li class="right" >
  137. <a href="idle.html" title="IDLE"
  138. accesskey="N">next</a> |</li>
  139. <li class="right" >
  140. <a href="tkinter.ttk.html" title="tkinter.ttk — Tk themed widgets"
  141. accesskey="P">previous</a> |</li>
  142. <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>
  143. <li><a href="https://www.python.org/">Python</a> &#187;</li>
  144. <li class="switchers">
  145. <div class="language_switcher_placeholder"></div>
  146. <div class="version_switcher_placeholder"></div>
  147. </li>
  148. <li>
  149. </li>
  150. <li id="cpython-language-and-version">
  151. <a href="../index.html">3.12.3 Documentation</a> &#187;
  152. </li>
  153. <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>
  154. <li class="nav-item nav-item-2"><a href="tk.html" accesskey="U">Graphical User Interfaces with Tk</a> &#187;</li>
  155. <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code> — Extension widgets for Tk</a></li>
  156. <li class="right">
  157. <div class="inline-search" role="search">
  158. <form class="inline-search" action="../search.html" method="get">
  159. <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />
  160. <input type="submit" value="Go" />
  161. </form>
  162. </div>
  163. |
  164. </li>
  165. <li class="right">
  166. <label class="theme-selector-label">
  167. Theme
  168. <select class="theme-selector" oninput="activateTheme(this.value)">
  169. <option value="auto" selected>Auto</option>
  170. <option value="light">Light</option>
  171. <option value="dark">Dark</option>
  172. </select>
  173. </label> |</li>
  174. </ul>
  175. </div>
  176. <div class="document">
  177. <div class="documentwrapper">
  178. <div class="bodywrapper">
  179. <div class="body" role="main">
  180. <section id="module-tkinter.tix">
  181. <span id="tkinter-tix-extension-widgets-for-tk"></span><h1><a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a> — Extension widgets for Tk<a class="headerlink" href="#module-tkinter.tix" title="Link to this heading">¶</a></h1>
  182. <p><strong>Source code:</strong> <a class="reference external" href="https://github.com/python/cpython/tree/3.12/Lib/tkinter/tix.py">Lib/tkinter/tix.py</a></p>
  183. <div class="deprecated" id="index-0">
  184. <p><span class="versionmodified deprecated">Deprecated since version 3.6: </span>This Tk extension is unmaintained and should not be used in new code. Use
  185. <a class="reference internal" href="tkinter.ttk.html#module-tkinter.ttk" title="tkinter.ttk: Tk themed widget set"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.ttk</span></code></a> instead.</p>
  186. </div>
  187. <hr class="docutils" />
  188. <p>The <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a> (Tk Interface Extension) module provides an additional
  189. rich set of widgets. Although the standard Tk library has many useful widgets,
  190. they are far from complete. The <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a> library provides most of the
  191. commonly needed widgets that are missing from standard Tk: <a class="reference internal" href="#tkinter.tix.HList" title="tkinter.tix.HList"><code class="xref py py-class docutils literal notranslate"><span class="pre">HList</span></code></a>,
  192. <a class="reference internal" href="#tkinter.tix.ComboBox" title="tkinter.tix.ComboBox"><code class="xref py py-class docutils literal notranslate"><span class="pre">ComboBox</span></code></a>, <a class="reference internal" href="#tkinter.tix.Control" title="tkinter.tix.Control"><code class="xref py py-class docutils literal notranslate"><span class="pre">Control</span></code></a> (a.k.a. SpinBox) and an assortment of
  193. scrollable widgets.
  194. <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a> also includes many more widgets that are generally useful in
  195. a wide range of applications: <a class="reference internal" href="#tkinter.tix.NoteBook" title="tkinter.tix.NoteBook"><code class="xref py py-class docutils literal notranslate"><span class="pre">NoteBook</span></code></a>, <a class="reference internal" href="#tkinter.tix.FileEntry" title="tkinter.tix.FileEntry"><code class="xref py py-class docutils literal notranslate"><span class="pre">FileEntry</span></code></a>,
  196. <a class="reference internal" href="#tkinter.tix.PanedWindow" title="tkinter.tix.PanedWindow"><code class="xref py py-class docutils literal notranslate"><span class="pre">PanedWindow</span></code></a>, etc; there are more than 40 of them.</p>
  197. <p>With all these new widgets, you can introduce new interaction techniques into
  198. applications, creating more useful and more intuitive user interfaces. You can
  199. design your application by choosing the most appropriate widgets to match the
  200. special needs of your application and users.</p>
  201. <div class="admonition seealso">
  202. <p class="admonition-title">See also</p>
  203. <dl class="simple">
  204. <dt><a class="reference external" href="https://tix.sourceforge.net/">Tix Homepage</a></dt><dd><p>The home page for <code class="xref py py-mod docutils literal notranslate"><span class="pre">Tix</span></code>. This includes links to additional documentation
  205. and downloads.</p>
  206. </dd>
  207. <dt><a class="reference external" href="https://tix.sourceforge.net/dist/current/man/">Tix Man Pages</a></dt><dd><p>On-line version of the man pages and reference material.</p>
  208. </dd>
  209. <dt><a class="reference external" href="https://tix.sourceforge.net/dist/current/docs/tix-book/tix.book.html">Tix Programming Guide</a></dt><dd><p>On-line version of the programmer’s reference material.</p>
  210. </dd>
  211. <dt><a class="reference external" href="https://tix.sourceforge.net/Tixapps/src/Tide.html">Tix Development Applications</a></dt><dd><p>Tix applications for development of Tix and Tkinter programs. Tide applications
  212. work under Tk or Tkinter, and include <strong class="program">TixInspect</strong>, an inspector to
  213. remotely modify and debug Tix/Tk/Tkinter applications.</p>
  214. </dd>
  215. </dl>
  216. </div>
  217. <section id="using-tix">
  218. <h2>Using Tix<a class="headerlink" href="#using-tix" title="Link to this heading">¶</a></h2>
  219. <dl class="py class">
  220. <dt class="sig sig-object py" id="tkinter.tix.Tk">
  221. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">Tk</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">screenName</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">baseName</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">className</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'Tix'</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.tix.Tk" title="Link to this definition">¶</a></dt>
  222. <dd><p>Toplevel widget of Tix which represents mostly the main window of an
  223. application. It has an associated Tcl interpreter.</p>
  224. <p>Classes in the <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a> module subclasses the classes in the
  225. <a class="reference internal" href="tkinter.html#module-tkinter" title="tkinter: Interface to Tcl/Tk for graphical user interfaces"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter</span></code></a>. The former imports the latter, so to use <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a>
  226. with Tkinter, all you need to do is to import one module. In general, you
  227. can just import <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a>, and replace the toplevel call to
  228. <a class="reference internal" href="tkinter.html#tkinter.Tk" title="tkinter.Tk"><code class="xref py py-class docutils literal notranslate"><span class="pre">tkinter.Tk</span></code></a> with <code class="xref py py-class docutils literal notranslate"><span class="pre">tix.Tk</span></code>:</p>
  229. <div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">tkinter</span> <span class="kn">import</span> <span class="n">tix</span>
  230. <span class="kn">from</span> <span class="nn">tkinter.constants</span> <span class="kn">import</span> <span class="o">*</span>
  231. <span class="n">root</span> <span class="o">=</span> <span class="n">tix</span><span class="o">.</span><span class="n">Tk</span><span class="p">()</span>
  232. </pre></div>
  233. </div>
  234. </dd></dl>
  235. <p>To use <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a>, you must have the Tix widgets installed, usually
  236. alongside your installation of the Tk widgets. To test your installation, try
  237. the following:</p>
  238. <div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">tkinter</span> <span class="kn">import</span> <span class="n">tix</span>
  239. <span class="n">root</span> <span class="o">=</span> <span class="n">tix</span><span class="o">.</span><span class="n">Tk</span><span class="p">()</span>
  240. <span class="n">root</span><span class="o">.</span><span class="n">tk</span><span class="o">.</span><span class="n">eval</span><span class="p">(</span><span class="s1">&#39;package require Tix&#39;</span><span class="p">)</span>
  241. </pre></div>
  242. </div>
  243. </section>
  244. <section id="tix-widgets">
  245. <h2>Tix Widgets<a class="headerlink" href="#tix-widgets" title="Link to this heading">¶</a></h2>
  246. <p><a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/TixIntro.htm">Tix</a>
  247. introduces over 40 widget classes to the <a class="reference internal" href="tkinter.html#module-tkinter" title="tkinter: Interface to Tcl/Tk for graphical user interfaces"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter</span></code></a> repertoire.</p>
  248. <section id="basic-widgets">
  249. <h3>Basic Widgets<a class="headerlink" href="#basic-widgets" title="Link to this heading">¶</a></h3>
  250. <dl class="py class">
  251. <dt class="sig sig-object py" id="tkinter.tix.Balloon">
  252. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">Balloon</span></span><a class="headerlink" href="#tkinter.tix.Balloon" title="Link to this definition">¶</a></dt>
  253. <dd><p>A <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixBalloon.htm">Balloon</a> that
  254. pops up over a widget to provide help. When the user moves the cursor inside a
  255. widget to which a Balloon widget has been bound, a small pop-up window with a
  256. descriptive message will be shown on the screen.</p>
  257. </dd></dl>
  258. <dl class="py class">
  259. <dt class="sig sig-object py" id="tkinter.tix.ButtonBox">
  260. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">ButtonBox</span></span><a class="headerlink" href="#tkinter.tix.ButtonBox" title="Link to this definition">¶</a></dt>
  261. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixButtonBox.htm">ButtonBox</a>
  262. widget creates a box of buttons, such as is commonly used for <code class="docutils literal notranslate"><span class="pre">Ok</span> <span class="pre">Cancel</span></code>.</p>
  263. </dd></dl>
  264. <dl class="py class">
  265. <dt class="sig sig-object py" id="tkinter.tix.ComboBox">
  266. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">ComboBox</span></span><a class="headerlink" href="#tkinter.tix.ComboBox" title="Link to this definition">¶</a></dt>
  267. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixComboBox.htm">ComboBox</a>
  268. widget is similar to the combo box control in MS Windows. The user can select a
  269. choice by either typing in the entry subwidget or selecting from the listbox
  270. subwidget.</p>
  271. </dd></dl>
  272. <dl class="py class">
  273. <dt class="sig sig-object py" id="tkinter.tix.Control">
  274. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">Control</span></span><a class="headerlink" href="#tkinter.tix.Control" title="Link to this definition">¶</a></dt>
  275. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixControl.htm">Control</a>
  276. widget is also known as the <code class="xref py py-class docutils literal notranslate"><span class="pre">SpinBox</span></code> widget. The user can adjust the
  277. value by pressing the two arrow buttons or by entering the value directly into
  278. the entry. The new value will be checked against the user-defined upper and
  279. lower limits.</p>
  280. </dd></dl>
  281. <dl class="py class">
  282. <dt class="sig sig-object py" id="tkinter.tix.LabelEntry">
  283. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">LabelEntry</span></span><a class="headerlink" href="#tkinter.tix.LabelEntry" title="Link to this definition">¶</a></dt>
  284. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixLabelEntry.htm">LabelEntry</a>
  285. widget packages an entry widget and a label into one mega widget. It can
  286. be used to simplify the creation of “entry-form” type of interface.</p>
  287. </dd></dl>
  288. <dl class="py class">
  289. <dt class="sig sig-object py" id="tkinter.tix.LabelFrame">
  290. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">LabelFrame</span></span><a class="headerlink" href="#tkinter.tix.LabelFrame" title="Link to this definition">¶</a></dt>
  291. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixLabelFrame.htm">LabelFrame</a>
  292. widget packages a frame widget and a label into one mega widget. To create
  293. widgets inside a LabelFrame widget, one creates the new widgets relative to the
  294. <code class="xref py py-attr docutils literal notranslate"><span class="pre">frame</span></code> subwidget and manage them inside the <code class="xref py py-attr docutils literal notranslate"><span class="pre">frame</span></code> subwidget.</p>
  295. </dd></dl>
  296. <dl class="py class">
  297. <dt class="sig sig-object py" id="tkinter.tix.Meter">
  298. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">Meter</span></span><a class="headerlink" href="#tkinter.tix.Meter" title="Link to this definition">¶</a></dt>
  299. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixMeter.htm">Meter</a> widget
  300. can be used to show the progress of a background job which may take a long time
  301. to execute.</p>
  302. </dd></dl>
  303. <dl class="py class">
  304. <dt class="sig sig-object py" id="tkinter.tix.OptionMenu">
  305. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">OptionMenu</span></span><a class="headerlink" href="#tkinter.tix.OptionMenu" title="Link to this definition">¶</a></dt>
  306. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixOptionMenu.htm">OptionMenu</a>
  307. creates a menu button of options.</p>
  308. </dd></dl>
  309. <dl class="py class">
  310. <dt class="sig sig-object py" id="tkinter.tix.PopupMenu">
  311. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">PopupMenu</span></span><a class="headerlink" href="#tkinter.tix.PopupMenu" title="Link to this definition">¶</a></dt>
  312. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixPopupMenu.htm">PopupMenu</a>
  313. widget can be used as a replacement of the <code class="docutils literal notranslate"><span class="pre">tk_popup</span></code> command. The advantage
  314. of the <code class="xref py py-mod docutils literal notranslate"><span class="pre">Tix</span></code> <a class="reference internal" href="#tkinter.tix.PopupMenu" title="tkinter.tix.PopupMenu"><code class="xref py py-class docutils literal notranslate"><span class="pre">PopupMenu</span></code></a> widget is it requires less application code
  315. to manipulate.</p>
  316. </dd></dl>
  317. <dl class="py class">
  318. <dt class="sig sig-object py" id="tkinter.tix.Select">
  319. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">Select</span></span><a class="headerlink" href="#tkinter.tix.Select" title="Link to this definition">¶</a></dt>
  320. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixSelect.htm">Select</a> widget
  321. is a container of button subwidgets. It can be used to provide radio-box or
  322. check-box style of selection options for the user.</p>
  323. </dd></dl>
  324. <dl class="py class">
  325. <dt class="sig sig-object py" id="tkinter.tix.StdButtonBox">
  326. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">StdButtonBox</span></span><a class="headerlink" href="#tkinter.tix.StdButtonBox" title="Link to this definition">¶</a></dt>
  327. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixStdButtonBox.htm">StdButtonBox</a>
  328. widget is a group of standard buttons for Motif-like dialog boxes.</p>
  329. </dd></dl>
  330. </section>
  331. <section id="file-selectors">
  332. <h3>File Selectors<a class="headerlink" href="#file-selectors" title="Link to this heading">¶</a></h3>
  333. <dl class="py class">
  334. <dt class="sig sig-object py" id="tkinter.tix.DirList">
  335. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">DirList</span></span><a class="headerlink" href="#tkinter.tix.DirList" title="Link to this definition">¶</a></dt>
  336. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixDirList.htm">DirList</a>
  337. widget displays a list view of a directory, its previous directories and its
  338. sub-directories. The user can choose one of the directories displayed in the
  339. list or change to another directory.</p>
  340. </dd></dl>
  341. <dl class="py class">
  342. <dt class="sig sig-object py" id="tkinter.tix.DirTree">
  343. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">DirTree</span></span><a class="headerlink" href="#tkinter.tix.DirTree" title="Link to this definition">¶</a></dt>
  344. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixDirTree.htm">DirTree</a>
  345. widget displays a tree view of a directory, its previous directories and its
  346. sub-directories. The user can choose one of the directories displayed in the
  347. list or change to another directory.</p>
  348. </dd></dl>
  349. <dl class="py class">
  350. <dt class="sig sig-object py" id="tkinter.tix.DirSelectDialog">
  351. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">DirSelectDialog</span></span><a class="headerlink" href="#tkinter.tix.DirSelectDialog" title="Link to this definition">¶</a></dt>
  352. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixDirSelectDialog.htm">DirSelectDialog</a>
  353. widget presents the directories in the file system in a dialog window. The user
  354. can use this dialog window to navigate through the file system to select the
  355. desired directory.</p>
  356. </dd></dl>
  357. <dl class="py class">
  358. <dt class="sig sig-object py" id="tkinter.tix.DirSelectBox">
  359. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">DirSelectBox</span></span><a class="headerlink" href="#tkinter.tix.DirSelectBox" title="Link to this definition">¶</a></dt>
  360. <dd><p>The <a class="reference internal" href="#tkinter.tix.DirSelectBox" title="tkinter.tix.DirSelectBox"><code class="xref py py-class docutils literal notranslate"><span class="pre">DirSelectBox</span></code></a> is similar to the standard Motif(TM)
  361. directory-selection box. It is generally used for the user to choose a
  362. directory. DirSelectBox stores the directories mostly recently selected into
  363. a ComboBox widget so that they can be quickly selected again.</p>
  364. </dd></dl>
  365. <dl class="py class">
  366. <dt class="sig sig-object py" id="tkinter.tix.ExFileSelectBox">
  367. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">ExFileSelectBox</span></span><a class="headerlink" href="#tkinter.tix.ExFileSelectBox" title="Link to this definition">¶</a></dt>
  368. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixExFileSelectBox.htm">ExFileSelectBox</a>
  369. widget is usually embedded in a tixExFileSelectDialog widget. It provides a
  370. convenient method for the user to select files. The style of the
  371. <a class="reference internal" href="#tkinter.tix.ExFileSelectBox" title="tkinter.tix.ExFileSelectBox"><code class="xref py py-class docutils literal notranslate"><span class="pre">ExFileSelectBox</span></code></a> widget is very similar to the standard file dialog on
  372. MS Windows 3.1.</p>
  373. </dd></dl>
  374. <dl class="py class">
  375. <dt class="sig sig-object py" id="tkinter.tix.FileSelectBox">
  376. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">FileSelectBox</span></span><a class="headerlink" href="#tkinter.tix.FileSelectBox" title="Link to this definition">¶</a></dt>
  377. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixFileSelectBox.htm">FileSelectBox</a>
  378. is similar to the standard Motif(TM) file-selection box. It is generally used
  379. for the user to choose a file. FileSelectBox stores the files mostly recently
  380. selected into a <a class="reference internal" href="#tkinter.tix.ComboBox" title="tkinter.tix.ComboBox"><code class="xref py py-class docutils literal notranslate"><span class="pre">ComboBox</span></code></a> widget so that they can be quickly selected
  381. again.</p>
  382. </dd></dl>
  383. <dl class="py class">
  384. <dt class="sig sig-object py" id="tkinter.tix.FileEntry">
  385. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">FileEntry</span></span><a class="headerlink" href="#tkinter.tix.FileEntry" title="Link to this definition">¶</a></dt>
  386. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixFileEntry.htm">FileEntry</a>
  387. widget can be used to input a filename. The user can type in the filename
  388. manually. Alternatively, the user can press the button widget that sits next to
  389. the entry, which will bring up a file selection dialog.</p>
  390. </dd></dl>
  391. </section>
  392. <section id="hierarchical-listbox">
  393. <h3>Hierarchical ListBox<a class="headerlink" href="#hierarchical-listbox" title="Link to this heading">¶</a></h3>
  394. <dl class="py class">
  395. <dt class="sig sig-object py" id="tkinter.tix.HList">
  396. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">HList</span></span><a class="headerlink" href="#tkinter.tix.HList" title="Link to this definition">¶</a></dt>
  397. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixHList.htm">HList</a> widget
  398. can be used to display any data that have a hierarchical structure, for example,
  399. file system directory trees. The list entries are indented and connected by
  400. branch lines according to their places in the hierarchy.</p>
  401. </dd></dl>
  402. <dl class="py class">
  403. <dt class="sig sig-object py" id="tkinter.tix.CheckList">
  404. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">CheckList</span></span><a class="headerlink" href="#tkinter.tix.CheckList" title="Link to this definition">¶</a></dt>
  405. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixCheckList.htm">CheckList</a>
  406. widget displays a list of items to be selected by the user. CheckList acts
  407. similarly to the Tk checkbutton or radiobutton widgets, except it is capable of
  408. handling many more items than checkbuttons or radiobuttons.</p>
  409. </dd></dl>
  410. <dl class="py class">
  411. <dt class="sig sig-object py" id="tkinter.tix.Tree">
  412. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">Tree</span></span><a class="headerlink" href="#tkinter.tix.Tree" title="Link to this definition">¶</a></dt>
  413. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixTree.htm">Tree</a> widget
  414. can be used to display hierarchical data in a tree form. The user can adjust the
  415. view of the tree by opening or closing parts of the tree.</p>
  416. </dd></dl>
  417. </section>
  418. <section id="tabular-listbox">
  419. <h3>Tabular ListBox<a class="headerlink" href="#tabular-listbox" title="Link to this heading">¶</a></h3>
  420. <dl class="py class">
  421. <dt class="sig sig-object py" id="tkinter.tix.TList">
  422. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">TList</span></span><a class="headerlink" href="#tkinter.tix.TList" title="Link to this definition">¶</a></dt>
  423. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixTList.htm">TList</a> widget
  424. can be used to display data in a tabular format. The list entries of a
  425. <a class="reference internal" href="#tkinter.tix.TList" title="tkinter.tix.TList"><code class="xref py py-class docutils literal notranslate"><span class="pre">TList</span></code></a> widget are similar to the entries in the Tk listbox widget. The
  426. main differences are (1) the <a class="reference internal" href="#tkinter.tix.TList" title="tkinter.tix.TList"><code class="xref py py-class docutils literal notranslate"><span class="pre">TList</span></code></a> widget can display the list entries
  427. in a two dimensional format and (2) you can use graphical images as well as
  428. multiple colors and fonts for the list entries.</p>
  429. </dd></dl>
  430. </section>
  431. <section id="manager-widgets">
  432. <h3>Manager Widgets<a class="headerlink" href="#manager-widgets" title="Link to this heading">¶</a></h3>
  433. <dl class="py class">
  434. <dt class="sig sig-object py" id="tkinter.tix.PanedWindow">
  435. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">PanedWindow</span></span><a class="headerlink" href="#tkinter.tix.PanedWindow" title="Link to this definition">¶</a></dt>
  436. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixPanedWindow.htm">PanedWindow</a>
  437. widget allows the user to interactively manipulate the sizes of several panes.
  438. The panes can be arranged either vertically or horizontally. The user changes
  439. the sizes of the panes by dragging the resize handle between two panes.</p>
  440. </dd></dl>
  441. <dl class="py class">
  442. <dt class="sig sig-object py" id="tkinter.tix.ListNoteBook">
  443. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">ListNoteBook</span></span><a class="headerlink" href="#tkinter.tix.ListNoteBook" title="Link to this definition">¶</a></dt>
  444. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixListNoteBook.htm">ListNoteBook</a>
  445. widget is very similar to the <code class="xref py py-class docutils literal notranslate"><span class="pre">TixNoteBook</span></code> widget: it can be used to
  446. display many windows in a limited space using a notebook metaphor. The notebook
  447. is divided into a stack of pages (windows). At one time only one of these pages
  448. can be shown. The user can navigate through these pages by choosing the name of
  449. the desired page in the <code class="xref py py-attr docutils literal notranslate"><span class="pre">hlist</span></code> subwidget.</p>
  450. </dd></dl>
  451. <dl class="py class">
  452. <dt class="sig sig-object py" id="tkinter.tix.NoteBook">
  453. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">NoteBook</span></span><a class="headerlink" href="#tkinter.tix.NoteBook" title="Link to this definition">¶</a></dt>
  454. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixNoteBook.htm">NoteBook</a>
  455. widget can be used to display many windows in a limited space using a notebook
  456. metaphor. The notebook is divided into a stack of pages. At one time only one of
  457. these pages can be shown. The user can navigate through these pages by choosing
  458. the visual “tabs” at the top of the NoteBook widget.</p>
  459. </dd></dl>
  460. </section>
  461. <section id="image-types">
  462. <h3>Image Types<a class="headerlink" href="#image-types" title="Link to this heading">¶</a></h3>
  463. <p>The <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a> module adds:</p>
  464. <ul class="simple">
  465. <li><p><a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/pixmap.htm">pixmap</a>
  466. capabilities to all <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a> and <a class="reference internal" href="tkinter.html#module-tkinter" title="tkinter: Interface to Tcl/Tk for graphical user interfaces"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter</span></code></a> widgets to create
  467. color images from XPM files.</p>
  468. </li>
  469. <li><p><a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/compound.htm">Compound</a> image
  470. types can be used to create images that consists of multiple horizontal lines;
  471. each line is composed of a series of items (texts, bitmaps, images or spaces)
  472. arranged from left to right. For example, a compound image can be used to
  473. display a bitmap and a text string simultaneously in a Tk <code class="xref py py-class docutils literal notranslate"><span class="pre">Button</span></code>
  474. widget.</p>
  475. </li>
  476. </ul>
  477. </section>
  478. <section id="miscellaneous-widgets">
  479. <h3>Miscellaneous Widgets<a class="headerlink" href="#miscellaneous-widgets" title="Link to this heading">¶</a></h3>
  480. <dl class="py class">
  481. <dt class="sig sig-object py" id="tkinter.tix.InputOnly">
  482. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">InputOnly</span></span><a class="headerlink" href="#tkinter.tix.InputOnly" title="Link to this definition">¶</a></dt>
  483. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixInputOnly.htm">InputOnly</a>
  484. widgets are to accept inputs from the user, which can be done with the <code class="docutils literal notranslate"><span class="pre">bind</span></code>
  485. command (Unix only).</p>
  486. </dd></dl>
  487. </section>
  488. <section id="form-geometry-manager">
  489. <h3>Form Geometry Manager<a class="headerlink" href="#form-geometry-manager" title="Link to this heading">¶</a></h3>
  490. <p>In addition, <a class="reference internal" href="#module-tkinter.tix" title="tkinter.tix: Tk Extension Widgets for Tkinter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code></a> augments <a class="reference internal" href="tkinter.html#module-tkinter" title="tkinter: Interface to Tcl/Tk for graphical user interfaces"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter</span></code></a> by providing:</p>
  491. <dl class="py class">
  492. <dt class="sig sig-object py" id="tkinter.tix.Form">
  493. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">Form</span></span><a class="headerlink" href="#tkinter.tix.Form" title="Link to this definition">¶</a></dt>
  494. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tixForm.htm">Form</a> geometry
  495. manager based on attachment rules for all Tk widgets.</p>
  496. </dd></dl>
  497. </section>
  498. </section>
  499. <section id="tix-commands">
  500. <h2>Tix Commands<a class="headerlink" href="#tix-commands" title="Link to this heading">¶</a></h2>
  501. <dl class="py class">
  502. <dt class="sig sig-object py" id="tkinter.tix.tixCommand">
  503. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.tix.</span></span><span class="sig-name descname"><span class="pre">tixCommand</span></span><a class="headerlink" href="#tkinter.tix.tixCommand" title="Link to this definition">¶</a></dt>
  504. <dd><p>The <a class="reference external" href="https://tix.sourceforge.net/dist/current/man/html/TixCmd/tix.htm">tix commands</a> provide
  505. access to miscellaneous elements of <code class="xref py py-mod docutils literal notranslate"><span class="pre">Tix</span></code>’s internal state and the
  506. <code class="xref py py-mod docutils literal notranslate"><span class="pre">Tix</span></code> application context. Most of the information manipulated by these
  507. methods pertains to the application as a whole, or to a screen or display,
  508. rather than to a particular window.</p>
  509. <p>To view the current settings, the common usage is:</p>
  510. <div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">tkinter</span> <span class="kn">import</span> <span class="n">tix</span>
  511. <span class="n">root</span> <span class="o">=</span> <span class="n">tix</span><span class="o">.</span><span class="n">Tk</span><span class="p">()</span>
  512. <span class="nb">print</span><span class="p">(</span><span class="n">root</span><span class="o">.</span><span class="n">tix_configure</span><span class="p">())</span>
  513. </pre></div>
  514. </div>
  515. </dd></dl>
  516. <dl class="py method">
  517. <dt class="sig sig-object py" id="tkinter.tix.tixCommand.tix_configure">
  518. <span class="sig-prename descclassname"><span class="pre">tixCommand.</span></span><span class="sig-name descname"><span class="pre">tix_configure</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">cnf</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kw</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.tix.tixCommand.tix_configure" title="Link to this definition">¶</a></dt>
  519. <dd><p>Query or modify the configuration options of the Tix application context. If no
  520. option is specified, returns a dictionary all of the available options. If
  521. option is specified with no value, then the method returns a list describing the
  522. one named option (this list will be identical to the corresponding sublist of
  523. the value returned if no option is specified). If one or more option-value
  524. pairs are specified, then the method modifies the given option(s) to have the
  525. given value(s); in this case the method returns an empty string. Option may be
  526. any of the configuration options.</p>
  527. </dd></dl>
  528. <dl class="py method">
  529. <dt class="sig sig-object py" id="tkinter.tix.tixCommand.tix_cget">
  530. <span class="sig-prename descclassname"><span class="pre">tixCommand.</span></span><span class="sig-name descname"><span class="pre">tix_cget</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">option</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.tix.tixCommand.tix_cget" title="Link to this definition">¶</a></dt>
  531. <dd><p>Returns the current value of the configuration option given by <em>option</em>. Option
  532. may be any of the configuration options.</p>
  533. </dd></dl>
  534. <dl class="py method">
  535. <dt class="sig sig-object py" id="tkinter.tix.tixCommand.tix_getbitmap">
  536. <span class="sig-prename descclassname"><span class="pre">tixCommand.</span></span><span class="sig-name descname"><span class="pre">tix_getbitmap</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">name</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.tix.tixCommand.tix_getbitmap" title="Link to this definition">¶</a></dt>
  537. <dd><p>Locates a bitmap file of the name <code class="docutils literal notranslate"><span class="pre">name.xpm</span></code> or <code class="docutils literal notranslate"><span class="pre">name</span></code> in one of the bitmap
  538. directories (see the <a class="reference internal" href="#tkinter.tix.tixCommand.tix_addbitmapdir" title="tkinter.tix.tixCommand.tix_addbitmapdir"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_addbitmapdir()</span></code></a> method). By using
  539. <a class="reference internal" href="#tkinter.tix.tixCommand.tix_getbitmap" title="tkinter.tix.tixCommand.tix_getbitmap"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_getbitmap()</span></code></a>, you can avoid hard coding the pathnames of the bitmap
  540. files in your application. When successful, it returns the complete pathname of
  541. the bitmap file, prefixed with the character <code class="docutils literal notranslate"><span class="pre">&#64;</span></code>. The returned value can be
  542. used to configure the <code class="docutils literal notranslate"><span class="pre">bitmap</span></code> option of the Tk and Tix widgets.</p>
  543. </dd></dl>
  544. <dl class="py method">
  545. <dt class="sig sig-object py" id="tkinter.tix.tixCommand.tix_addbitmapdir">
  546. <span class="sig-prename descclassname"><span class="pre">tixCommand.</span></span><span class="sig-name descname"><span class="pre">tix_addbitmapdir</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">directory</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.tix.tixCommand.tix_addbitmapdir" title="Link to this definition">¶</a></dt>
  547. <dd><p>Tix maintains a list of directories under which the <a class="reference internal" href="#tkinter.tix.tixCommand.tix_getimage" title="tkinter.tix.tixCommand.tix_getimage"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_getimage()</span></code></a> and
  548. <a class="reference internal" href="#tkinter.tix.tixCommand.tix_getbitmap" title="tkinter.tix.tixCommand.tix_getbitmap"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_getbitmap()</span></code></a> methods will search for image files. The standard bitmap
  549. directory is <code class="file docutils literal notranslate"><span class="pre">$TIX_LIBRARY/bitmaps</span></code>. The <a class="reference internal" href="#tkinter.tix.tixCommand.tix_addbitmapdir" title="tkinter.tix.tixCommand.tix_addbitmapdir"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_addbitmapdir()</span></code></a> method
  550. adds <em>directory</em> into this list. By using this method, the image files of an
  551. applications can also be located using the <a class="reference internal" href="#tkinter.tix.tixCommand.tix_getimage" title="tkinter.tix.tixCommand.tix_getimage"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_getimage()</span></code></a> or
  552. <a class="reference internal" href="#tkinter.tix.tixCommand.tix_getbitmap" title="tkinter.tix.tixCommand.tix_getbitmap"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_getbitmap()</span></code></a> method.</p>
  553. </dd></dl>
  554. <dl class="py method">
  555. <dt class="sig sig-object py" id="tkinter.tix.tixCommand.tix_filedialog">
  556. <span class="sig-prename descclassname"><span class="pre">tixCommand.</span></span><span class="sig-name descname"><span class="pre">tix_filedialog</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">dlgclass</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.tix.tixCommand.tix_filedialog" title="Link to this definition">¶</a></dt>
  557. <dd><p>Returns the file selection dialog that may be shared among different calls from
  558. this application. This method will create a file selection dialog widget when
  559. it is called the first time. This dialog will be returned by all subsequent
  560. calls to <a class="reference internal" href="#tkinter.tix.tixCommand.tix_filedialog" title="tkinter.tix.tixCommand.tix_filedialog"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_filedialog()</span></code></a>. An optional dlgclass parameter can be passed
  561. as a string to specified what type of file selection dialog widget is desired.
  562. Possible options are <code class="docutils literal notranslate"><span class="pre">tix</span></code>, <code class="docutils literal notranslate"><span class="pre">FileSelectDialog</span></code> or <code class="docutils literal notranslate"><span class="pre">tixExFileSelectDialog</span></code>.</p>
  563. </dd></dl>
  564. <dl class="py method">
  565. <dt class="sig sig-object py" id="tkinter.tix.tixCommand.tix_getimage">
  566. <span class="sig-prename descclassname"><span class="pre">tixCommand.</span></span><span class="sig-name descname"><span class="pre">tix_getimage</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">self</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">name</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.tix.tixCommand.tix_getimage" title="Link to this definition">¶</a></dt>
  567. <dd><p>Locates an image file of the name <code class="file docutils literal notranslate"><span class="pre">name.xpm</span></code>, <code class="file docutils literal notranslate"><span class="pre">name.xbm</span></code> or
  568. <code class="file docutils literal notranslate"><span class="pre">name.ppm</span></code> in one of the bitmap directories (see the
  569. <a class="reference internal" href="#tkinter.tix.tixCommand.tix_addbitmapdir" title="tkinter.tix.tixCommand.tix_addbitmapdir"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_addbitmapdir()</span></code></a> method above). If more than one file with the same name
  570. (but different extensions) exist, then the image type is chosen according to the
  571. depth of the X display: xbm images are chosen on monochrome displays and color
  572. images are chosen on color displays. By using <a class="reference internal" href="#tkinter.tix.tixCommand.tix_getimage" title="tkinter.tix.tixCommand.tix_getimage"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_getimage()</span></code></a>, you can
  573. avoid hard coding the pathnames of the image files in your application. When
  574. successful, this method returns the name of the newly created image, which can
  575. be used to configure the <code class="docutils literal notranslate"><span class="pre">image</span></code> option of the Tk and Tix widgets.</p>
  576. </dd></dl>
  577. <dl class="py method">
  578. <dt class="sig sig-object py" id="tkinter.tix.tixCommand.tix_option_get">
  579. <span class="sig-prename descclassname"><span class="pre">tixCommand.</span></span><span class="sig-name descname"><span class="pre">tix_option_get</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">name</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.tix.tixCommand.tix_option_get" title="Link to this definition">¶</a></dt>
  580. <dd><p>Gets the options maintained by the Tix scheme mechanism.</p>
  581. </dd></dl>
  582. <dl class="py method">
  583. <dt class="sig sig-object py" id="tkinter.tix.tixCommand.tix_resetoptions">
  584. <span class="sig-prename descclassname"><span class="pre">tixCommand.</span></span><span class="sig-name descname"><span class="pre">tix_resetoptions</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">newScheme</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">newFontSet</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">newScmPrio</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.tix.tixCommand.tix_resetoptions" title="Link to this definition">¶</a></dt>
  585. <dd><p>Resets the scheme and fontset of the Tix application to <em>newScheme</em> and
  586. <em>newFontSet</em>, respectively. This affects only those widgets created after this
  587. call. Therefore, it is best to call the resetoptions method before the creation
  588. of any widgets in a Tix application.</p>
  589. <p>The optional parameter <em>newScmPrio</em> can be given to reset the priority level of
  590. the Tk options set by the Tix schemes.</p>
  591. <p>Because of the way Tk handles the X option database, after Tix has been has
  592. imported and inited, it is not possible to reset the color schemes and font sets
  593. using the <code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_config()</span></code> method. Instead, the <a class="reference internal" href="#tkinter.tix.tixCommand.tix_resetoptions" title="tkinter.tix.tixCommand.tix_resetoptions"><code class="xref py py-meth docutils literal notranslate"><span class="pre">tix_resetoptions()</span></code></a>
  594. method must be used.</p>
  595. </dd></dl>
  596. </section>
  597. </section>
  598. <div class="clearer"></div>
  599. </div>
  600. </div>
  601. </div>
  602. <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
  603. <div class="sphinxsidebarwrapper">
  604. <div>
  605. <h3><a href="../contents.html">Table of Contents</a></h3>
  606. <ul>
  607. <li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code> — Extension widgets for Tk</a><ul>
  608. <li><a class="reference internal" href="#using-tix">Using Tix</a></li>
  609. <li><a class="reference internal" href="#tix-widgets">Tix Widgets</a><ul>
  610. <li><a class="reference internal" href="#basic-widgets">Basic Widgets</a></li>
  611. <li><a class="reference internal" href="#file-selectors">File Selectors</a></li>
  612. <li><a class="reference internal" href="#hierarchical-listbox">Hierarchical ListBox</a></li>
  613. <li><a class="reference internal" href="#tabular-listbox">Tabular ListBox</a></li>
  614. <li><a class="reference internal" href="#manager-widgets">Manager Widgets</a></li>
  615. <li><a class="reference internal" href="#image-types">Image Types</a></li>
  616. <li><a class="reference internal" href="#miscellaneous-widgets">Miscellaneous Widgets</a></li>
  617. <li><a class="reference internal" href="#form-geometry-manager">Form Geometry Manager</a></li>
  618. </ul>
  619. </li>
  620. <li><a class="reference internal" href="#tix-commands">Tix Commands</a></li>
  621. </ul>
  622. </li>
  623. </ul>
  624. </div>
  625. <div>
  626. <h4>Previous topic</h4>
  627. <p class="topless"><a href="tkinter.ttk.html"
  628. title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.ttk</span></code> — Tk themed widgets</a></p>
  629. </div>
  630. <div>
  631. <h4>Next topic</h4>
  632. <p class="topless"><a href="idle.html"
  633. title="next chapter">IDLE</a></p>
  634. </div>
  635. <div role="note" aria-label="source link">
  636. <h3>This Page</h3>
  637. <ul class="this-page-menu">
  638. <li><a href="../bugs.html">Report a Bug</a></li>
  639. <li>
  640. <a href="https://github.com/python/cpython/blob/main/Doc/library/tkinter.tix.rst"
  641. rel="nofollow">Show Source
  642. </a>
  643. </li>
  644. </ul>
  645. </div>
  646. </div>
  647. <div id="sidebarbutton" title="Collapse sidebar">
  648. <span>«</span>
  649. </div>
  650. </div>
  651. <div class="clearer"></div>
  652. </div>
  653. <div class="related" role="navigation" aria-label="related navigation">
  654. <h3>Navigation</h3>
  655. <ul>
  656. <li class="right" style="margin-right: 10px">
  657. <a href="../genindex.html" title="General Index"
  658. >index</a></li>
  659. <li class="right" >
  660. <a href="../py-modindex.html" title="Python Module Index"
  661. >modules</a> |</li>
  662. <li class="right" >
  663. <a href="idle.html" title="IDLE"
  664. >next</a> |</li>
  665. <li class="right" >
  666. <a href="tkinter.ttk.html" title="tkinter.ttk — Tk themed widgets"
  667. >previous</a> |</li>
  668. <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>
  669. <li><a href="https://www.python.org/">Python</a> &#187;</li>
  670. <li class="switchers">
  671. <div class="language_switcher_placeholder"></div>
  672. <div class="version_switcher_placeholder"></div>
  673. </li>
  674. <li>
  675. </li>
  676. <li id="cpython-language-and-version">
  677. <a href="../index.html">3.12.3 Documentation</a> &#187;
  678. </li>
  679. <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>
  680. <li class="nav-item nav-item-2"><a href="tk.html" >Graphical User Interfaces with Tk</a> &#187;</li>
  681. <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.tix</span></code> — Extension widgets for Tk</a></li>
  682. <li class="right">
  683. <div class="inline-search" role="search">
  684. <form class="inline-search" action="../search.html" method="get">
  685. <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />
  686. <input type="submit" value="Go" />
  687. </form>
  688. </div>
  689. |
  690. </li>
  691. <li class="right">
  692. <label class="theme-selector-label">
  693. Theme
  694. <select class="theme-selector" oninput="activateTheme(this.value)">
  695. <option value="auto" selected>Auto</option>
  696. <option value="light">Light</option>
  697. <option value="dark">Dark</option>
  698. </select>
  699. </label> |</li>
  700. </ul>
  701. </div>
  702. <div class="footer">
  703. &copy;
  704. <a href="../copyright.html">
  705. Copyright
  706. </a>
  707. 2001-2024, Python Software Foundation.
  708. <br />
  709. This page is licensed under the Python Software Foundation License Version 2.
  710. <br />
  711. Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.
  712. <br />
  713. See <a href="/license.html">History and License</a> for more information.<br />
  714. <br />
  715. The Python Software Foundation is a non-profit corporation.
  716. <a href="https://www.python.org/psf/donations/">Please donate.</a>
  717. <br />
  718. <br />
  719. Last updated on Apr 09, 2024 (13:47 UTC).
  720. <a href="/bugs.html">Found a bug</a>?
  721. <br />
  722. Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.2.6.
  723. </div>
  724. </body>
  725. </html>
上海开阖软件有限公司 沪ICP备12045867号-1