TIP 262: Background Images for Frames

Bounty program for improvements to Tcl and certain Tcl packages.
Tcl 2017 Conference, Houston/TX, US, Oct 16-20
Send your abstracts to tclconference@googlegroups.com
by Aug 21.
Author:         Eric Taylor <et2@rocketship1.com>
Author:         Donal K. Fellows <donal.k.fellows@manchester.ac.uk>
State:          Draft
Type:           Project
Vote:           Pending
Created:        18-Mar-2006
Keywords:       Tk,option
Tcl-Version:    8.7


This TIP proposes an option for frames that allows users to set the background of the window to be an image.


Just a there is an -image option for button widgets, this TIP suggests that a -backgroundimage option for frames be implemented. The image should be either an entire single image, or a smaller image that would be tiled, with a -tile option. Tiling would repeat, as needed, a smaller image to fit the visible area of the frame.

If the image was tiled, then it should be re-tiled as needed during a resize. The image would reside behind any other decoration or other widgets that resided in the frame. The image should be re-configurable to replace the image and/or remove it, as with a button image.

This TIP should allow some rather classy looking tcl/tk programs to be created with much ease.

Proposed Change

Two new options are proposed for frame widgets, to be manipulated using the normal configure and cget methods:


This document has been placed in the public domain.