Copyright (c) 2004 Joe English

 See the file "license.terms" for information on usage and redistribution
 of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 
 RCS: @(#) $Id$
 
.so  man.macros

 ttk_image n 8.5 Tk "Tk Themed Widget"
S 
 NAME
ttk_image - Define an element based on an image

 SYNOPSIS
ttk::style element create name image imageSpec ?options?
E 
 DESCRIPTION

The image element factory creates a new element
in the current theme whose visual appearance is determined
by Tk images. 
imageSpec is a list of one or more elements.
The first element is the default image name.
The rest of the list is a sequence of statespec / value
pairs specifying other images to use when the element is
in a particular state or combination of states.

 OPTIONS

Valid options are:


-border padding
padding is a list of up to four integers, specifying
the left, top, right, and bottom borders, respectively.
See IMAGE STRETCHING, below.


-height height
Specifies a minimum height for the element.
If less than zero, the base image's height is used as a default.


-padding padding
Specifies the element's interior padding. Defaults to 
-border if not specified.


-sticky spec
Specifies how the image is placed within the final parcel.
spec contains zero or more characters
.QW n ,
.QW s ,
.QW w ,
or
.QW e .


-width width
Specifies a minimum width for the element.
If less than zero, the base image's width is used as a default.

 "IMAGE STRETCHING"

If the element's allocated parcel is larger than the image, 
the image will be placed in the parcel based on the -sticky option.
If the image needs to stretch horizontally (i.e., -sticky ew)
or vertically (-sticky ns),
subregions of the image are replicated to fill the parcel
based on the -border option.
The -border divides the image into 9 regions: 
four fixed corners, top and left edges (which may be tiled horizontally),
left and right edges (which may be tiled vertically),
and the central area (which may be tiled in both directions).

 "EXAMPLE"

.CS
set img1 [image create photo -file button.png]
set img2 [image create photo -file button-pressed.png]
set img3 [image create photo -file button-active.png]
style element create Button.button image \e
 [list $img1 pressed $img2 active $img3] \e
 -border {2 4} -sticky we
.CE

 "SEE ALSO"
ttk::intro(n), ttk::style(n), ttk_vsapi(n), image(n), photo(n)

 KEYWORDS
style, theme, appearance, pixmap theme, image
 Local Variables:
 mode: nroff
 End: