#toc
Table of Contents
#toc0
Name
tile -  Tiling versions of Tk widgets
#toc1
Synopsis
tile::button
pathName
option value
...
tile::checkbutton
pathName
option value
...
tile::frame
pathName
option value
...
tile::label
pathName
option value
...
tile::radiobutton
pathName
option value
...
tile::scrollbar
pathName
option value
...
tile::toplevel
pathName
option value
...
#toc2
Description
The tile widgets let you create textured
backgrounds.  The texture is a Tk image which is tiled over the entire background
of the widget.
#toc3
Introduction
With the advent of Tk 4.0, images are now easy
to create and use in applications.  Images add interest to applications
and they convey more information.  But one area where Tk hasn't taken advantage
of images is using images as textures for widgets.  Since tiling is a standard
feature of windowing systems, it's very easy to use images  as textures.
The tile widgets take the standard Tk 4.0 widgets and add tiling configuration
options to them.  Textures are specified by the name  of the image you wish
to be tiled across the background of the widget.
#toc4
Example
To add tiling
to a widget, you simply create an image using  Tk's
image
command and use
the image name as the value for the
-tile
configuration option of the widget.
image create photo my_texture -file tan_paper.gif
blt::tile::frame .f -tile my_texture
The image
my_texture
is added to the frame.   If
my_texture
is updated,
so will the widget background.
image create photo my_texture -file rain.gif
The tile widget commands reside in the "blt::tile" namespace, so as not
to collide with the normal Tk widgets. An easy way to add tiling to existing
programs is to import the tile widget commands into the global namespace.
image create photo my_texture -file tan_paper.gif
namespace import -force blt::tile::*
frame .f -tile my_texture
To use one image for all texturing, you can use the "Tile" option class
name to specify the same image for all tile widgets.
image create photo my_texture -file tan_paper.gif
option add *Tile my_texture
#toc5
Options
The following configurations options are added to the widgets. If
a
-tile
or
-activetile
option is specified, it overrides the background color
of the widget.
-activetile
image
Specifies a textured background to display
when the widget is active. This option is available for the
tilebutton
,
tilecheckbutton
,
tileradiobutton
, and
tilescrollbar
widgets.
Image
is the
name an image created using Tk's
image
command.  The background of the widget
is tiled with
image
.  If
image
is
""
, then the active background color is
displayed.  The default is
""
.
-tile
image
Specifies a textured background
to display for the widget.
Image
is the name an image created using Tk's
image
command.  The background of the widget is tiled with
image
.  If
image
is
""
, then the normal background color is displayed.  The default is
""
.
#toc6
Keywords
tile, texture, button, label, radiobutton, checkbutton, scrollbar,
frame, toplevel
Table of Contents
#sect0
Name
#sect1
Synopsis
#sect2
Description
#sect3
Introduction
#sect4
Example
#sect5
Options
#sect6
Keywords
