"Fossies" - the Fresh Open Source Software Archive

Member "SAOImageDS9/tk8.6/doc/ttk_image.n" (13 Nov 2019, 3547 Bytes) of package /linux/misc/ds9.8.1.tar.gz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even erroneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.

ttk_image

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
IMAGE STRETCHING
EXAMPLE
SEE ALSO
KEYWORDS

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. 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 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. The padding is a list of up to four length specifications left top right bottom. 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.

−sticky spec

Specifies how the image is placed within the final parcel. spec contains zero or more characters or

−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(n), ttk::style(n), ttk_vsapi(n), image(n), photo(n)

KEYWORDS

style, theme, appearance, pixmap theme, image