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.
 
 
 
 
 

544 lines
73 KiB

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>TermTk.TTkWidgets.container &mdash; pyTermTk 0.36.0-a
documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/theme_overrides.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/ttk.css" type="text/css" />
<link rel="shortcut icon" href="https://ceccopierangiolieugenio.github.io/pyTermTk/sandbox/www/favicon.ico"/>
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script data-url_root="../../../" id="documentation_options" src="../../../_static/documentation_options.js"></script>
<script src="../../../_static/jquery.js"></script>
<script src="../../../_static/underscore.js"></script>
<script src="../../../_static/_sphinx_javascript_frameworks_compat.js"></script>
<script src="../../../_static/doctools.js"></script>
<script src="../../../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../../../genindex.html" />
<link rel="search" title="Search" href="../../../search.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../../../index.html" class="icon icon-home"> pyTermTk
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">Tutorials</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/000-examples.html">pyTermTk - &lt; <strong>the Examples</strong> &gt;</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/001-helloworld.html">pyTermTk - Hello World</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/002-layout.html">pyTermTk - Layouts</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/003-signalslots.html">pyTermTk - Signal &amp; Slots</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/004-logging.html">pyTermTk - Logging</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/005-calculator.html">pyTermTk - Your first Calculator</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../tutorial/ttkDesigner/textEdit/README.html">ttkDesigner - Your first TextEditor</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Stuff</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../info/features/index.html">Features</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../info/features/crosscompatible.html">Cross Compatibility</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../info/installing.html">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../info/installing.html#quickstart">Quickstart</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../info/debug.html">Debug</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">API Reference</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkAbstract.html">TermTk.TTkAbstract</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkCore.html">TermTk.TTkCore</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkCore.TTkTerm.html">TermTk.TTkCore.TTkTerm</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkGui.html">TermTk.TTkGui</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkLayouts.html">TermTk.TTkLayouts</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkTemplates.html">TermTk.TTkTemplates</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkTestWidgets.html">TermTk.TTkTestWidgets</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkTheme.html">TermTk.TTkTheme</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkTypes.html">TermTk.TTkTypes</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkUiTools.html">TermTk.TTkUiTools</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkWidgets.html">TermTk.TTkWidgets</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkWidgets.TTkModelView.html">TermTk.TTkWidgets.TTkModelView</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../autogen.TermTk/TermTk.TTkWidgets.TTkPickers.html">TermTk.TTkWidgets.TTkPickers</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../../index.html">pyTermTk</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../../index.html" class="icon icon-home"></a> &raquo;</li>
<li><a href="../../index.html">Module code</a> &raquo;</li>
<li>TermTk.TTkWidgets.container</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<h1>Source code for TermTk.TTkWidgets.container</h1><div class="highlight"><pre>
<span></span><span class="c1"># MIT License</span>
<span class="c1">#</span>
<span class="c1"># Copyright (c) 2023 Eugenio Parodi &lt;ceccopierangiolieugenio AT googlemail DOT com&gt;</span>
<span class="c1">#</span>
<span class="c1"># Permission is hereby granted, free of charge, to any person obtaining a copy</span>
<span class="c1"># of this software and associated documentation files (the &quot;Software&quot;), to deal</span>
<span class="c1"># in the Software without restriction, including without limitation the rights</span>
<span class="c1"># to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
<span class="c1"># copies of the Software, and to permit persons to whom the Software is</span>
<span class="c1"># furnished to do so, subject to the following conditions:</span>
<span class="c1">#</span>
<span class="c1"># The above copyright notice and this permission notice shall be included in all</span>
<span class="c1"># copies or substantial portions of the Software.</span>
<span class="c1">#</span>
<span class="c1"># THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
<span class="c1"># IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
<span class="c1"># FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
<span class="c1"># AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
<span class="c1"># LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
<span class="c1"># OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE</span>
<span class="c1"># SOFTWARE.</span>
<span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span><span class="s1">&#39;TTkContainer&#39;</span><span class="p">]</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.constant</span> <span class="kn">import</span> <span class="n">TTkK</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.log</span> <span class="kn">import</span> <span class="n">TTkLog</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.helper</span> <span class="kn">import</span> <span class="n">TTkHelper</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkCore.signal</span> <span class="kn">import</span> <span class="n">pyTTkSignal</span><span class="p">,</span> <span class="n">pyTTkSlot</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkLayouts.layout</span> <span class="kn">import</span> <span class="n">TTkLayout</span>
<span class="kn">from</span> <span class="nn">TermTk.TTkWidgets.widget</span> <span class="kn">import</span> <span class="n">TTkWidget</span>
<div class="viewcode-block" id="TTkContainer"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer">[docs]</a><span class="k">class</span> <span class="nc">TTkContainer</span><span class="p">(</span><span class="n">TTkWidget</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39; TTkContainer Layout sizes:</span>
<span class="sd"> ::</span>
<span class="sd"> Terminal area (i.e. XTerm) = TTk</span>
<span class="sd"> ┌─────────────────────────────────────────┐</span>
<span class="sd"> │ │</span>
<span class="sd"> │ TTkContainer width │</span>
<span class="sd"> │ (x,y)┌─────────────────────────┐ │</span>
<span class="sd"> │ │ padt (Top Padding) │ │</span>
<span class="sd"> │ │ ┌───────────────┐ │ height │</span>
<span class="sd"> │ │padl│ Layout/child │padr│ │</span>
<span class="sd"> │ │ └───────────────┘ │ │</span>
<span class="sd"> │ │ padb (Bottom Pad.) │ │</span>
<span class="sd"> │ └─────────────────────────┘ │</span>
<span class="sd"> └─────────────────────────────────────────┘</span>
<span class="sd"> :param bool forwardStyle: any change of style will reflect the children, defaults to False</span>
<span class="sd"> :type forwardStyle: bool</span>
<span class="sd"> :param int padding: the padding (top, bottom, left, right) of the widget, defaults to 0</span>
<span class="sd"> :param int paddingTop: the Top padding, override Top padding if already defined, optional, default=padding</span>
<span class="sd"> :param int paddingBottom: the Bottom padding, override Bottom padding if already defined, optional, default=padding</span>
<span class="sd"> :param int paddingLeft: the Left padding, override Left padding if already defined, optional, default=padding</span>
<span class="sd"> :param int paddingRight: the Right padding, override Right padding if already defined, optional, default=padding</span>
<span class="sd"> :param layout: the layout of this widget, optional, defaults to :class:`~TermTk.TTkLayouts.layout.TTkLayout`</span>
<span class="sd"> :type layout: :mod:`TermTk.TTkLayouts`</span>
<span class="sd"> &#39;&#39;&#39;</span>
<span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span>
<span class="s1">&#39;_padt&#39;</span><span class="p">,</span> <span class="s1">&#39;_padb&#39;</span><span class="p">,</span> <span class="s1">&#39;_padl&#39;</span><span class="p">,</span> <span class="s1">&#39;_padr&#39;</span><span class="p">,</span>
<span class="s1">&#39;_forwardStyle&#39;</span><span class="p">,</span>
<span class="s1">&#39;_layout&#39;</span><span class="p">)</span>
<span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">padding</span><span class="o">=</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">),</span> <span class="n">forwardStyle</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span><span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_forwardStyle</span> <span class="o">=</span> <span class="n">forwardStyle</span>
<span class="n">padding</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;padding&#39;</span><span class="p">,</span> <span class="mi">0</span> <span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_padt</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;paddingTop&#39;</span><span class="p">,</span> <span class="n">padding</span> <span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_padb</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;paddingBottom&#39;</span><span class="p">,</span> <span class="n">padding</span> <span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_padl</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;paddingLeft&#39;</span><span class="p">,</span> <span class="n">padding</span> <span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_padr</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;paddingRight&#39;</span><span class="p">,</span> <span class="n">padding</span> <span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_layout</span> <span class="o">=</span> <span class="n">TTkLayout</span><span class="p">()</span> <span class="c1"># root layout</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_layout</span><span class="o">.</span><span class="n">addItem</span><span class="p">(</span><span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;layout&#39;</span><span class="p">,</span><span class="n">TTkLayout</span><span class="p">()))</span> <span class="c1"># main layout</span>
<span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_layout</span><span class="o">.</span><span class="n">setParent</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
<div class="viewcode-block" id="TTkContainer.addWidget"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer.addWidget">[docs]</a> <span class="k">def</span> <span class="nf">addWidget</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">widget</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39;</span>
<span class="sd"> .. warning::</span>
<span class="sd"> Method Deprecated,</span>
<span class="sd"> use :class:`TTkWidget` -&gt; :class:`~TermTk.TTkWidgets.widget.TTkWidget.layout` -&gt; :class:`~TermTk.TTkLayouts.layout.TTkLayout.addWidget`</span>
<span class="sd"> i.e.</span>
<span class="sd"> .. code:: python</span>
<span class="sd"> parentWidget.layout().addWidget(childWidget)</span>
<span class="sd"> &#39;&#39;&#39;</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s2">&quot;&lt;TTkWidget&gt;.addWidget(...) is deprecated, use &lt;TTkWidget&gt;.layout().addWidget(...)&quot;</span><span class="p">)</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">():</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span><span class="o">.</span><span class="n">addWidget</span><span class="p">(</span><span class="n">widget</span><span class="p">)</span></div>
<div class="viewcode-block" id="TTkContainer.removeWidget"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer.removeWidget">[docs]</a> <span class="k">def</span> <span class="nf">removeWidget</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">widget</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39;</span>
<span class="sd"> .. warning::</span>
<span class="sd"> Method Deprecated,</span>
<span class="sd"> use :class:`TTkWidget` -&gt; :class:`~TermTk.TTkWidgets.widget.TTkWidget.layout` -&gt; :class:`~TermTk.TTkLayouts.layout.TTkLayout.removeWidget`</span>
<span class="sd"> i.e.</span>
<span class="sd"> .. code:: python</span>
<span class="sd"> parentWidget.layout().removeWidget(childWidget)</span>
<span class="sd"> &#39;&#39;&#39;</span>
<span class="n">TTkLog</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s2">&quot;&lt;TTkWidget&gt;.removeWidget(...) is deprecated, use &lt;TTkWidget&gt;.layout().removeWidget(...)&quot;</span><span class="p">)</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">():</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span><span class="o">.</span><span class="n">removeWidget</span><span class="p">(</span><span class="n">widget</span><span class="p">)</span></div>
<span class="c1"># def forwardStyleTo(self, widget:TTkWidget):</span>
<span class="c1"># widget._currentStyle |= self._currentStyle</span>
<span class="c1"># widget.update()</span>
<span class="k">def</span> <span class="nf">_processForwardStyle</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_forwardStyle</span><span class="p">:</span> <span class="k">return</span>
<span class="k">def</span> <span class="nf">_getChildren</span><span class="p">():</span>
<span class="k">for</span> <span class="n">w</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()</span><span class="o">.</span><span class="n">iterWidgets</span><span class="p">(</span><span class="n">onlyVisible</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">recurse</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
<span class="k">yield</span> <span class="n">w</span>
<span class="k">for</span> <span class="n">w</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span><span class="o">.</span><span class="n">iterWidgets</span><span class="p">(</span><span class="n">onlyVisible</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">recurse</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
<span class="k">yield</span> <span class="n">w</span>
<span class="k">for</span> <span class="n">w</span> <span class="ow">in</span> <span class="n">_getChildren</span><span class="p">():</span>
<span class="bp">self</span><span class="o">.</span><span class="n">setCurrentStyle</span><span class="p">(</span><span class="n">w</span><span class="o">.</span><span class="n">_currentStyle</span> <span class="o">|</span> <span class="bp">self</span><span class="o">.</span><span class="n">_currentStyle</span><span class="p">)</span>
<span class="k">if</span> <span class="nb">issubclass</span><span class="p">(</span><span class="nb">type</span><span class="p">(</span><span class="n">w</span><span class="p">),</span><span class="n">TTkContainer</span><span class="p">):</span>
<span class="n">w</span><span class="o">.</span><span class="n">_processForwardStyle</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">setCurrentStyle</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
<span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">setCurrentStyle</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_processForwardStyle</span><span class="p">()</span>
<span class="nd">@staticmethod</span>
<span class="k">def</span> <span class="nf">_paintChildCanvas</span><span class="p">(</span><span class="n">canvas</span><span class="p">,</span> <span class="n">item</span><span class="p">,</span> <span class="n">geometry</span><span class="p">,</span> <span class="n">offset</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39; .. caution:: Don&#39;t touch this! &#39;&#39;&#39;</span>
<span class="n">lx</span><span class="p">,</span><span class="n">ly</span><span class="p">,</span><span class="n">lw</span><span class="p">,</span><span class="n">lh</span> <span class="o">=</span> <span class="n">geometry</span>
<span class="n">ox</span><span class="p">,</span> <span class="n">oy</span> <span class="o">=</span> <span class="n">offset</span>
<span class="k">if</span> <span class="n">item</span><span class="o">.</span><span class="n">layoutItemType</span><span class="p">()</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">WidgetItem</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">item</span><span class="o">.</span><span class="n">isEmpty</span><span class="p">():</span>
<span class="n">child</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">widget</span><span class="p">()</span>
<span class="n">cx</span><span class="p">,</span><span class="n">cy</span><span class="p">,</span><span class="n">cw</span><span class="p">,</span><span class="n">ch</span> <span class="o">=</span> <span class="n">child</span><span class="o">.</span><span class="n">geometry</span><span class="p">()</span>
<span class="n">canvas</span><span class="o">.</span><span class="n">paintCanvas</span><span class="p">(</span>
<span class="n">child</span><span class="o">.</span><span class="n">getCanvas</span><span class="p">(),</span>
<span class="p">(</span><span class="n">cx</span><span class="o">+</span><span class="n">ox</span><span class="p">,</span> <span class="n">cy</span><span class="o">+</span><span class="n">oy</span><span class="p">,</span> <span class="n">cw</span><span class="p">,</span> <span class="n">ch</span><span class="p">),</span> <span class="c1"># geometry</span>
<span class="p">(</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">cw</span><span class="p">,</span> <span class="n">ch</span><span class="p">),</span> <span class="c1"># slice</span>
<span class="p">(</span> <span class="n">lx</span><span class="p">,</span> <span class="n">ly</span><span class="p">,</span> <span class="n">lw</span><span class="p">,</span> <span class="n">lh</span><span class="p">))</span> <span class="c1"># bound</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">for</span> <span class="n">child</span> <span class="ow">in</span> <span class="n">item</span><span class="o">.</span><span class="n">zSortedItems</span><span class="p">:</span>
<span class="c1"># The Parent Layout Geometry (lx,ly,lw,lh) include the padding of the layout</span>
<span class="n">igx</span><span class="p">,</span> <span class="n">igy</span><span class="p">,</span> <span class="n">igw</span><span class="p">,</span> <span class="n">igh</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">geometry</span><span class="p">()</span>
<span class="n">iox</span><span class="p">,</span> <span class="n">ioy</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">offset</span><span class="p">()</span>
<span class="c1"># Moved Layout to the new geometry (ix,iy,iw,ih)</span>
<span class="n">ix</span> <span class="o">=</span> <span class="n">igx</span><span class="o">+</span><span class="n">ox</span> <span class="c1"># + iox</span>
<span class="n">iy</span> <span class="o">=</span> <span class="n">igy</span><span class="o">+</span><span class="n">oy</span> <span class="c1"># + ioy</span>
<span class="n">iw</span> <span class="o">=</span> <span class="n">igw</span> <span class="c1"># -iox</span>
<span class="n">ih</span> <span class="o">=</span> <span class="n">igh</span> <span class="c1"># -ioy</span>
<span class="c1"># return if Child outside the bound</span>
<span class="k">if</span> <span class="n">ix</span><span class="o">+</span><span class="n">iw</span> <span class="o">&lt;</span> <span class="n">lx</span> <span class="ow">and</span> <span class="n">ix</span> <span class="o">&gt;</span> <span class="n">lx</span><span class="o">+</span><span class="n">lw</span> <span class="ow">and</span> <span class="n">iy</span><span class="o">+</span><span class="n">ih</span> <span class="o">&lt;</span> <span class="n">ly</span> <span class="ow">and</span> <span class="n">iy</span> <span class="o">&gt;</span> <span class="n">ly</span><span class="o">+</span><span class="n">lh</span><span class="p">:</span> <span class="k">continue</span>
<span class="c1"># Crop the Layout based on the Parent Layout Geometry</span>
<span class="n">bx</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span><span class="n">ix</span><span class="p">,</span><span class="n">lx</span><span class="p">)</span>
<span class="n">by</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span><span class="n">iy</span><span class="p">,</span><span class="n">ly</span><span class="p">)</span>
<span class="n">bw</span> <span class="o">=</span> <span class="nb">min</span><span class="p">(</span><span class="n">ix</span><span class="o">+</span><span class="n">iw</span><span class="p">,</span><span class="n">lx</span><span class="o">+</span><span class="n">lw</span><span class="p">)</span><span class="o">-</span><span class="n">bx</span>
<span class="n">bh</span> <span class="o">=</span> <span class="nb">min</span><span class="p">(</span><span class="n">iy</span><span class="o">+</span><span class="n">ih</span><span class="p">,</span><span class="n">ly</span><span class="o">+</span><span class="n">lh</span><span class="p">)</span><span class="o">-</span><span class="n">by</span>
<span class="n">TTkContainer</span><span class="o">.</span><span class="n">_paintChildCanvas</span><span class="p">(</span><span class="n">canvas</span><span class="p">,</span> <span class="n">child</span><span class="p">,</span> <span class="p">(</span><span class="n">bx</span><span class="p">,</span><span class="n">by</span><span class="p">,</span><span class="n">bw</span><span class="p">,</span><span class="n">bh</span><span class="p">),</span> <span class="p">(</span><span class="n">ix</span><span class="o">+</span><span class="n">iox</span><span class="p">,</span><span class="n">iy</span><span class="o">+</span><span class="n">ioy</span><span class="p">))</span>
<div class="viewcode-block" id="TTkContainer.paintChildCanvas"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer.paintChildCanvas">[docs]</a> <span class="k">def</span> <span class="nf">paintChildCanvas</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39; .. caution:: Don&#39;t touch this! &#39;&#39;&#39;</span>
<span class="n">TTkContainer</span><span class="o">.</span><span class="n">_paintChildCanvas</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_canvas</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">(),</span> <span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()</span><span class="o">.</span><span class="n">geometry</span><span class="p">(),</span> <span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()</span><span class="o">.</span><span class="n">offset</span><span class="p">())</span></div>
<div class="viewcode-block" id="TTkContainer.getPadding"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer.getPadding">[docs]</a> <span class="k">def</span> <span class="nf">getPadding</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="p">(</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39; Retrieve the widget padding sizes</span>
<span class="sd"> :return: list[top, bottom, left, right]: the 4 padding sizes</span>
<span class="sd"> &#39;&#39;&#39;</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padt</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padb</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padl</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padr</span></div>
<div class="viewcode-block" id="TTkContainer.setPadding"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer.setPadding">[docs]</a> <span class="k">def</span> <span class="nf">setPadding</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">top</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">bottom</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">left</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">right</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39; Set the padding of the widget</span>
<span class="sd"> :param int top: top padding</span>
<span class="sd"> :param int bottom: bottom padding</span>
<span class="sd"> :param int left: left padding</span>
<span class="sd"> :param int right: right padding</span>
<span class="sd"> &#39;&#39;&#39;</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padt</span> <span class="o">==</span> <span class="n">top</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padb</span> <span class="o">==</span> <span class="n">bottom</span> <span class="ow">and</span> \
<span class="bp">self</span><span class="o">.</span><span class="n">_padl</span> <span class="o">==</span> <span class="n">left</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padr</span> <span class="o">==</span> <span class="n">right</span><span class="p">:</span> <span class="k">return</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_padt</span> <span class="o">=</span> <span class="n">top</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_padb</span> <span class="o">=</span> <span class="n">bottom</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_padl</span> <span class="o">=</span> <span class="n">left</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_padr</span> <span class="o">=</span> <span class="n">right</span>
<span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">repaint</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">updateLayout</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></div>
<span class="nd">@staticmethod</span>
<span class="k">def</span> <span class="nf">_mouseEventLayoutHandle</span><span class="p">(</span><span class="n">evt</span><span class="p">,</span> <span class="n">layout</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39; .. caution:: Don&#39;t touch this! &#39;&#39;&#39;</span>
<span class="n">x</span><span class="p">,</span> <span class="n">y</span> <span class="o">=</span> <span class="n">evt</span><span class="o">.</span><span class="n">x</span><span class="p">,</span> <span class="n">evt</span><span class="o">.</span><span class="n">y</span>
<span class="n">lx</span><span class="p">,</span><span class="n">ly</span><span class="p">,</span><span class="n">lw</span><span class="p">,</span><span class="n">lh</span> <span class="o">=</span><span class="n">layout</span><span class="o">.</span><span class="n">geometry</span><span class="p">()</span>
<span class="n">lox</span><span class="p">,</span> <span class="n">loy</span> <span class="o">=</span> <span class="n">layout</span><span class="o">.</span><span class="n">offset</span><span class="p">()</span>
<span class="n">lx</span><span class="p">,</span><span class="n">ly</span><span class="p">,</span><span class="n">lw</span><span class="p">,</span><span class="n">lh</span> <span class="o">=</span> <span class="n">lx</span><span class="o">+</span><span class="n">lox</span><span class="p">,</span> <span class="n">ly</span><span class="o">+</span><span class="n">loy</span><span class="p">,</span> <span class="n">lw</span><span class="o">-</span><span class="n">lox</span><span class="p">,</span> <span class="n">lh</span><span class="o">-</span><span class="n">loy</span>
<span class="c1"># opt of bounds</span>
<span class="k">if</span> <span class="n">x</span><span class="o">&lt;</span><span class="n">lx</span> <span class="ow">or</span> <span class="n">x</span><span class="o">&gt;=</span><span class="n">lx</span><span class="o">+</span><span class="n">lw</span> <span class="ow">or</span> <span class="n">y</span><span class="o">&lt;</span><span class="n">ly</span> <span class="ow">or</span> <span class="n">y</span><span class="o">&gt;=</span><span class="n">lh</span><span class="o">+</span><span class="n">ly</span><span class="p">:</span>
<span class="k">return</span> <span class="kc">False</span>
<span class="n">x</span><span class="o">-=</span><span class="n">lx</span>
<span class="n">y</span><span class="o">-=</span><span class="n">ly</span>
<span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="nb">reversed</span><span class="p">(</span><span class="n">layout</span><span class="o">.</span><span class="n">zSortedItems</span><span class="p">):</span>
<span class="c1"># for item in layout.zSortedItems:</span>
<span class="k">if</span> <span class="n">item</span><span class="o">.</span><span class="n">layoutItemType</span><span class="p">()</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">WidgetItem</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">item</span><span class="o">.</span><span class="n">isEmpty</span><span class="p">():</span>
<span class="n">widget</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">widget</span><span class="p">()</span>
<span class="k">if</span> <span class="ow">not</span> <span class="n">widget</span><span class="o">.</span><span class="n">_visible</span><span class="p">:</span> <span class="k">continue</span>
<span class="n">wx</span><span class="p">,</span><span class="n">wy</span><span class="p">,</span><span class="n">ww</span><span class="p">,</span><span class="n">wh</span> <span class="o">=</span> <span class="n">widget</span><span class="o">.</span><span class="n">geometry</span><span class="p">()</span>
<span class="c1"># Skip the mouse event if outside this widget</span>
<span class="k">if</span> <span class="ow">not</span> <span class="p">(</span><span class="n">wx</span> <span class="o">&lt;=</span> <span class="n">x</span> <span class="o">&lt;</span> <span class="n">wx</span><span class="o">+</span><span class="n">ww</span> <span class="ow">and</span> <span class="n">wy</span> <span class="o">&lt;=</span> <span class="n">y</span> <span class="o">&lt;</span> <span class="n">wy</span><span class="o">+</span><span class="n">wh</span><span class="p">):</span> <span class="k">continue</span>
<span class="n">wevt</span> <span class="o">=</span> <span class="n">evt</span><span class="o">.</span><span class="n">clone</span><span class="p">(</span><span class="n">pos</span><span class="o">=</span><span class="p">(</span><span class="n">x</span><span class="o">-</span><span class="n">wx</span><span class="p">,</span> <span class="n">y</span><span class="o">-</span><span class="n">wy</span><span class="p">))</span>
<span class="k">if</span> <span class="n">widget</span><span class="o">.</span><span class="n">mouseEvent</span><span class="p">(</span><span class="n">wevt</span><span class="p">):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">elif</span> <span class="n">item</span><span class="o">.</span><span class="n">layoutItemType</span><span class="p">()</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">LayoutItem</span><span class="p">:</span>
<span class="n">levt</span> <span class="o">=</span> <span class="n">evt</span><span class="o">.</span><span class="n">clone</span><span class="p">(</span><span class="n">pos</span><span class="o">=</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="p">))</span>
<span class="k">if</span> <span class="n">TTkContainer</span><span class="o">.</span><span class="n">_mouseEventLayoutHandle</span><span class="p">(</span><span class="n">levt</span><span class="p">,</span> <span class="n">item</span><span class="p">):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">return</span> <span class="kc">False</span>
<span class="n">_mouseOver</span> <span class="o">=</span> <span class="kc">None</span>
<span class="n">_mouseOverTmp</span> <span class="o">=</span> <span class="kc">None</span>
<span class="n">_mouseOverProcessed</span> <span class="o">=</span> <span class="kc">False</span>
<div class="viewcode-block" id="TTkContainer.mouseEvent"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer.mouseEvent">[docs]</a> <span class="k">def</span> <span class="nf">mouseEvent</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">evt</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39; .. caution:: Don&#39;t touch this! &#39;&#39;&#39;</span>
<span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_enabled</span><span class="p">:</span> <span class="k">return</span> <span class="kc">False</span>
<span class="c1"># Saving self in this global variable</span>
<span class="c1"># So that after the &quot;_mouseEventLayoutHandle&quot;</span>
<span class="c1"># this tmp value will hold the last widget below the mouse</span>
<span class="n">TTkWidget</span><span class="o">.</span><span class="n">_mouseOverTmp</span> <span class="o">=</span> <span class="bp">self</span>
<span class="c1"># Mouse Drag has priority because it</span>
<span class="c1"># should be handled by the focused widget and</span>
<span class="c1"># not pushed to the unfocused childs</span>
<span class="c1"># unless there is a Drag and Drop event ongoing</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">evt</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Drag</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">isDnD</span><span class="p">():</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">mouseDragEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
<span class="k">if</span> <span class="n">TTkContainer</span><span class="o">.</span><span class="n">_mouseEventLayoutHandle</span><span class="p">(</span><span class="n">evt</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="c1"># If there is an overlay and it is modal,</span>
<span class="c1"># return False if this widget is not part of any</span>
<span class="c1"># of the widgets above the modal</span>
<span class="k">if</span> <span class="ow">not</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">checkModalOverlay</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">return</span> <span class="kc">False</span>
<span class="c1"># Handle Drag and Drop Events</span>
<span class="k">if</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">isDnD</span><span class="p">():</span>
<span class="n">ret</span> <span class="o">=</span> <span class="kc">False</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">evt</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Drag</span><span class="p">:</span>
<span class="n">dndw</span> <span class="o">=</span> <span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndWidget</span><span class="p">()</span>
<span class="k">if</span> <span class="n">dndw</span> <span class="o">==</span> <span class="bp">self</span><span class="p">:</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">dragMoveEvent</span><span class="p">(</span><span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndGetDrag</span><span class="p">()</span><span class="o">.</span><span class="n">getDragMoveEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">)):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">dragEnterEvent</span><span class="p">(</span><span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndGetDrag</span><span class="p">()</span><span class="o">.</span><span class="n">getDragEnterEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">)):</span>
<span class="k">if</span> <span class="n">dndw</span><span class="p">:</span>
<span class="n">ret</span> <span class="o">=</span> <span class="n">dndw</span><span class="o">.</span><span class="n">dragLeaveEvent</span><span class="p">(</span><span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndGetDrag</span><span class="p">()</span><span class="o">.</span><span class="n">getDragLeaveEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">))</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndEnter</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">evt</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Release</span><span class="p">:</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">dropEvent</span><span class="p">(</span><span class="n">TTkHelper</span><span class="o">.</span><span class="n">dndGetDrag</span><span class="p">()</span><span class="o">.</span><span class="n">getDropEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">)):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">return</span> <span class="n">ret</span>
<span class="c1"># handle Enter/Leave Events</span>
<span class="c1"># _mouseOverTmp hold the top widget under the mouse</span>
<span class="c1"># if different than self it means that it is a child</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">evt</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Move</span><span class="p">:</span>
<span class="k">if</span> <span class="ow">not</span> <span class="n">TTkWidget</span><span class="o">.</span><span class="n">_mouseOverProcessed</span><span class="p">:</span>
<span class="k">if</span> <span class="n">TTkWidget</span><span class="o">.</span><span class="n">_mouseOver</span> <span class="o">!=</span> <span class="n">TTkWidget</span><span class="o">.</span><span class="n">_mouseOverTmp</span> <span class="o">==</span> <span class="bp">self</span><span class="p">:</span>
<span class="k">if</span> <span class="n">TTkWidget</span><span class="o">.</span><span class="n">_mouseOver</span><span class="p">:</span>
<span class="c1"># TTkLog.debug(f&quot;Leave: {TTkWidget._mouseOver._name}&quot;)</span>
<span class="n">TTkWidget</span><span class="o">.</span><span class="n">_mouseOver</span><span class="o">.</span><span class="n">leaveEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">)</span>
<span class="n">TTkWidget</span><span class="o">.</span><span class="n">_mouseOver</span> <span class="o">=</span> <span class="bp">self</span>
<span class="c1"># TTkLog.debug(f&quot;Enter: {TTkWidget._mouseOver._name}&quot;)</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">toolTipClose</span><span class="p">()</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_toolTip</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_toolTip</span> <span class="o">!=</span> <span class="s1">&#39;&#39;</span><span class="p">:</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">toolTipTrigger</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_toolTip</span><span class="p">)</span>
<span class="c1"># TTkHelper.triggerToolTip(self._name)</span>
<span class="n">TTkWidget</span><span class="o">.</span><span class="n">_mouseOver</span><span class="o">.</span><span class="n">enterEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">)</span>
<span class="n">TTkWidget</span><span class="o">.</span><span class="n">_mouseOverProcessed</span> <span class="o">=</span> <span class="kc">True</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">mouseMoveEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">else</span><span class="p">:</span>
<span class="n">TTkHelper</span><span class="o">.</span><span class="n">toolTipClose</span><span class="p">()</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">evt</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Release</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_pendingMouseRelease</span> <span class="o">=</span> <span class="kc">False</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_processStyleEvent</span><span class="p">(</span><span class="n">TTkWidget</span><span class="o">.</span><span class="n">_S_NONE</span><span class="p">)</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">mouseReleaseEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">evt</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Press</span><span class="p">:</span>
<span class="c1"># in case of parent focus, check the parent that can accept the focus</span>
<span class="n">w</span> <span class="o">=</span> <span class="bp">self</span>
<span class="k">while</span> <span class="n">w</span><span class="o">.</span><span class="n">_parent</span> <span class="ow">and</span> <span class="p">(</span><span class="n">w</span><span class="o">.</span><span class="n">focusPolicy</span><span class="p">()</span> <span class="o">&amp;</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">ParentFocus</span><span class="p">)</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">ParentFocus</span><span class="p">:</span>
<span class="n">w</span> <span class="o">=</span> <span class="n">w</span><span class="o">.</span><span class="n">_parent</span>
<span class="k">if</span> <span class="n">w</span><span class="o">.</span><span class="n">focusPolicy</span><span class="p">()</span> <span class="o">&amp;</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">ClickFocus</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">ClickFocus</span><span class="p">:</span>
<span class="n">w</span><span class="o">.</span><span class="n">setFocus</span><span class="p">()</span>
<span class="n">w</span><span class="o">.</span><span class="n">raiseWidget</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_processStyleEvent</span><span class="p">(</span><span class="n">TTkWidget</span><span class="o">.</span><span class="n">_S_PRESSED</span><span class="p">)</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">tap</span> <span class="o">==</span> <span class="mi">2</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">mouseDoubleClickEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">):</span>
<span class="c1">#self._pendingMouseRelease = True</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">tap</span> <span class="o">&gt;</span> <span class="mi">1</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">mouseTapEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">tap</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">mousePressEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">):</span>
<span class="c1"># TTkLog.debug(f&quot;Click {self._name}&quot;)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_pendingMouseRelease</span> <span class="o">=</span> <span class="kc">True</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">if</span> <span class="n">evt</span><span class="o">.</span><span class="n">key</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">Wheel</span><span class="p">:</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">wheelEvent</span><span class="p">(</span><span class="n">evt</span><span class="p">):</span>
<span class="k">return</span> <span class="kc">True</span>
<span class="k">return</span> <span class="kc">False</span></div>
<span class="k">def</span> <span class="nf">setLayout</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">layout</span><span class="p">):</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_layout</span><span class="o">.</span><span class="n">replaceItem</span><span class="p">(</span><span class="n">layout</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
<span class="c1">#self.layout().setParent(self)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">repaint</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">updateLayout</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
<div class="viewcode-block" id="TTkContainer.layout"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer.layout">[docs]</a> <span class="k">def</span> <span class="nf">layout</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39; Get the layout</span>
<span class="sd"> :return: The layout used</span>
<span class="sd"> :rtype: :class:`TTkLayout` or derived</span>
<span class="sd"> &#39;&#39;&#39;</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_layout</span><span class="o">.</span><span class="n">itemAt</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span></div>
<span class="k">def</span> <span class="nf">rootLayout</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span> <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_layout</span>
<span class="k">def</span> <span class="nf">maximumHeight</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="n">wMaxH</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_maxh</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
<span class="n">lMaxH</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span><span class="o">.</span><span class="n">maximumHeight</span><span class="p">()</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padt</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padb</span>
<span class="k">if</span> <span class="n">lMaxH</span> <span class="o">&lt;</span> <span class="n">wMaxH</span><span class="p">:</span>
<span class="k">return</span> <span class="n">lMaxH</span>
<span class="k">return</span> <span class="n">wMaxH</span>
<span class="k">def</span> <span class="nf">maximumWidth</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="n">wMaxW</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_maxw</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
<span class="n">lMaxW</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span><span class="o">.</span><span class="n">maximumWidth</span><span class="p">()</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padl</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padr</span>
<span class="k">if</span> <span class="n">lMaxW</span> <span class="o">&lt;</span> <span class="n">wMaxW</span><span class="p">:</span>
<span class="k">return</span> <span class="n">lMaxW</span>
<span class="k">return</span> <span class="n">wMaxW</span>
<span class="k">def</span> <span class="nf">minimumSize</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">minimumWidth</span><span class="p">(),</span> <span class="bp">self</span><span class="o">.</span><span class="n">minimumHeight</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">minDimension</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">orientation</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
<span class="k">if</span> <span class="n">orientation</span> <span class="o">==</span> <span class="n">TTkK</span><span class="o">.</span><span class="n">HORIZONTAL</span><span class="p">:</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">minimumWidth</span><span class="p">()</span>
<span class="k">else</span><span class="p">:</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">minimumHeight</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">minimumHeight</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="n">wMinH</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_minh</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
<span class="n">lMinH</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span><span class="o">.</span><span class="n">minimumHeight</span><span class="p">()</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padt</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padb</span>
<span class="k">if</span> <span class="n">lMinH</span> <span class="o">&gt;</span> <span class="n">wMinH</span><span class="p">:</span>
<span class="k">return</span> <span class="n">lMinH</span>
<span class="k">return</span> <span class="n">wMinH</span>
<span class="k">def</span> <span class="nf">minimumWidth</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="n">wMinW</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_minw</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
<span class="n">lMinW</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span><span class="o">.</span><span class="n">minimumWidth</span><span class="p">()</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padl</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padr</span>
<span class="k">if</span> <span class="n">lMinW</span> <span class="o">&gt;</span> <span class="n">wMinW</span><span class="p">:</span>
<span class="k">return</span> <span class="n">lMinW</span>
<span class="k">return</span> <span class="n">wMinW</span>
<div class="viewcode-block" id="TTkContainer.show"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer.show">[docs]</a> <span class="nd">@pyTTkSlot</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">show</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39;show&#39;&#39;&#39;</span>
<span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_visible</span><span class="p">:</span> <span class="k">return</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_visible</span> <span class="o">=</span> <span class="kc">True</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_canvas</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">updateLayout</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">updateParent</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
<span class="k">for</span> <span class="n">w</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()</span><span class="o">.</span><span class="n">iterWidgets</span><span class="p">(</span><span class="n">onlyVisible</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
<span class="n">w</span><span class="o">.</span><span class="n">update</span><span class="p">()</span></div>
<div class="viewcode-block" id="TTkContainer.hide"><a class="viewcode-back" href="../../../autogen.TermTk/TermTk.TTkWidgets.container.html#TermTk.TTkWidgets.container.TTkContainer.hide">[docs]</a> <span class="nd">@pyTTkSlot</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">hide</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="sd">&#39;&#39;&#39;hide&#39;&#39;&#39;</span>
<span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_visible</span><span class="p">:</span> <span class="k">return</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_visible</span> <span class="o">=</span> <span class="kc">False</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_canvas</span><span class="o">.</span><span class="n">hide</span><span class="p">()</span>
<span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">repaint</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">updateParent</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span></div>
<span class="k">def</span> <span class="nf">update</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">repaint</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">updateLayout</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">updateParent</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span><span class="kc">False</span><span class="p">):</span>
<span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">repaint</span><span class="o">=</span><span class="n">repaint</span><span class="p">,</span> <span class="n">updateLayout</span><span class="o">=</span><span class="n">updateLayout</span><span class="p">,</span> <span class="n">updateParent</span><span class="o">=</span><span class="n">updateParent</span><span class="p">)</span>
<span class="k">if</span> <span class="n">updateLayout</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
<span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()</span><span class="o">.</span><span class="n">setGeometry</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">0</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">_width</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">_height</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">layout</span><span class="p">()</span><span class="o">.</span><span class="n">setGeometry</span><span class="p">(</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_padl</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padt</span><span class="p">,</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_width</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padl</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padr</span><span class="p">,</span>
<span class="bp">self</span><span class="o">.</span><span class="n">_height</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padt</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">_padb</span><span class="p">)</span>
<span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()</span><span class="o">.</span><span class="n">update</span><span class="p">()</span>
<span class="k">def</span> <span class="nf">getWidgetByName</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
<span class="k">if</span> <span class="n">name</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">_name</span><span class="p">:</span>
<span class="k">return</span> <span class="bp">self</span>
<span class="k">for</span> <span class="n">w</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">rootLayout</span><span class="p">()</span><span class="o">.</span><span class="n">iterWidgets</span><span class="p">(</span><span class="n">onlyVisible</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">recurse</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
<span class="k">if</span> <span class="n">w</span><span class="o">.</span><span class="n">_name</span> <span class="o">==</span> <span class="n">name</span><span class="p">:</span>
<span class="k">return</span> <span class="n">w</span>
<span class="k">return</span> <span class="kc">None</span></div>
</pre></div>
</div>
</div>
<footer>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2021, Eugenio Parodi.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>