Web | This Site

Python Basics
Python Advanced
Python Useful References
Python Useful Resources
Selected Reading
© 2011 TutorialsPoint.COM

| Home |  | References |  | Discussion Forums |  | About TP

# Python - Tkinter Canvas

The Canvas is a rectangular area intended for drawing pictures or other complex layouts. You can place graphics, text, widgets, or frames on a Canvas.

## Syntax:

Here is the simple syntax to create this widget:

     w = Canvas ( master, option=value, ... )

## Parameters:

- master: This represents the parent window.

- options: Here is the list of most commonly used options for this widget. These options can be used as key-value pairs separated by commas.

Option | Description
--- | ---
bd | Border width in pixels. Default is 2.
bg | Normal background color.
confine | If true (the default), the canvas cannot be scrolled outside of the scrollregion.
cursor | Cursor used in the canvas like arrow, circle, dot etc.
height | Size of the canvas in the Y dimension.
highlightcolor | Color shown in the focus highlight.
relief | Relief specifies the type of the border. Some of the values are SUNKEN, RAISED, GROOVE, and RIDGE.
scrollregion | A tuple (w, n, e, s) that defines over how large an area the canvas can be scrolled, where w is the left side, n the top, e the right side, and s the bottom.
width | Size of the canvas in the X dimension.
xscrollincrement | If you set this option to some positive dimension, the canvas can be positioned only on multiples of that distance, and the value will be used for scrolling by scrolling units, such as when the user clicks on the arrows at the ends of a scrollbar.
xscrollcommand | If the canvas is scrollable, this attribute should be the .set() method of the horizontal scrollbar.
yscrollincrement | Works like xscrollincrement, but governs vertical movement.
yscrollcommand | If the canvas is scrollable, this attribute should be the .set() method of the vertical scrollbar.

The Canvas widget can support the following standard items:

arc . Creates an arc item, which can be a chord, a pieslice, or a simple arc.

    coord = 10, 50, 240, 210
    arc = canvas.create_arc(coord, start=0, extent=150, fill="blue")

image . Creates an image item, which can be an instance of either the BitmapImage or the PhotoImage classes.

    filename = PhotoImage(file = "sunshine.gif")
    image = canvas.create_image(50, 50, anchor=NE, image=filename)

line . Creates a line item.

    line = canvas.create_line(x0, y0, x1, y1, ..., xn, yn, options)

oval . Creates a circle or an ellipse at the given coordinates. It takes two pairs of coordinates.the top left and bottom right corners of the bounding rectangle for the oval.

    oval = canvas.create_oval(x0, y0, x1, y1, options)

polygon . Creates a polygon item that must have at least three vertices.

    oval = canvas.create_polygon(x0, y0, x1, y1,...xn, yn, options)

## Example:

Try following example yourself:

    import Tkinter
    import tkMessageBox

    top = Tkinter.Tk()

    C = Tkinter.Canvas(top, bg="blue", height=250, width=300)

    coord = 10, 50, 240, 210
    arc = C.create_arc(coord, start=0, extent=150, fill="red")

    C.pack()
    top.mainloop()

This would produce following result:

Advertisement

Online Image Processing

Indian Baby Names