Next / Previous / Contents / TCC Help System / NM Tech homepage

7.9. Canvas image objects

To display a graphics image on a canvas C, use:

    id = C.create_image ( x, y, option, ... )

This constructor returns the integer ID number of the image object for that canvas.

The image is positioned relative to point (x, y). Options include:

activeimage Image to be displayed when the mouse is over the item. For option values, see image below.
anchor The default is anchor=CENTER, meaning that the image is centered on the (x, y) position. See Section 5.5, “Anchors” for the possible values of this option. For example, if you specify anchor=S, the image will be positioned so that point (x, y) is located at the center of the bottom (south) edge of the image.
disabledimage Image to be displayed when the item is inactive. For option values, see image below.
image The image to be displayed. See Section 5.9, “Images”, above, for information about how to create images that can be loaded onto canvases.
state Normally, image objects are created in state NORMAL. Set this value to DISABLED to make it grayed-out and unresponsive to the mouse. If you set it to HIDDEN, the item is invisible.
tags The tags to be associated with the object, as a sequence of strings. See Section 7.4, “Canvas tags”.