\documentclass[]{article}
\usepackage{amsmath,graphicx,supertabular,hyperref,tabularx,ifthen}
\title{TIP \#437: Tk panedwindow options for proxy window}
\date{July 14, 2015}
\author{Eric Boudaillier, François Vogel}
\urlstyle{sf}
\setlength{\parskip}{1ex}
\setlength{\parindent}{0pt}
\def\tipversion$#1${\texttt{\$#1\$}}
\def\tiplangle#1{\ensuremath{<}}
\def\tiprangle#1{\ensuremath{>}}
\def\tipbar#1{\ensuremath{|}}
\def\tipmail#1#2{\(\langle\){\small\expandafter\url{#1@#2}}\(\rangle\)}
\ifx\pdfoutput\undefined
\newcommand{\tipimage}[2]{\typeout{Make sure you download #1.eps}\ifthenelse{\lengthtest{0.8\textwidth>#2}\and\lengthtest{0pt<#2}}{\includegraphics{#1.eps}}{\includegraphics[width=0.8\textwidth]{#1.eps}}}
\newcommand{\tipxref}[1]{}
\newcommand{\tipxrefend}{}
\else
\newcommand{\tipimage}[2]{\typeout{Make sure you create #1.pdf}\ifthenelse{\lengthtest{0.8\textwidth>#2}\and\lengthtest{0pt<#2}}{\includegraphics{#1.pdf}}{\includegraphics[width=0.8\textwidth]{#1.pdf}}}
\pdfcatalog{/PageMode /UseOutlines}
\newcommand{\tipxref}[1]{\pdfannotlink attr {/C [0.5 0.5 1.0] /Border [0 0 1]} goto name {#1}}
\newcommand{\tipxrefend}{\pdfendlink}
\fi
\newenvironment{tipabstract}{\begin{abstract}}{\end{abstract}}
\begin{document}\maketitle
\begin{center}\begin{tabularx}{\linewidth}{|r@{: }X|}\hline
\textbf{TIP \#437}&\textbf{Tk panedwindow options for proxy window}\\\hline
Author&

Eric Boudaillier \tipmail{beric}{users.sf.net}
\par
François Vogel \tipmail{fvogelnew1}{users.sf.net}
\\
Created&Tuesday, \(\text{14}^{\text{th}}\) July 2015\\
Type&Project\\
Tcl Version&\(8.5.18\)\\
State&Final\\
Vote&Done\\
Version&\tipversion$Revision: 1.5 $\\
Keywords&Tk\\
Post History&\\
\hline\end{tabularx}\end{center}
\thispagestyle{empty}\pagestyle{empty}
\begin{tipabstract}

The proxy window (i.e., the moving sash) of the Tk paned window widget is hard to see in some circumstances. This TIP adds three options allowing more control over the display of the proxy so that its visibility can be enhanced where required.
\end{tipabstract}
\tableofcontents\setcounter{page}{0}\clearpage\pagestyle{plain}

\section{Rationale}

As identified in [Bug: 1247115, \url{https://core.tcl.tk/tk/tktview/1247115}], a flat sashrelief is common for \textbf{panedwindow} widgets, when it separates two widgets with sunken relief. For example, the left part can be a tree and the right part a text widget, both with a white background. Under Windows, the paned window has a light grey color, and in this configuration, the proxy window is not well visible when it is moved over its managed widgets.

\section{Proposed Change}

It is proposed to add three options to the Tk \textbf{panedwindow} widget: \textbf{-proxybackground}, \textbf{-proxyrelief} and \textbf{-proxyborderwidth}.
\begin{itemize}
\item{}
\textbf{-proxybackground} controls the background of the proxy window. If empty (the default), the background is that of the panedwindow widget, which is the current behaviour.
\item{}
\textbf{-proxyrelief} controls the relief of the proxy window. If empty (the default), the relief is that of the panedwindow widget, which is the current behaviour.
\item{}
\textbf{-proxyborderwidth} controls the border width of the proxy window. The default value is 2, which is the current value.
\end{itemize}

\section{Copyright}

This document has been placed in the public domain.

\section{Colophon}

\textit{TIP AutoGenerator --- written by Donal K. Fellows}
\end{document}
