image(3tcl)
NAME
ttk_image - Define an element based on an image
SYNOPSIS
style element create name image imageSpec ?options?
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 "n", "s", "w", or "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
- set img1 [image create photo -file button.png] set img2 [image create
photo -file button-pressed.png] set img.TH 3tcl [image create photo
-file button-active.png] style element create Button.button image \
- [list $img1 pressed $img2 active $img.TH 3tcl] \
- -border {2 4} -sticky we
SEE ALSO
image(n), photo(n)
KEYWORDS
- pixmap theme, image