logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

ttk_image - Define an element based on an image

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.

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

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.,  -stickyew)  or  vertically
       (-stickyns), 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).

       An  image  element  that  is  not  meant to claim any space (for example when used as a background image)
       should use -width0 and -height0.

Keywords

       style, theme, appearance, pixmap theme, image

Tk                                                     8.5                                        ttk_image(3tk)

Name

       ttk_image - Define an element based on an image

Options

       Valid options are:

       -borderpaddingpadding  is  a  list  of up to four integers, specifying the left, top, right, and bottom borders,
              respectively.  If fewer than four elements are specified, bottom defaults to top,  right  defaults
              to  left,  and  top  defaults  to left.  In other words, a list of three numbers specify the left,
              vertical, and right border; a list of two numbers specify the horizontal and the vertical  border;
              a  single  number specifies the same border all the way around the element.  See IMAGESTRETCHING,
              below.

       -heightheight
              Specifies a minimum height for the element.  If negative, the base image's height  is  used  as  a
              default.

       -paddingpadding
              Specifies  the  element's  interior  padding.   The  padding  is  a  list  of  up  to  four length
              specifications lefttoprightbottom.  If fewer than four elements are specified, bottom  defaults
              to top, right defaults to left, and top defaults to left.  In other words, a list of three numbers
              specify  the  left,  vertical, and right padding; a list of two numbers specify the horizontal and
              the vertical padding; a single number specifies the same padding all the way  around  the  widget.
              Defaults to -border if not specified.

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

       -widthwidth
              Specifies a minimum width for the element.  If negative, the base  image's  width  is  used  as  a
              default.

See Also

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

Synopsis

ttk::styleelementcreatenameimageimageSpec ?options?
________________________________________________________________________________________________________________

See Also