Mac Developer Library Developer


This manual page is for Mac OS X version 10.9

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.

ttk_image(n)                                  Tk Themed Widget                                  ttk_image(n)


       ttk_image - Define an element based on an image

       ttk::style element create name image imageSpec ?options?

       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.

       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 charac-ters characters
              ters "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.

       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 verti-cally vertically
       cally (-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).

              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

       ttk::intro(n), ttk::style(n), ttk_vsapi(n), image(n), photo(n)

       style, theme, appearance, pixmap theme, image

Tk                                                   8.5                                        ttk_image(n)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation to the Tk project.
Bug reports
Report bugs in the functionality of the described tool or API to Apple through Bug Reporter and to the Tk project through their bug reporting page.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.