Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
tile(n)			     BLT Built-In Commands		       tile(n)

______________________________________________________________________________

NAME
       tile -  Tiling versions of Tk widgets

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

_________________________________________________________________

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.   The
       offset  of the tile usually aligns with the toplevel window so that all
       sub-tiles line up.  However, image names	containing an  exlamation  "!"
       (ususally as the	last char) are tiled absolutely.

INTRODUCTION
       With the	advent of Tk 4.0, images are now easy to create	and use	in ap-
       plications.  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  fea-
       ture of windowing systems, it's very easy to use	images as textures.

       Note:  Wize  now	 adds a	-tile option to	Tk widgets natively.  However,
       these are retained to provide the -shadow option.

       Tiled widgets take the standard Tk 4.0 widgets and add tiling  configu-
       ration  options to them.	 Textures are specified	by the name of the im-
       age 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
	      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

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, tilecheck-
	      button,  tileradiobutton,	 and  tilescrollbar widgets.  Image is
	      the name an image	created	using Tk's image command.   The	 back-
	      ground  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.   Im-
	      age  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
	      "".

       -shadow shadow
	      Set shadow for text.

       -rotate degrees
	      Support for rotating text	in degrees, eg.	90, 180.

       -checksize num
	      Specify the size of check/radio button indicator.

       -icons images
	      Give a list of 0,	or 2-9 images to use for the indicators.   The
	      first  three  are	 for normal,selected,tristate.	The next three
	      repeat but for the active	state.	The next three repeat but  for
	      the disabled state.

       -bdimage	image

       -activebdimage image

       -disabledbdimage	image
	      A	border image that resizes to fit the widget.

       -bdflags	int
	      Set to -1	to perform inner rather	than outer mirror.

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

BLT				      2.5			       tile(n)

NAME | SYNOPSIS | DESCRIPTION | INTRODUCTION | EXAMPLE | OPTIONS | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tile&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help