tile(BLT 2.4)							 tile(BLT 2.4)



______________________________________________________________________________

NAME    [Toc]    [Back]

       tile -  Tiling versions of Tk widgets

SYNOPSIS    [Toc]    [Back]

       tilebutton pathName option value...

       tilecheckbutton pathName option value...

       tileframe pathName option value...

       tilelabel pathName option value...

       tileradiobutton pathName option value...

       tilescrollbar pathName option value...

       tiletoplevel pathName option value...

______________________________________________________________________________

DESCRIPTION    [Toc]    [Back]

       The tile widgets let you create textured backgrounds.  The texture is a
       Tk image which is tiled over the entire background of the widget.

INTRODUCTION    [Toc]    [Back]

       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 X, 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.

EXAMPLE    [Toc]    [Back]

       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
	      tileframe .frame -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

       An  easy  way  to add tiling to existing programs is to rename the tile
       widget commands, overwriting the standard Tk widgets.

	      foreach cmd { button checkbutton frame label radiobutton
		   scrollbar } {
		  if [info commands tile$cmd] {
		   rename $cmd ""
		   rename tile$cmd $cmd
		  }
	      }

	      option add *Tile my_texture

	      image create photo my_texture -file tan_paper.gif

       You can then set the widget option resource, specifying the tile.

OPTIONS    [Toc]    [Back]

       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, tilecheck-
	      button, 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 "".

KEYWORDS    [Toc]    [Back]

       tile,  texture,	button,  label,  radiobutton,  checkbutton, scrollbar,
       frame, toplevel



								 tile(BLT 2.4)