NAME

       tile -  Tiling versions of Tk widgets


SYNOPSIS

       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

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


INTRODUCTION

       With  the  advent of Tk 4.0, images are now easy to create
       and use in applications.  Images add interest to  applica­
       tions  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 fea­
       ture 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 speci­
       fied by the name of the image you wish to be tiled  across
       the background of the widget.


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
              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

       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

       The following configurations options are added to the wid­
       gets. 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 nor­
              mal background color is displayed.  The default  is
              "".


KEYWORDS

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


Man(1) output converted with man2html