NAME

       ttk_image - Define an element based on an image

SYNOPSIS

       ttk::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 img3 [image create photo -file button-active.png]
              style element create Button.button image \
                  [list $img1  pressed $img2  active $img3] \
                  -border {2 4} -sticky we

SEE ALSO

       ttk::intro(3tk), ttk::style(3tk), ttk_vsapi(3tk), image(3tk), photo(3tk)

KEYWORDS

       style, theme, appearance, pixmap theme, image

Tk                                                     8.5                                        ttk_image(3tk)