一、介绍

Canvas（画布）组件为 Tkinter的图形绘制提供了基础。Canvas是一个高度灵活的组件，你可以用它绘制图形和图表，创建图形编辑器，并实现各种自定义的小部件。

二、使用

1、绘制对象

在 Canvas组件上绘制对象，可以用 create_xxx() 的方法（xxx 表示对象类型，例如线段 line，矩形 rectangle，文本 text 等）：

from tkinter import *
root = Tk()
c = Canvas(root,width=200,height=100)
c.pack()
c.create_line(0, 50, 200, 50, fill="yellow")
# 画一条红色的竖线（虚线）
c.create_line(100, 0, 100, 100, fill="red", dash=(4, 4))
# 中间画一个蓝色的矩形
c.create_rectangle(50, 25, 150, 75, fill="blue")
mainloop()

注意，添加到 Canvas 上的对象会一直保留直着。如果你希望修改它们，你可以使用 coords()，itemconfig() 和move()方法来移动画布上的对象，或者使用 delete() 方法来删除：

line1 = w.create_line(0, 50, 200, 50, fill="yellow")
line2 = w.create_line(100, 0, 100, 100, fill="red", dash=(4, 4))
rect1 = w.create_rectangle(50, 25, 150, 75, fill="blue")

w.coords(line1, 0, 25, 200, 25)
w.itemconfig(rect1, fill="red")
w.delete(line2)

Button(root, text="删除全部", command=(lambda x=ALL : w.delete(x))).pack()

2、显示文本

你还可以在 Canvas 上显示文本，使用的是create_text()方法：

w.create_line(0, 0, 200, 100, fill="green", width=3)   #0，0，200，100表示位置（0，0）表示一个点，（200，100）表示一个点
w.create_line(200, 0, 0, 100, fill="green", width=3)
w.create_rectangle(40, 20, 160, 80, fill="green")
w.create_rectangle(65, 35, 135, 65, fill="yellow")

w.create_text(100, 50, text="FishC")   #100,50表示位置，100表示水平位置，50表示垂直位置

3、绘制椭圆和多边形

使用 create_oval()方法绘制椭圆形（或圆形），参数是指定一个限定矩形（Tkinter 会自动在这个矩形内绘制一个椭圆）：

from tkinter import *
root = Tk()
c = Canvas(root,width=200,height=100)
c.pack()
c.create_rectangle(50,20,150,80,dash=(4,4))
c.create_oval(50,20,150,80,fill = 'yellow')
mainloop()

然后，你想要绘制多边形，可以使用 create_polygon() 方法：

from tkinter import *
import math as m

root = Tk()

w = Canvas(root, width=200, height=100, background="red")
w.pack()

center_x = 100
center_y = 50
r = 50

points = [
    # 左上点
    center_x - int(r * m.sin(2 * m.pi / 5)),
    center_y - int(r * m.cos(2 * m.pi / 5)),
    # 右上点
    center_x + int(r * m.sin(2 * m.pi / 5)),
    center_y - int(r * m.cos(2 * m.pi / 5)),
    # 左下点
    center_x - int(r * m.sin(m.pi / 5)),
    center_y + int(r * m.cos(m.pi / 5)),
    # 顶点
    center_x,
    center_y - r,
    # 右下点
    center_x + int(r * m.sin(m.pi / 5)),
    center_y + int(r * m.cos(m.pi / 5)),
    ]

w.create_polygon(points, outline="green", fill="yellow")

mainloop()

4、绘制点

最后，不得不说有点遗憾的是 Tkinter并没有提供画“点”的方法。不过，我们可以通过绘制一个超小的椭圆形来表示一个“点”。下边例子中，通过响应“鼠标左键按住拖动”事件（<B1-Motion>），我们在鼠标拖动的同时获取鼠标的实时位置（x, y），并绘制一个超小的椭圆来代表一个“点”：

from tkinter import *
root = Tk()
c = Canvas(root,width=200,height=100)
c.pack()
def paint(event):
    x1,y1 = event.x-1,event.y-1
    x2, y2 = event.x + 1, event.y + 1
    c.create_oval(x1,y1,x2,y2,fill = 'black')

c.bind("<B1-Motion>",paint)
label = Label(root,text = '请移动鼠标绘制图形吧...')
label.pack(side = BOTTOM)
mainloop()

三、一些重要概念

1、Canvas 组件支持对象

arc（弧形、弦或扇形）
bitmap（内建的位图文件或 XBM 格式的文件）
image（BitmapImage 或 PhotoImage 的实例对象）
line（线）
oval（圆或椭圆形）
polygon（多边形）
rectangle（矩形）
text（文本）
window（组件）

其中，弦、扇形、椭圆形、圆形、多边形和矩形这些“封闭式”图形都是由轮廓线和填充颜色组成的，但都可以设置为透明（传入空字符串表示透明）。

2、坐标系

由于画布可能比窗口大（带有滚动条的 Canvas 组件），因此 Canvas 组件可以选择使用两种坐标系：
A.窗口坐标系：以窗口的左上角作为坐标原点
B.画布坐标系：以画布的左上角作为坐标原点

将窗口坐标系转换为画布坐标系，可以使用 canvasx()或 canvasy()方法：

def callback(event):
    canvas = event.widget
    x = canvas.canvasx(event.x)
    y = canvas.canvasy(event.y)
    print canvas.find_closest(x, y)

3、画布对象显示的顺序

Canvas 组件中创建的画布对象都会被列入显示列表中，越接近背景的画布对象位于显示列表的越下方。显示列表决定当两个画布对象重叠的时候是如何覆盖的（默认情况下新创建的会覆盖旧的画布对象的重叠部分，即位于显示列表上方的画布对象将覆盖下方那个）。当然，显示列表中的画布对象可以被重新排序。

4、指定画布对象

Canvas 组件提供几种方法让你指定画布对象：

1.Item handles
2.Tags
3.ALL
4.CURRENT

Item handles 事实上是一个用于指定某个画布对象的整型数字（也成为画布对象的 ID）。当你在 Canvas 组件上创建一个画布对象的时候，Tkinter 将自动为其指定一个在该Canvas组件中独一无二的整型值。然后各种Canvas的方法可以通过这个值操纵该画布对象。

Tags是附在画布对象上的标签，Tags 由普通的非空白字符串组成。一个画布对象可以与多个Tags 相关联，一个Tag 也可用于描述多个画布对象。然而，与 Text组件不同，没有指定画布对象的 Tags 不能进行事件绑定和配置样式。也就是说，Canvas 组件的Tags是仅为画布对象所拥有。
Canvas 组件预定义了两个 Tags：ALL 和CURRENT
ALL（或 "all"）表示Canvas 组件中的所有画布对象
CURRENT（或 "current"）表示鼠标指针下的画布对象（如果有的话）

四、参数

Canvas(master=None, **options) (class)

master -- 父组件
**options -- 组件选项，下方表格详细列举了各个选项的具体含义和用法：

五、方法

1、addtag(tag, method, *args)

-- 添加一个 Tag 到一系列画布对象中
-- 指定添加 Tag 的位置，可以是："above"，"all"，"below"，"closest"，"enclosed"，"overlapping" 或 "withtag"
-- args 是附加参数，请参考下方等同的方法

2、addtag_above(tag, item)

-- 为显示列表中 item 上方的画布对象添加 Tag
-- 该方法相当于 addtag(tag, "above", item)
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

3、addtag_all(tag)

-- 为 Canvas 组件中所有的画布对象添加 Tag
-- 该方法相当于 addtag(tag, "all")

4、addtag_below(tag, item)

-- 为显示列表中 item 下方的画布对象添加 Tag
-- 该方法相当于 addtag(tag, "below", item)
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

5、addtag_closest(tag, x, y, halo=None, start=None)

-- 将 Tag 添加到与给定坐标（x, y）相临近的画布对象
-- 可选参数 halo 指定一个距离，表示以（x, y）为中心，该距离内的所有画布对象均添加 Tag
-- 可选参数 start 指定一个画布对象，该方法将为低于但最接近该对象的画布对象添加 Tag
-- 该方法相当于 addtag(tag, "closet", x, y, halo=None, start=None)
-- 注1：使用的是画布坐标系
-- 注2：如果同时由几个画布对象与给定坐标（x, y）的距离相同，则为位于显示列表上方的那个画布对象添加 Tag

6、addtag_enclosed(tag, x1, y1, x2, y2)

-- 为所有坐标在矩形（x1, y1, x2, y2）中的画布对象添加 Tag
-- 该方法相当于 addtag(tag, "enclosed", x1, y1, x2, y2)

7、addtag_overlapped(tag, x1, y1, x2, y2)

-- 跟 addtag_enclosed() 方法相似，不过该方法范围更广（即使画布对象只有一部分在矩形中也算）
-- 该方法相当于 addtag(tag, "overlapping", x1, y1, x2, y2)

8、addtag_withtag(tag, item)

-- 为 item 参数指定的画布对象添加 Tag
-- item 参数如果指定一个 Tag，则为所有拥有此 Tag 的画布对象添加新的 Tag
-- item 参数如果指定一个画布对象，那么只为其添加 Tag
-- 该方法相当于 addtag(tag, "withtag", item)
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

9、bbox(*args)

-- 返回一个四元组（x1, y1, x2, y2）用于描述 args 指定的画布对象所在的矩形范围
-- 如果 args 参数忽略，返回所有的画布对象所在的矩形范围

10、canvasx(screenx, gridspacing=None)

-- 将窗口坐标系的 X 坐标（screenx）转化为画布坐标系
-- 如果提供 gridspacing 参数，则转换结果将为该参数的整数倍

11、canvasy(screeny, gridspacing=None)

-- 将窗口坐标系的 Y 坐标（screenx）转化为画布坐标系
-- 如果提供 gridspacing 参数，则转换结果将为该参数的整数倍

12、coords(*args)

-- 如果仅提供一个参数（画布对象），返回该画布对象的坐标 (x1, y1, x2, y2)
-- 你可以通过 coords(item, x1, y1, x2, y2) 来移动画布对象

13、create_arc(bbox, **options)

-- 根据 bbox (x1, y1, x2, y2) 创建一个扇形（PIESLICE）、弓形（CHORD）或弧形（ARC）
-- 新创建的画布对象位于显示列表的顶端
-- 创建成功后返回该画布对象的 ID
-- 下方表格列举了各个 options 选项的具体含义：

14、create_bitmap(position, **options)

-- 在 position 指定的位置（x, y）创建一个位图对象
-- 创建成功后返回该位图对象的 ID
-- 下方表格列举了各个 options 选项的具体含义：

15、create_image(position, **options)

-- 在 position 指定的位置（x, y）创建一个图片对象
-- 创建成功后返回该图片对象的 ID
-- 下方表格列举了各个 options 选项的具体含义：

16、create_line(coords, **options)

-- 根据 coords 给定的坐标创建一条或多条线段
-- 如果给定的坐标多余两个点，则会首尾相连变成一条折线
-- 创建成功后返回该画布对象的 ID
-- 下方表格列举了各个 options 选项的具体含义：

17、create_oval(bbox, **options)

-- 根据限定矩形 bbox 绘制一个椭圆
-- 新创建的画布对象位于显示列表的顶端
-- 创建成功后返回该画布对象的 ID
-- 下方表格列举了各个 options 选项的具体含义：

18、create_polygon(coords, **options)

-- 根据 coords 给定的坐标绘制一个多边形
-- 新创建的画布对象位于显示列表的顶端
-- 创建成功后返回该画布对象的 ID
-- 下方表格列举了各个 options 选项的具体含义：

19、create_rectangle(bbox, **options)

-- 根据限定矩形 bbox 绘制一个矩形
-- 新创建的画布对象位于显示列表的顶端
-- 创建成功后返回该画布对象的 ID
-- 下方表格列举了各个 options 选项的具体含义：

20、create_text(position, **options)

-- 在 position 指定的位置（x, y）创建一个文本对象
-- 创建成功后返回该文本对象的 ID
-- 下方表格列举了各个 options 选项的具体含义：

21、create_window(position, **options)

-- 在 position 指定的位置（x, y）创建一个窗口组件
-- 创建成功后返回该窗口组件的 ID
-- 下方表格列举了各个 options 选项的具体含义：

22、dchars(item, from, to=None)

-- 删除 item 中从 from 到 to（包含）参数中的字符串
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

23、delete(item)

-- 删除 item 参数指定的画布对象
-- 如果不存在 item 指定的画布对象，并不会产生错误
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

24、dtag(item, tag=None)

-- 在 item 参数指定的画布对象中删除指定的 tag
-- 如果 tag 参数被忽略，则删除指定画布对象所有的 tags
-- 如果不存在 item 指定的画布对象，并不会产生错误
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

25、find_above(item)

-- 返回在 item 参数指定的画布对象之上的 ID
-- 如果有多个画布对象符合要求，那么返回最顶端的那个
-- 如果 item 参数指定的是最顶层的画布对象，那么返回一个空元组
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

26、find_all()

-- 返回 Canvas 组件上所有的画布对象
-- 返回格式是一个元组，包含所有画布对象的 ID
-- 按照显示列表的顺序返回
-- 该方法相当于 find_withtag(ALL)

27、find_below(item)

-- 返回在 item 参数指定的画布对象之下的 ID
-- 如果有多个画布对象符合要求，那么返回最底端的那个
-- 如果 item 参数指定的是最底层的画布对象，那么返回一个空元组
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

28、find_closest(x, y, halo=None, start=None)

-- 返回一个元组，包含所有靠近点（x, y）的画布对象的 ID
-- 如果没有符合的画布对象，则返回一个空元组
-- 可选参数 halo 用于增加点（x, y）的辐射范围
-- 可选参数 start 指定一个画布对象，该方法仅返回在显示列表中低于但最接近的一个 ID
-- 注意，点（x, y）的坐标是采用画布坐标系来表示

29、find_enclosed(x1, y1, x2, y2)

-- 返回完全包含在限定矩形内所有画布对象的 ID

30、find_overlapping(x1, y1, x2, y2)

-- 返回所有与限定矩形有重叠的画布对象的 ID（让然也包含在限定矩形内的画布对象）

31、find_withtag(item)

-- 返回 item 指定的所有画布对象的 ID
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

32、focus(item=None)

-- 将焦点移动到指定的 item
-- 如果有多个画布对象匹配，则将焦点移动到显示列表中第一个可以接受光标输入的画布对象
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

33、gettags(item)

-- 返回与 item 相关联的所有 Tags
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

34、icursor(item, index)

-- 将光标移动到 item 指定的画布对象
-- 这里要求 item 指定的画布对象支持文本输入和转移焦点
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

35、index(item, index)

-- 返回 index 在指定 item 中的位置（沿用 Python 的惯例：0 表示第一）
-- index 参数可以是：INSERT（当前光标的位置），END（最后一个字符的位置），SEL_FIRST（当前选中文本的起始位置），SEL_LAST（当前选中文本的结束位置），还可以使用格式为 "@x, y"（x 和 y 是画布坐标系）来获得与此坐标最接近的位置
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

36、insert(item, index, text)

-- 在允许进行文本编辑的画布对象的指定位置插入文本
-- index 参数可以是：INSERT（当前光标的位置），END（最后一个字符的位置），SEL_FIRST（当前选中文本的起始位置），SEL_LAST（当前选中文本的结束位置），还可以使用格式为 "@x, y"（x 和 y 是画布坐标系）来获得与此坐标最接近的位置
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

37、itemcget(item, option)

-- 获得指定 item 的选项的当前值
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

38、itemconfig(item, **options)

-- 修改指定 item 的选项的当前值
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

39、itemconfigure(item, **options)

-- 跟 itemconfig() 一样

40、lift(item, **options)

-- 将指定画布对象移动到显示列表的顶部
-- item 可以是单个画布对象的 ID，也可以是某个 Tag
-- 跟 tag_raise 一样

41、lower(item, **options)

-- 将指定画布对象移动到显示列表的底部
-- item 可以是单个画布对象的 ID，也可以是某个 Tag
-- 跟 tag_lower 一样

42、move(item, dx, dy)

-- 将 item 移动到新位置（x, y）
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

43、postscript(**options)

-- 将 Canvas 的当前内容封装成 PostScript 格式（什么是 PostScript）表示
-- 下方表格列举了各个 options 选项的具体含义：

44、scale(item, xOrigin, yOrigin, xScale, yScale)

-- 缩放 item 指定的画布对象
-- xOrigin 和 yOrigin 决定要缩放的位置
-- xScale 和 yScale 决定缩放的比例
-- item 可以是单个画布对象的 ID，也可以是某个 Tag
-- 注意：该方法无法缩放 Text 画布对象

45、scan_dragto(x, y)

-- 见下方 scan_mark(x, y)

46、scan_mark(x, y)

-- 使用这种方式来实现 Canvas 内容的滚动
-- 需要将鼠标按钮事件及当前鼠标位置绑定到 scan_mark(x, y) 方法，然后再将 <motion> 事件及当前鼠标位置绑定到 scan_dragto(x, y) 方法，就可以实现 Canvas 在当前位置和 sacn_mack(x, y) 指定的位置 (x, y) 之间滚动

47、select_adjust(item, index)

-- 调整选中范围，使得给定的 index 参数指定的位置在范围内
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

48、select_clear()

-- 取消 Canvas 组件中所有选中的范围

49、select_from(item, index)

-- 调整选中范围的起始位置为 index 参数指定的位置
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

50、select_item()

-- 范围在 Canvas 组件中当前文本的选中范围
-- 如果没有则返回 None

51、select_to(item, index)

-- 调整选中范围的结束位置为 index 参数指定的位置

52、tag_bind(item, event=None, callback, add=None)

-- 为 Canvas 组件上的画布对象绑定方法
-- event 参数是绑定的事件名称，callback 是与之关联的方法
-- item 可以是单个画布对象的 ID，也可以是某个 Tag
-- 注意：与绑定事件关联的是画布对象，而不是 Tag

53、tag_lower(item)

-- 将一个或多个画布对象移至底部
-- 如果是多个画布对象，将它们都移至底部并保留原有顺序
-- item 可以是单个画布对象的 ID，也可以是某个 Tag
-- 注意：该方法对窗口组件无效，请使用 lower 代替

54、tag_raise(item)

-- 将一个或多个画布对象移至顶部
-- 如果是多个画布对象，将它们都移至顶部并保留原有顺序
-- item 可以是单个画布对象的 ID，也可以是某个 Tag
-- 注意：该方法对窗口组件无效，请使用 lift 代替

55、tag_unbind(item, event, callback=None)

-- 解除与 item 绑定的事件
-- item 可以是单个画布对象的 ID，也可以是某个 Tag

56、**tkraise(item, options)

-- 将指定画布对象移动到显示列表的顶部
-- item 可以是单个画布对象的 ID，也可以是某个 Tag
-- 跟 tag_raise 一样

57、type(item)

-- 返回指定画布对象的类型
-- 返回值可以是："arc", "bitmap", "image", "line", "oval", "polygon", "rectangle", "text", 或 "window"

58、xview(args)*

-- 该方法用于在水平方向上滚动 Canvas 组件的内容，一般通过绑定 Scollbar 组件的 command 选项来实现（具体操作参考：Scrollbar）
-- 如果第一个参数是 MOVETO，则第二个参数表示滚动到指定的位置：0.0 表示最左端，1.0 表示最右端
-- 如果第一个参数是 SCROLL，则第二个参数表示滚动的数量，第三个参数表示滚动的单位（可以是 UNITS 或 PAGES），例如：xview(SCROLL, 3, UNITS) 表示向右滚动三行

59、xview_moveto(fraction)

-- 跟 xview(MOVETO, fraction) 一样

60、xview_scroll(number, what)

-- 跟 xview(SCROLL, number, what) 一样

61、yview(args)*

-- 该方法用于在垂直方向上滚动 Canvas 组件的内容，一般通过绑定 Scollbar 组件的 command 选项来实现（具体操作参考：Scrollbar）
-- 如果第一个参数是 MOVETO，则第二个参数表示滚动到指定的位置：0.0 表示最顶端，1.0 表示最底端
-- 如果第一个参数是 SCROLL，则第二个参数表示滚动的数量，第三个参数表示滚动的单位（可以是 UNITS 或 PAGES），例如：yview(SCROLL, 3, PAGES) 表示向下滚动三页

62、yview_moveto(fraction)

-- 跟 yview(MOVETO, fraction) 一样

63、yview_scroll(number, what)

-- 跟 yview(SCROLL, number, what) 一样

https://fishc.com.cn/forum.php?mod=viewthread&tid=60116&extra=page%3D1%26filter%3Dtypeid%26typeid%3D604