head	1.15;
access;
symbols
	core-8-5-9:1.12.2.2
	core-8-5-8:1.12.2.1
	macosx-cocoa-merge:1.15
	macosx-cocoa-premerge:1.15
	macosx-carbon-freeze:1.15
	core-8-5-7:1.12
	core-8-5-6:1.12
	core-8-6-b1:1.15
	core-8-6-a3:1.15
	core-8-5-5:1.12
	core-8-6-a2:1.14
	core-8-5-4:1.12
	core-8-5-3:1.12
	core-8-6-a1:1.13
	core-8-5-branch:1.12.0.2
	core-8-5-2:1.12
	core-8-5-1:1.12
	core-8-5-0:1.12
	core-8-5-b3:1.11
	core-8-5-b2:1.9
	core-8-5-b1:1.6
	core-stablilizer-merge:1.6
	core-stabilizer-branch:1.6.0.2
	core-stabilizer-merge:1.12
	core-8-5-a6:1.6;
locks; strict;
comment	@# @;


1.15
date	2008.09.23.13.36.56;	author dkf;	state Exp;
branches;
next	1.14;

1.14
date	2008.06.30.22.57.03;	author dkf;	state Exp;
branches;
next	1.13;

1.13
date	2008.04.09.09.28.05;	author patthoyts;	state Exp;
branches;
next	1.12;

1.12
date	2007.12.13.15.23.44;	author dgp;	state Exp;
branches
	1.12.2.1;
next	1.11;

1.11
date	2007.11.01.10.59.43;	author dkf;	state Exp;
branches;
next	1.10;

1.10
date	2007.10.29.16.04.14;	author dkf;	state Exp;
branches;
next	1.9;

1.9
date	2007.10.26.20.13.23;	author dgp;	state Exp;
branches;
next	1.8;

1.8
date	2007.10.23.15.44.36;	author dkf;	state Exp;
branches;
next	1.7;

1.7
date	2007.10.22.14.33.13;	author dkf;	state Exp;
branches;
next	1.6;

1.6
date	2007.04.23.21.19.51;	author das;	state Exp;
branches
	1.6.2.1;
next	1.5;

1.5
date	2006.12.13.23.04.33;	author hobbs;	state Exp;
branches;
next	1.4;

1.4
date	2006.12.09.20.53.35;	author jenglish;	state Exp;
branches;
next	1.3;

1.3
date	2006.11.16.13.25.11;	author dkf;	state Exp;
branches;
next	1.2;

1.2
date	2006.11.15.13.29.17;	author dkf;	state Exp;
branches;
next	1.1;

1.1
date	2006.10.31.01.42.25;	author hobbs;	state Exp;
branches;
next	;

1.6.2.1
date	2007.10.24.12.59.31;	author dgp;	state Exp;
branches;
next	1.6.2.2;

1.6.2.2
date	2007.10.27.04.23.14;	author dgp;	state Exp;
branches;
next	1.6.2.3;

1.6.2.3
date	2007.11.01.16.37.16;	author dgp;	state Exp;
branches;
next	;

1.12.2.1
date	2009.05.14.00.53.04;	author patthoyts;	state Exp;
branches;
next	1.12.2.2;

1.12.2.2
date	2010.08.26.02.06.09;	author hobbs;	state Exp;
branches;
next	;


desc
@@


1.15
log
@Fix [Bug 2118116]
@
text
@'\"
'\" 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: ttk_image.n,v 1.14 2008/06/30 22:57:03 dkf Exp $
'\" 
.so man.macros
.TH ttk_image n 8.5 Tk "Tk Themed Widget"
.BS
.SH NAME
ttk_image \- Define an element based on an image
.SH SYNOPSIS
\fBttk::style element create \fIname\fR \fBimage\fR \fIimageSpec\fR ?\fIoptions\fR?
.BE
.SH DESCRIPTION
.PP
The \fIimage\fR element factory creates a new element
in the current theme whose visual appearance is determined
by Tk images. 
\fIimageSpec\fP 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 \fIstatespec / value\fR
pairs specifying other images to use when the element is
in a particular state or combination of states.
.SH OPTIONS
.PP
Valid \fIoptions\fR are:
.TP
\fB\-border\fR \fIpadding\fR
\fIpadding\fR is a list of up to four integers, specifying
the left, top, right, and bottom borders, respectively.
See \fBIMAGE STRETCHING\fR, below.
.TP
\fB\-height \fIheight\fR
Specifies a minimum height for the element.
If less than zero, the base image's height is used as a default.
.TP
\fB\-padding\fR \fIpadding\fR
Specifies the element's interior padding.  Defaults to 
\fB\-border\fR if not specified.
.TP
\fB\-sticky\fR \fIspec\fR
Specifies how the image is placed within the final parcel.
\fIspec\fR contains zero or more characters
.QW n ,
.QW s ,
.QW w ,
or
.QW e .
.TP
\fB\-width \fIwidth\fR
Specifies a minimum width for the element.
If less than zero, the base image's width is used as a default.
.SH "IMAGE STRETCHING"
.PP
If the element's allocated parcel is larger than the image, 
the image will be placed in the parcel based on the \fB\-sticky\fR option.
If the image needs to stretch horizontally (i.e., \fB\-sticky ew\fR)
or vertically (\fB\-sticky ns\fR),
subregions of the image are replicated to fill the parcel
based on the \fB\-border\fR option.
The \fB\-border\fR 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).
.SH "EXAMPLE"
.PP
.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
.SH "SEE ALSO"
ttk::intro(n), ttk::style(n), ttk_vsapi(n), image(n), photo(n)
.SH KEYWORDS
style, theme, appearance, pixmap theme, image
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.14
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@a0 1
'\" -*- nroff -*-
d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.13 2008/04/09 09:28:05 patthoyts Exp $
d82 3
@


1.13
log
@Improved the element factory documentation and cross-links
@
text
@d1 1
d8 1
a8 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.12 2007/12/13 15:23:44 dgp Exp $
d19 1
d29 1
d58 1
d70 1
@


1.12
log
@merge stable branch onto HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.6.2.3 2007/11/01 16:37:16 dgp Exp $
d10 1
a10 1
.TH ttk::image n 8.5 Tk "Tk Themed Widget"
d13 1
a13 1
ttk::image \- Define an element based on an image
d75 1
a75 1
image(n), photo(n)
d77 1
a77 1
pixmap theme, image
@


1.12.2.1
log
@Backported support for the Vista theme.
This requires the vsapi element engine, the hover state and the theme script definition.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.12 2007/12/13 15:23:44 dgp Exp $
d10 1
a10 1
.TH ttk_image n 8.5 Tk "Tk Themed Widget"
d13 1
a13 1
ttk_image \- Define an element based on an image
d75 1
a75 1
ttk::intro(n), ttk::style(n), ttk_vsapi(n), image(n), photo(n)
d77 1
a77 1
style, theme, appearance, pixmap theme, image
@


1.12.2.2
log
@        Major backport of 8.6 Ttk for 8.5.9.  Most changes were only being
        committed to head (8.6), although they could apply for 8.5 as well.
        This re-sync makes future work easier to maintain and adds some
        useful work for 8.5 users. Notable changes:
        - Lots of code cleanup
        - Some bug fixes never backported
        - Addition of ttk::spinbox
        - minor color changes
        - Improved Vista/7 styling
        - Move to tile version 0.8.6 (pseudo-package)
        - ABI and API compatible (even $w identify)
        - minor new features (extended $w identify)
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.15 2008/09/23 13:36:56 dkf Exp $
a17 1
.PP
a26 1
.PP
a54 1
.PP
a65 1
.PP
a77 3
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.11
log
@Make documentation use the name that scripts use as much as possible.
[Bug 1640073]
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.10 2007/10/29 16:04:14 dkf Exp $
@


1.10
log
@Lots more GOOBE stuff. Now works with 'make html'!
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.9 2007/10/26 20:13:23 dgp Exp $
d10 1
a10 1
.TH ttk_image n 8.5 Tk "Tk Themed Widget"
d13 1
a13 1
ttk_image \- Define an element based on an image
@


1.9
log
@        * doc/*.1:              Revert doc changes that broke
        * doc/*.3:              `make html` so we can get the release
        * doc/*.n:              out the door.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.6 2007/04/23 21:19:51 das Exp $
a16 1

a25 1

d29 1
a29 1
\fB-border\fR \fIpadding\fR
d34 1
a34 1
\fB-height \fIheight\fR
d38 1
a38 1
\fB-padding\fR \fIpadding\fR
d40 1
a40 1
\fI-border\fR if not specified.
d42 1
a42 1
\fB-sticky\fR \fIspec\fR
d44 6
a49 1
\fIspec\fR contains zero or more characters "n", "s", "w", or "e".
d51 1
a51 1
\fB-width \fIwidth\fR
a53 1

d56 3
a58 3
the image will be placed in the parcel based on the \fB-sticky\fR option.
If the image needs to stretch horizontally (i.e., \fB-sticky ew\fR)
or vertically (\fB-sticky ns\fR),
d60 2
a61 2
based on the \fB-border\fR option.
The \fB-border\fR divides the image into 9 regions: 
a64 1

d67 3
a69 3
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]
d72 1
a72 1
   -border {2 4} -sticky we
a73 1

a75 1

@


1.8
log
@Rendering-with-groff GOOBE.
@
text
@d6 3
a8 3
'\"
'\" RCS: @@(#) $Id: ttk_image.n,v 1.7 2007/10/22 14:33:13 dkf Exp $
'\"
d19 9
a27 6
The \fIimage\fR element factory creates a new element in the current theme
whose visual appearance is determined by Tk images. \fIimageSpec\fP 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 \fIstatespec / value\fR pairs specifying other
images to use when the element is in a particular state or combination of
states.
d31 4
a34 4
\fB\-border\fR \fIpadding\fR
.
\fIpadding\fR is a list of up to four integers, specifying the left, top,
right, and bottom borders, respectively. See \fBIMAGE STRETCHING\fR, below.
d36 3
a38 4
\fB\-height \fIheight\fR
.
Specifies a minimum height for the element. If less than zero, the base
image's height is used as a default.
d40 3
a42 4
\fB\-padding\fR \fIpadding\fR
.
Specifies the element's interior padding. Defaults to \fI\-border\fR if not
specified.
d44 3
a46 4
\fB\-sticky\fR \fIspec\fR
.
Specifies how the image is placed within the final parcel. \fIspec\fR contains
zero or more characters "n", "s", "w", or "e".
d48 4
a51 4
\fB\-width \fIwidth\fR
.
Specifies a minimum width for the element. If less than zero, the base image's
width is used as a default.
d53 11
a63 8
If the element's allocated parcel is larger than the image, the image will be
placed in the parcel based on the \fB\-sticky\fR option. If the image needs to
stretch horizontally (i.e., \fB\-sticky ew\fR) or vertically (\fB\-sticky
ns\fR), subregions of the image are replicated to fill the parcel based on the
\fB\-border\fR option. The \fB\-border\fR 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).
d70 2
a71 2
        [list $img1  pressed $img2  active $img3] \e
        -border {2 4} -sticky we
d73 1
d76 1
@


1.7
log
@Documentation improvements, all minor.
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.6 2007/04/23 21:19:51 das Exp $
a24 1

a51 1

a60 1

a69 1

a71 1

@


1.6
log
@	* doc/colors.n:		document new Mac OS X system colors.
	* doc/cursors.n:	document new Mac OS X native cursors.
	* doc/font.n:		document new Mac OS X 'menu' system font.
	* doc/wm.n:		document new Mac OS X [wm attributes].
	* doc/ttk_image.n:	fix 'make html' warning.
	* doc/canvas.n:		fix nroff typo.
@
text
@d6 3
a8 3
'\" 
'\" RCS: @@(#) $Id: ttk_image.n,v 1.5 2006/12/13 23:04:33 hobbs Exp $
'\" 
d19 6
a24 8
The \fIimage\fR element factory creates a new element
in the current theme whose visual appearance is determined
by Tk images. 
\fIimageSpec\fP 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 \fIstatespec / value\fR
pairs specifying other images to use when the element is
in a particular state or combination of states.
d29 4
a32 4
\fB-border\fR \fIpadding\fR
\fIpadding\fR is a list of up to four integers, specifying
the left, top, right, and bottom borders, respectively.
See \fBIMAGE STRETCHING\fR, below.
d34 4
a37 3
\fB-height \fIheight\fR
Specifies a minimum height for the element.
If less than zero, the base image's height is used as a default.
d39 4
a42 3
\fB-padding\fR \fIpadding\fR
Specifies the element's interior padding.  Defaults to 
\fI-border\fR if not specified.
d44 4
a47 3
\fB-sticky\fR \fIspec\fR
Specifies how the image is placed within the final parcel.
\fIspec\fR contains zero or more characters "n", "s", "w", or "e".
d49 4
a52 3
\fB-width \fIwidth\fR
Specifies a minimum width for the element.
If less than zero, the base image's width is used as a default.
d55 8
a62 10
If the element's allocated parcel is larger than the image, 
the image will be placed in the parcel based on the \fB-sticky\fR option.
If the image needs to stretch horizontally (i.e., \fB-sticky ew\fR)
or vertically (\fB-sticky ns\fR),
subregions of the image are replicated to fill the parcel
based on the \fB-border\fR option.
The \fB-border\fR 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).
d70 2
a71 2
    [list $img1  pressed $img2  active $img3] \e
   -border {2 4} -sticky we
@


1.6.2.1
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.6 2007/04/23 21:19:51 das Exp $
d19 9
a27 6
The \fIimage\fR element factory creates a new element in the current theme
whose visual appearance is determined by Tk images. \fIimageSpec\fP 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 \fIstatespec / value\fR pairs specifying other
images to use when the element is in a particular state or combination of
states.
d31 4
a34 4
\fB\-border\fR \fIpadding\fR
.
\fIpadding\fR is a list of up to four integers, specifying the left, top,
right, and bottom borders, respectively. See \fBIMAGE STRETCHING\fR, below.
d36 3
a38 4
\fB\-height \fIheight\fR
.
Specifies a minimum height for the element. If less than zero, the base
image's height is used as a default.
d40 3
a42 4
\fB\-padding\fR \fIpadding\fR
.
Specifies the element's interior padding. Defaults to \fI\-border\fR if not
specified.
d44 3
a46 4
\fB\-sticky\fR \fIspec\fR
.
Specifies how the image is placed within the final parcel. \fIspec\fR contains
zero or more characters "n", "s", "w", or "e".
d48 4
a51 4
\fB\-width \fIwidth\fR
.
Specifies a minimum width for the element. If less than zero, the base image's
width is used as a default.
d53 11
a63 8
If the element's allocated parcel is larger than the image, the image will be
placed in the parcel based on the \fB\-sticky\fR option. If the image needs to
stretch horizontally (i.e., \fB\-sticky ew\fR) or vertically (\fB\-sticky
ns\fR), subregions of the image are replicated to fill the parcel based on the
\fB\-border\fR option. The \fB\-border\fR 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).
d70 2
a71 2
        [list $img1  pressed $img2  active $img3] \e
        -border {2 4} -sticky we
d73 1
d76 1
@


1.6.2.2
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: ttk_image.n,v 1.6.2.1 2007/10/24 12:59:31 dgp Exp $
d19 6
a24 9
The \fIimage\fR element factory creates a new element
in the current theme whose visual appearance is determined
by Tk images. 
\fIimageSpec\fP 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 \fIstatespec / value\fR
pairs specifying other images to use when the element is
in a particular state or combination of states.

d28 4
a31 4
\fB-border\fR \fIpadding\fR
\fIpadding\fR is a list of up to four integers, specifying
the left, top, right, and bottom borders, respectively.
See \fBIMAGE STRETCHING\fR, below.
d33 4
a36 3
\fB-height \fIheight\fR
Specifies a minimum height for the element.
If less than zero, the base image's height is used as a default.
d38 4
a41 3
\fB-padding\fR \fIpadding\fR
Specifies the element's interior padding.  Defaults to 
\fI-border\fR if not specified.
d43 4
a46 3
\fB-sticky\fR \fIspec\fR
Specifies how the image is placed within the final parcel.
\fIspec\fR contains zero or more characters "n", "s", "w", or "e".
d48 4
a51 4
\fB-width \fIwidth\fR
Specifies a minimum width for the element.
If less than zero, the base image's width is used as a default.

d53 8
a60 11
If the element's allocated parcel is larger than the image, 
the image will be placed in the parcel based on the \fB-sticky\fR option.
If the image needs to stretch horizontally (i.e., \fB-sticky ew\fR)
or vertically (\fB-sticky ns\fR),
subregions of the image are replicated to fill the parcel
based on the \fB-border\fR option.
The \fB-border\fR 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).

d67 2
a68 2
    [list $img1  pressed $img2  active $img3] \e
   -border {2 4} -sticky we
a69 1

a71 1

@


1.6.2.3
log
@merge updates from HEAD
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id$
d10 1
a10 1
.TH ttk::image n 8.5 Tk "Tk Themed Widget"
d13 1
a13 1
ttk::image \- Define an element based on an image
d17 1
d27 1
d31 1
a31 1
\fB\-border\fR \fIpadding\fR
d36 1
a36 1
\fB\-height \fIheight\fR
d40 1
a40 1
\fB\-padding\fR \fIpadding\fR
d42 1
a42 1
\fB\-border\fR if not specified.
d44 1
a44 1
\fB\-sticky\fR \fIspec\fR
d46 1
a46 6
\fIspec\fR contains zero or more characters
.QW n ,
.QW s ,
.QW w ,
or
.QW e .
d48 1
a48 1
\fB\-width \fIwidth\fR
d51 1
d54 3
a56 3
the image will be placed in the parcel based on the \fB\-sticky\fR option.
If the image needs to stretch horizontally (i.e., \fB\-sticky ew\fR)
or vertically (\fB\-sticky ns\fR),
d58 2
a59 2
based on the \fB\-border\fR option.
The \fB\-border\fR divides the image into 9 regions: 
d63 1
d66 3
a68 3
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]
d71 1
a71 1
    \-border {2 4} \-sticky we
d73 1
d76 1
@


1.5
log
@	* unix/Makefile.in (install-doc): intentionally skip ttk_dialog.n
	installation (not for public consumption)

	* doc/scrollbar.n, doc/button.n, doc/checkbutton.n:
	* doc/entry.n, doc/frame.n, doc/label.n, doc/labelframe.n:
	* doc/menu.n, doc/menubutton.n, doc/panedwindow.n:
	* doc/radiobutton.n, doc/scrollbar.n, doc/ttk_*: revamp ttk docs
	to use consist nroff format (not 100% consistent with classic
	widget docs).  Add more man page cross-linking "SEE ALSO".
@
text
@d7 1
a7 1
'\" RCS: @@(#) $Id: popup.n,v 1.4 2004/06/21 20:59:29 dkf Exp $
a39 1
.TP
@


1.4
log
@Merged duplicate functionality between image element factory,
image element, and -image option processing.  Image element
factory now takes an imageSpec argument instead of a separate
image name and -map option.
@
text
@d3 5
a7 1
'\" $Id: ttk_image.n,v 1.3 2006/11/16 13:25:11 dkf Exp $
d17 1
d27 1
d29 1
a29 1
Valid  \fIoptions\fR are:
d64 1
d74 1
d77 1
@


1.3
log
@Highlighted keyword in example
@
text
@d3 1
a3 1
'\" $Id: ttk_image.n,v 1.2 2006/11/15 13:29:17 dkf Exp $
d11 1
a11 1
\fBttk::style create element \fIname\fR \fBimage\fR \fIimageName\fR ?\fIoptions\fR?
d16 6
a21 1
by a Tk image.
a33 10
\fB-map { \fIstatespec\fR \fIimage\fR.. }
Specifies auxilliary images to use in different states.
Each \fIstatespec\fR is a list of state names optionally
prefixed by an exclamation point, as in \fBttk::style map\fR.
Each \fIimageName\fR is the name of a Tk image 
defined with \fBimage create ...\fR.
When the element is displayed, each \fIstatespec\fR is
tested in order, and the \fIimage\fR corresponding to
the first matching \fIstatespec\fR is used.  
If none match, the base \fIimageName\fR is used.
d60 6
a65 4
set button(normal) [image create photo -file button.png]
set button(pressed) [image create photo -file button-pressed.png]
ttk::style element create Button.button \fBimage\fR $button(normal) \e
   -border {2 4} -map [list pressed $button(pressed)] -sticky nswe
@


1.2
log
@Convert \fP to \fR so that man-page scrapers have an easier time.
@
text
@d3 1
a3 1
'\" $Id: ttk_image.n,v 1.1 2006/10/31 01:42:25 hobbs Exp $
d67 1
a67 1
ttk::style element create Button.button image $button(normal) \e
@


1.1
log
@	* doc/ttk_Geometry.3, doc/ttk_Theme.3, doc/ttk_button.n:
	* doc/ttk_checkbutton.n, doc/ttk_combobox.n, doc/ttk_dialog.n:
	* doc/ttk_entry.n, doc/ttk_frame.n, doc/ttk_image.n:
	* doc/ttk_intro.n, doc/ttk_label.n, doc/ttk_labelframe.n:
	* doc/ttk_menubutton.n, doc/ttk_notebook.n, doc/ttk_panedwindow.n:
	* doc/ttk_progressbar.n, doc/ttk_radiobutton.n, doc/ttk_scrollbar.n:
	* doc/ttk_separator.n, doc/ttk_sizegrip.n, doc/ttk_style.n:
	* doc/ttk_treeview.n, doc/ttk_widget.n,:
	* generic/ttk/ttk.decls, generic/ttk/ttkBlink.c:
	* generic/ttk/ttkButton.c, generic/ttk/ttkCache.c:
	* generic/ttk/ttkClamTheme.c, generic/ttk/ttkClassicTheme.c:
	* generic/ttk/ttkDecls.h, generic/ttk/ttkDefaultTheme.c:
	* generic/ttk/ttkElements.c, generic/ttk/ttkEntry.c:
	* generic/ttk/ttkFrame.c, generic/ttk/ttkImage.c:
	* generic/ttk/ttkInit.c, generic/ttk/ttkLabel.c:
	* generic/ttk/ttkLayout.c, generic/ttk/ttkManager.c:
	* generic/ttk/ttkManager.h, generic/ttk/ttkNotebook.c:
	* generic/ttk/ttkPanedwindow.c, generic/ttk/ttkProgress.c:
	* generic/ttk/ttkScale.c, generic/ttk/ttkScroll.c:
	* generic/ttk/ttkScrollbar.c, generic/ttk/ttkSeparator.c:
	* generic/ttk/ttkSquare.c, generic/ttk/ttkState.c:
	* generic/ttk/ttkStubInit.c, generic/ttk/ttkStubLib.c:
	* generic/ttk/ttkTagSet.c, generic/ttk/ttkTheme.c:
	* generic/ttk/ttkTheme.h, generic/ttk/ttkThemeInt.h:
	* generic/ttk/ttkTrace.c, generic/ttk/ttkTrack.c:
	* generic/ttk/ttkTreeview.c, generic/ttk/ttkWidget.c:
	* generic/ttk/ttkWidget.h:
	* library/demos/ttk_demo.tcl, library/demos/ttk_iconlib.tcl:
	* library/demos/ttk_repeater.tcl:
	* library/ttk/altTheme.tcl, library/ttk/aquaTheme.tcl:
	* library/ttk/button.tcl, library/ttk/clamTheme.tcl:
	* library/ttk/classicTheme.tcl, library/ttk/combobox.tcl:
	* library/ttk/cursors.tcl, library/ttk/defaults.tcl:
	* library/ttk/dialog.tcl, library/ttk/entry.tcl:
	* library/ttk/fonts.tcl, library/ttk/icons.tcl:
	* library/ttk/keynav.tcl, library/ttk/menubutton.tcl:
	* library/ttk/notebook.tcl, library/ttk/panedwindow.tcl:
	* library/ttk/progress.tcl, library/ttk/scale.tcl:
	* library/ttk/scrollbar.tcl, library/ttk/sizegrip.tcl:
	* library/ttk/treeview.tcl, library/ttk/ttk.tcl:
	* library/ttk/utils.tcl, library/ttk/winTheme.tcl:
	* library/ttk/xpTheme.tcl:
	* macosx/ttkMacOSXTheme.c:
	* tests/ttk/all.tcl, tests/ttk/bwidget.test, tests/ttk/combobox.test:
	* tests/ttk/entry.test, tests/ttk/image.test:
	* tests/ttk/labelframe.test, tests/ttk/layout.test:
	* tests/ttk/misc.test, tests/ttk/notebook.test:
	* tests/ttk/panedwindow.test, tests/ttk/progressbar.test:
	* tests/ttk/scrollbar.test, tests/ttk/treetags.test:
	* tests/ttk/treeview.test, tests/ttk/ttk.test, tests/ttk/validate.test:
	* win/ttkWinMonitor.c, win/ttkWinTheme.c, win/ttkWinXPTheme.c:
	First import of Ttk themed Tk widgets as branched from tile 0.7.8

	* generic/tkInt.h, generic/tkWindow.c: add Ttk_Init call, copy
	tk classic widgets to ::tk namespace.
	* library/tk.tcl: add source of ttk/ttk.tcl, define $::ttk::library.
	* unix/Makefile.in, win/Makefile.in: add Ttk build bits
	* win/configure, win/configure.in: check for uxtheme.h (XP theme).
@
text
@d3 1
a3 1
'\" $Id: image.n,v 1.1 2004/09/15 18:26:48 jenglish Exp $
d14 1
a14 1
The \fIimage\fP element factory creates a new element
d20 2
a21 2
\fB-border\fP \fIpadding\fP
\fIpadding\fP is a list of up to four integers, specifying
d23 1
a23 1
See \fBIMAGE STRETCHING\fP, below.
d25 1
a25 1
\fB-height \fIheight\fP
d29 1
a29 1
\fB-map { \fIstatespec\fP \fIimage\fP.. }
d31 8
a38 8
Each \fIstatespec\fP is a list of state names optionally
prefixed by an exclamation point, as in \fBttk::style map\fP.
Each \fIimageName\fP is the name of a Tk image 
defined with \fBimage create ...\fP.
When the element is displayed, each \fIstatespec\fP is
tested in order, and the \fIimage\fP corresponding to
the first matching \fIstatespec\fP is used.  
If none match, the base \fIimageName\fP is used.
d40 1
a40 1
\fB-padding\fP \fIpadding\fP
d42 1
a42 1
\fI-border\fP if not specified.
d44 1
a44 1
\fB-sticky\fP \fIspec\fP
d46 1
a46 1
\fIspec\fP contains zero or more characters "n", "s", "w", or "e".
d48 1
a48 1
\fB-width \fIwidth\fP
d54 3
a56 3
the image will be placed in the parcel based on the \fB-sticky\fP option.
If the image needs to stretch horizontally (i.e., \fB-sticky ew\fP)
or vertically (\fB-sticky ns\fP),
d58 2
a59 2
based on the \fB-border\fP option.
The \fB-border\fP divides the image into 9 regions: 
@

