分组 Canvas 的画图函数

在 tkinter 中的 Canvas 有十分强大的作图功能，然而，并没有一份比较好的文档对这些作图函数进行分组，极大地限制了函数的使用。本文将这些作图函数分为如下几组：

graph = {'create_arc', 'create_line', 'create_oval', 'create_rectangle', 'create_polygon'}
image = {'create_bitmap', 'create_image'}
text = {'create_text'}
window = {'create_window'}

下面逐一介绍这些函数之间的参数的区别与联系。

1 通用参数

1.1 通用：graph + image + text + window

graph + image + text + window 共同的参数有：

1.2 “width”：graph + text + window

graph、text 与 window 的共有参数是 "width"，但是它们的含义有所区别：

1.3 graph + text

graph 与 text 均有参数：activefill, activestipple, disabledfill, disabledstipple， offset, stipple。

1. activefill, activestipple 分别表示当画布对象状态为 'active' 的时候，填充颜色、指定填充的位图
2. disabledfill, disabledstipple 分别表示当画布对象状态为 'disabled' 的时候，填充颜色、指定填充的位图

一个实例：

from tkinter import Tk, Canvas
# 创建窗口
root = Tk()
# 创建并添加Canvas
cv = Canvas(root, background='white')
cv.pack(fill='both', expand='yes')
cv.create_rectangle(30, 30, 200, 200,
outline='red', # 边框颜色
stipple = 'question', # 填充的位图
fill="red", # 填充颜色
width=5 # 边框宽度
)
cv.create_oval(240, 30, 330, 200,
outline='yellow', # 边框颜色
fill='pink', # 填充颜色
width=4 # 边框宽度
)
root.mainloop()

效果图如下：

1.4 image + text + window

1.5 graph 通用

1. activedash, activewidth， activeoutline, activeoutlinestipple 分别表示当画布对象状态为 'active' 的时候，绘制虚线、指定边框的宽度、绘制轮廓线、指定填充轮廓的位图。
2. disableddash, disabledwidth， disabledoutline, disabledoutlinestipple 分别表示当画布对象状态为 'disabled' 的时候，绘制虚线、指定边框的宽度、绘制轮廓线、指定填充轮廓的位图。

1.6 graph - {'create_line'}

1.7 {'create_polygon', create_line''}

调用：create_polygon(coords,**kw) 与 create_line(coords, **kw)

2 create_window(position, **kw)

在 position 指定的位置 $(x,y)$ 创建一个窗口组件。创建成功后返回该窗口组件的 ID。

下方表格列举了 kw 选项的具体含义：

3 create_image(position, **kw)

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

4 create_bitmap(position, **kw)

在 position 指定的位置 $(x,y)$ 创建一个位图对象。创建成功后返回该位图对象的 ID。

activebackground, activebitmap, activeforeground 分别指定当位图对象状态为 'active' 时候的背景颜色、填充的位图、前景颜色；disabledbackground, disabledbitmap, disabledforeground 分别指定当位图对象状态为 'disabled' 时候的背景颜色、填充的位图、前景颜色。

下方表格列举了各个 kw 其他选项的具体含义：

5 create_text(position,**kw)

在 position 指定的位置 $(x,y)$ 创建一个文本对象。创建成功后返回该文本对象的 ID。

下方表格列举了各个 kw 选项的具体含义：

anchor 同 create_bitmap(position, **kw)。

6 形态各异 graph

6.1 create_rectangle(bbox,**kw) 与 create_oval(bbox,**kw)傻傻分不清

create_oval(bbox,**kw) 与 create_rectangle(bbox,**kw) 分别用于创建矩形和椭圆。新创建的画布对象位于显示列表的顶端，创建成功后返回该画布对象的 ID。

6.2 create_arc(bbox, **kw)

根据 bbox 即 (x0,y0,x1,y1)(x_0,y_0, x_1, y_1)(x0​,y0​,x1​,y1​) 创建一个扇形（‘pieslice’）、弓形（‘chord’）或弧形（‘arc’）。新创建的画布对象位于显示列表的顶端，创建成功后返回该画布对象的 ID。下方表格列举了各个 kw 选项的具体含义：

6.3 create_line(coords, **kw)

根据 coords 给定的坐标创建一条或多条线段。如果给定的坐标多于两个点，则会首尾相连变成一条折线，创建成功后返回该画布对象的 ID。

下方表格列举了各个 kw 选项的具体含义：