<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE TIP SYSTEM "http://www.tcl.tk/cgi-bin/tct/tip/tipxml.dtd">
<!-- Converted at Tue Jun 18 21:24:23 GMT 2013 -->
<!-- TIP AutoGenerator - written by Donal K. Fellows -->

<TIP number='179'>
<header><title>Add -hide Option to panedwindow Widget</title><author address="mailto:bgriffin@model.com">Brian Griffin</author><status type='project' state='final' tclversion="8.5" vote='after'>$Revision: 1.5 $</status><history></history><created day='22' month='mar' year='2004' /><keyword>Tk</keyword></header>
<abstract>This TIP proposes adding a <emph style="bold">paneconfigure</emph> option to <emph style="bold">panedwindow</emph>s that will control pane visibility.</abstract>
<body><section title="Rationale">
<para>Adding control over individual pane visibility to the <emph style="bold">panedwindow</emph> widget would simplify the construction and control of complex user interfaces. For example, look at applications such as Komodo, or MS Visual Studio, where the U/I contains 4-7 panes in 2 or more nested panedwindows. Both of these applications as well as many others allow user controlled visibility of individual panes. Trying to manage the visibility and placement of these panes requires much additional code and adds complexity to the U/I implementation. Alternatively, if the panedwindow allowed control of visibility while maintaining pane position and configure options (as does the <emph style="bold">grid remove</emph> method), the U/I code is essentially reduced to a simple one line [<emph style="italic">$w</emph> <emph style="bold">configure -hide</emph>].</para>
</section>
<section title="Proposed Change">
<para>This TIP will add a <emph style="bold">-hide</emph> option to the <emph style="bold">paneconfigure</emph> for individual panes. The option will control the visibility of the pane. When set to true (as interpreted by <emph style="italic">Tcl_GetBooleanFromObj()</emph>), the pane will be unmapped and will not be considered when arranging the remaining panes for display. Hidden panes will still be reported by the [<emph style="italic">$w</emph> <emph style="bold">panes</emph>] method and can be referenced when adding panes with the <emph style="bold">-after</emph> or <emph style="bold">-before</emph> options.</para>
<para>The advantage of a <emph style="bold">paneconfigure</emph> option over the <emph style="bold">remove</emph> method of the <emph style="bold">grid</emph> command is that the pane is still query-able and configurable.</para>
</section>
<section title="Draft Implementation">
<para>An implementation of this enhancement is available [<url ref="ftp://ftp.model.com/pub/tcl/pw_hide_TIP.tgz"/>].</para>
</section>
<section title="Copyright">
<para>This document has been placed in the public domain.</para>
</section>
</body></TIP>
