## Tcl9.0.3/Tk9.0.3 Documentation > Tk Commands > ttk_image

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    ttk_image — 影像に基く要素を定義する｡　 Define an element based on an image
  構文 SYNOPSIS
  説明 DESCRIPTION
  指示項目 OPTIONS
    -border padding
    -height height
    -padding padding
    -sticky spec
    -width width
  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

この image 要素の群は､その外観が Tk 影像によって定められる現在の主題の新しい要素を創生する｡ imageSpec は一つ或はそれ以上の要素のリストである｡第１の要素は省略時設定の影像の名前である｡リストの残りは､要素が特定の状態か状態の組合せになる時に使う為の他の影像を指定する規格条項 / 値の対の並びである｡ 　　　 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 は４個以内の整数であり､左､上､右､下の縁をそれぞれ指定する｡ もし４より少ない要素が指定されている場合は､底辺の省略時設定は頂辺であり､右辺の省略時設定は左辺､頂辺の省略時設定は左辺である｡謂い換えると､３つの数字は左､垂直､右縁を指定する; ２つの数字は水平と､垂直縁を指定する; 一つの数字は要素の周りの全ての同じ縁を指定する｡IMAGE STRETCHING を参照されたい｡ 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 negative, the base image's height is used as a default.

-padding padding
  要素の内部の詰め込みを指定する｡詰め込みは､４つ迄の長さの仕様 即ち､左､頂､右､底､のリストである｡ もし４より少ない要素が指定されている場合は､底の省略時設定は頂であり､右の省略時設定は左､頂の省略時設定は左である｡謂い換えると､３つの数字は左､垂直､右縁を指定する; ２つの数字は水平と､垂直縁を指定する; 一つの数字は要素の周りの全ての同じ縁を指定する｡ もし指定されなければ -border が省略時設定になる｡ 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
  最終的な区画の内部に影像が如何に置かれるかを指定する｡ spec は零或はそれ以上の文字の “n” か “s” か “w” か “e” かである｡ 　　 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 negative, the base image's width is used as a default.

### IMAGE STRETCHING

もし要素の配置された区画が影像より大きい場合､影像は -sticky 指示項目に基いて区画内に置かれる｡もし影像が水平(即ち､ -sticky ew)か垂直に(-sticky ns)伸ばす必要がある場合､影像の部分領域が -border 指示項目に基いて区域を満たす為に複製される｡ -border は影像を９つの領域に分割する: ４つの隅､上と左の端(水平に張付ける)､左と右の縁(垂直に張付ける)､真ん中の領域(両方向にべた張りする)｡ 　　　 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).

如何なる区間も宣言することを意味しない影像要素は -width 0 と -height 0 を使う事が望ましい(譬えば､背景映像として使われる時)｡ An image element that is not meant to claim any space (for example when used as a background image) should use -width 0 and -height 0.

### 用例 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

### SEE ALSO

ttk::intro, ttk::style, ttk_vsapi, image, photo

### KEYWORDS

style, theme, appearance, pixmap theme, image
Copyright © 2004 Joe English