Tkinter 组件详解（十二）：Canvas

青旅半醒 2022-04-02 14:54 831阅读 0赞

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

**何时使用 Canvas 组件？**

Canvas 是一个通用的组件，通常用于显示和编辑图形。你可以用它来绘制线段、圆形、多边形，甚至是绘制其它组件。

**用法**

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

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

![20181227085906965.png][]

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

import tkinter as tk
    
    root = tk.Tk()
    
    w = tk.Canvas(root, width =200, height = 100)
    w.pack()
    
    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)
    
    tk.Button(root, text = "删除全部", command = (lambda x = "all" : w.delete(x))).pack()
    
    root.mainloop()

![20181227090300111.png][]

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

import tkinter as tk
    
    root = tk.Tk()
    
    w = tk.Canvas(root, width =200, height = 100)
    w.pack()
    
    w.create_line(0, 0, 200, 100, fill = "green", width = 3)
    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 = "Python")
    
    root.mainloop()

![2018122709061293.png][]

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

import tkinter as tk
    
    root = tk.Tk()
    
    w = tk.Canvas(root, width =200, height = 100)
    w.pack()
    
    w.create_rectangle(40, 20, 160, 80, dash = (4, 4))
    w.create_oval(40, 20, 160, 80, fill = "pink")
    
    w.create_text(100, 50, text = "Python")
    
    root.mainloop()

![20181227090806578.png][]

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

import tkinter as tk
    import math
     
    root = tk.Tk()
     
    w = tk.Canvas(root, width = 200, height = 100, background = "red")
    w.pack()
     
    center_x = 100
    center_y = 50
    r = 50
     
    points = [
            #左上点（A）
            center_x - int(r * math.sin(2 * math.pi / 5)),
            center_y - int(r * math.cos(2 * math.pi / 5)),
            #右上点（C）
            center_x + int(r * math.sin(2 * math.pi / 5)),
            center_y - int(r * math.cos(2 * math.pi / 5)),
            #左下点（E）
            center_x - int(r * math.sin(math.pi / 5)),
            center_y + int(r * math.cos(math.pi / 5)),
            #顶点（B）
            center_x,
            center_y - r,
            #右下点（D）
            center_x + int(r * math.sin(math.pi / 5)),
            center_y + int(r * math.cos(math.pi / 5))
            ]
     
    w.create_polygon(points, outline = "green", fill = "yellow") #fill 默认是 black ，黑色填充
     
    root.mainloop()

![20181227091006910.png][]

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

import tkinter as tk
    
    root = tk.Tk()
    
    w = tk.Canvas(root, width = 400, height = 200)
    w.pack()
    
    def paint(event):
            x1, y1 = (event.x - 1), (event.y - 1)
            x2, y2 = (event.x + 1), (event.y + 1)
            w.create_oval(x1, y1, x2, y2, fill = "red")
    
    w.bind("<B1-Motion>", paint)
    
    tk.Label(root, text = "按住鼠标左键并移动，开始绘制你的理想蓝图吧……").pack(side = "bottom")
    
    root.mainloop()

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTU2MzE4_size_16_color_FFFFFF_t_70][]

--------------------

**以下概念我觉得你应该知道**

**Canvas 组件支持对象**

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

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

**坐标系**

由于画布可能比窗口大（带有滚动条的 Canvas 组件），因此 Canvas 组件可以选择使用两种坐标系：

*  窗口坐标系：以窗口的左上角作为坐标原点
 *  画布坐标系：以画布的左上角作为坐标原点

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

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

**画布对象显示的顺序**

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

**指定画布对象**

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

*  Item handles
 *  Tags
 *  "all"
 *  "current"

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

Tags 是附在画布对象上的标签，Tags 由普通的非空白字符串组成。一个画布对象可以与多个 Tags 相关联，一个 Tag 也可用于描述多个画布对象。然而，与 Text 组件不同，没有指定画布对象的 Tags 不能进行事件绑定和配置样式。也就是说，Canvas 组件的 Tags 是仅为画布对象所拥有。

Canvas 组件预定义了两个 Tags："all" 和 "current"  
  
 "all"  表示 Canvas 组件中的所有画布对象  
  
 "current"  表示鼠标指针下的画布对象（如果有的话）

**以上概念我觉得你应该知道**

--------------------

**参数**

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

master -- 父组件

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

<table> 
 <tbody> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><strong>选项</strong></td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;"><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">background</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">指定 Canvas 的背景颜色</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">bg</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">跟 background 一样</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">borderwidth</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">指定 Canvas 的边框宽度</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">bd</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">跟 borderwidth 一样</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">closeenough</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 指定一个距离，当鼠标与画布对象的距离小于该值时，鼠标被认为在画布对象上<br> 2. 该选项是一个浮点类型的值</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">confine</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 指定 Canvas 组件是否允许滚动超出 scrollregion 选项指定的范围<br> 2. 默认值是 True</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">cursor</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">指定当鼠标在 Canvas 上飘过的时候的鼠标样式</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">height</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 指定 Canvas 的高度<br> 2. 单位是像素</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">highlightbackground</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">指定当 Canvas 没有获得焦点的时候高亮边框的颜色</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">highlightcolor</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">指定当 Canvas 获得焦点的时候高亮边框的颜色</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">highlightthickness</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">指定高亮边框的宽度</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">relief</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 指定 Canvas 的边框样式<br> 2. 默认值是 "flat"<br> 3. 其他可以选择的值是 "sunken"，"raised"，"groove" 和 "ridge"</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">scrollregion</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 指定 Canvas 可以被滚动的范围<br> 2. 该选项的值是一个 4 元组（x1, y1, x2, y2）表示的矩形</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">selectbackground</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">指定当画布对象被选中时的背景色</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">selectborderwidth</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">指定当画布对象被选中时的边框宽度（选中边框）</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">selectforeground</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">指定当画布对象被选中时的前景色</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">state</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 设置 Canvas 的状态："normal" 或 "disabled"<br> 2. 默认值是 "normal"<br> 3. 注意：该值不会影响画布对象的状态</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">takefocus</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 指定使用 Tab 键可以将焦点移动到输入框中<br> 2. 默认是开启的，可以将该选项设置为 False 避免焦点在此输入框中</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">width</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 指定 Canvas 的宽度<br> 2. 单位是像素</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">xscrollcommand</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 与 scrollbar（滚动条）组件相关联（水平方向）<br> 2. 使用方法可以参考：<a href="https://blog.csdn.net/qq_41556318/article/details/85108366" rel="nofollow">Scrollbar 组件</a></td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">xscrollincrement</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 该选项指定 Canvas 水平滚动的“步长”<br> 2. 例如 '3c' 表示 3 厘米，还可以选择的单位有 'i'（英寸），'m'（毫米）和 'p'（DPI，大约是 '1i' 等于 '72p'）<br> 3. 默认值是 0，表示可以水平滚动到任意位置</td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">yscrollcommand</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 与 scrollbar（滚动条）组件相关联（垂直方向）<br> 2. 使用方法可以参考：<a href="https://blog.csdn.net/qq_41556318/article/details/85108366" rel="nofollow">Scrollbar 组件</a></td> 
  </tr> 
  <tr> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">yscrollincrement</td> 
   <td style="background-color:#ffffff;border-color:#e3edf5;">1. 该选项指定 Canvas 垂直滚动的“步长”<br> 2. 例如 '3c' 表示 3 厘米，还可以选择的单位有 'i'（英寸），'m'（毫米）和 'p'（DPI，大约是 '1i' 等于 '72p'）<br> 3. 默认值是 0，表示可以水平滚动到任意位置</td> 
  </tr> 
 </tbody> 
</table>

**方法**

**addtag(tag, method, \*args)**  
\-- 添加一个 Tag 到一系列画布对象中  
\-- 指定添加 Tag 的位置，可以是："above"，"all"，"below"，"closest"，"enclosed"，"overlapping" 或 "withtag"  
\-- args 是附加参数，请参考下方等同的方法  
  
**addtag\_above(tag, item)**  
\-- 为显示列表中 item 上方的画布对象添加 Tag  
\-- 该方法相当于 addtag(tag, "above", item)  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**addtag\_all(tag)**  
\-- 为 Canvas 组件中所有的画布对象添加 Tag  
\-- 该方法相当于 addtag(tag, "all")  
  
**addtag\_below(tag, item)**  
\-- 为显示列表中 item 下方的画布对象添加 Tag  
\-- 该方法相当于 addtag(tag, "below", item)  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**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  
  
**addtag\_enclosed(tag, x1, y1, x2, y2)**  
\-- 为所有坐标在矩形（x1, y1, x2, y2）中的画布对象添加 Tag  
\-- 该方法相当于 addtag(tag, "enclosed", x1, y1, x2, y2)  
  
**addtag\_overlapped(tag, x1, y1, x2, y2)**  
\-- 跟 addtag\_enclosed() 方法相似，不过该方法范围更广（即使画布对象只有一部分在矩形中也算）  
\-- 该方法相当于 addtag(tag, "overlapping", x1, y1, x2, y2)  
  
**addtag\_withtag(tag, item)**  
\-- 为 item 参数指定的画布对象添加 Tag  
\-- item 参数如果指定一个 Tag，则为所有拥有此 Tag 的画布对象添加新的 Tag  
\-- item 参数如果指定一个画布对象，那么只为其添加 Tag  
\-- 该方法相当于 addtag(tag, "withtag", item)  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**bbox(\*args)**  
\-- 返回一个四元组（x1, y1, x2, y2）用于描述 args 指定的画布对象所在的矩形范围  
\-- 如果 args 参数忽略，返回所有的画布对象所在的矩形范围  
  
**canvasx(screenx, gridspacing=None)**  
\-- 将窗口坐标系的 X 坐标（screenx）转化为画布坐标系  
\-- 如果提供 gridspacing 参数，则转换结果将为该参数的整数倍  
  
**canvasy(screeny, gridspacing=None)**  
\-- 将窗口坐标系的 Y 坐标（screenx）转化为画布坐标系  
\-- 如果提供 gridspacing 参数，则转换结果将为该参数的整数倍  
  
**coords(\*args)**  
\-- 如果仅提供一个参数（画布对象），返回该画布对象的坐标 (x1, y1, x2, y2)  
\-- 你可以通过 coords(item, x1, y1, x2, y2) 来移动画布对象  
  
**create\_arc(bbox, \*\*options)**  
  
\-- 根据 bbox (x1, y1, x2, y2) 创建一个扇形（"pieslice"）、弓形（"chord"）或弧形（"arc"）  
\-- 新创建的画布对象位于显示列表的顶端  
\-- 创建成功后返回该画布对象的 ID  
\-- 下方表格列举了各个 options 选项的具体含义：

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>activedash</td> 
   <td>当画布对象状态为 "active" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>activefill</td> 
   <td>当画布对象状态为 "active" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>activeoutline</td> 
   <td>当画布对象状态为 "active" 的时候，绘制轮廓线</td> 
  </tr> 
  <tr> 
   <td>activeoutlinestipple</td> 
   <td>当画布对象状态为 "active" 的时候，指定填充轮廓的位图</td> 
  </tr> 
  <tr> 
   <td>activestipple</td> 
   <td>当画布对象状态为 "active" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>activewidth</td> 
   <td>当画布对象状态为 "active" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>dash</td> 
   <td>1. 指定绘制虚线轮廓<br> 2. 该选项值是一个整数元组，元组中的元素分别代表短线的长度和间隔<br> 3. 例如 (3, 5) 代表 3 个像素的短线和 5 个像素的间隔</td> 
  </tr> 
  <tr> 
   <td>dashoffset</td> 
   <td>1. 指定虚线轮廓开始的偏移位置<br> 2. 例如当 dash=(5, 1, 2, 1)，dashoffset=3，则从 2 开始画虚线</td> 
  </tr> 
  <tr> 
   <td>disableddash</td> 
   <td>当画布对象状态为 "disabled" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>disabledfill</td> 
   <td>当画布对象状态为 "disabled" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>disabledoutline</td> 
   <td>当画布对象状态为 "disabled" 的时候，绘制轮廓线</td> 
  </tr> 
  <tr> 
   <td>disabledoutlinestipple</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定填充轮廓的位图</td> 
  </tr> 
  <tr> 
   <td>disabledstipple</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>disabledwidth</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>extent</td> 
   <td>1. 指定跨度（从 start 选项指定的位置开始到结束位置的角度）<br> 2. 默认值是 90.0</td> 
  </tr> 
  <tr> 
   <td>fill</td> 
   <td>1. 指定填充的颜色<br> 2. 空字符串表示透明</td> 
  </tr> 
  <tr> 
   <td>offset</td> 
   <td>1. 指定当点画模式时填充位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>outline</td> 
   <td>指定轮廓的颜色</td> 
  </tr> 
  <tr> 
   <td>outlineoffset</td> 
   <td>1. 指定当点画模式绘制轮廓时位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>outlinestipple</td> 
   <td>1. 当 outline 选项被设置时，该选项用于指定一个位图来填充边框<br> 2. 默认值是空字符串，表示黑色</td> 
  </tr> 
  <tr> 
   <td>start</td> 
   <td>指定起始位置的偏移角度</td> 
  </tr> 
  <tr> 
   <td>state</td> 
   <td>1. 指定该画布对象的状态<br> 2. 可以是 "normal"，"disabled"（不可用，不响应事件）和 "hidden"（隐藏）<br> 3. 默认值是 "normal"</td> 
  </tr> 
  <tr> 
   <td>stipple</td> 
   <td>1. 指定一个位图用于填充<br> 2. 默认值是空字符串，表示实心</td> 
  </tr> 
  <tr> 
   <td>style</td> 
   <td>1. 指定该方法创建的是扇形（"pieslice"）、弓形（"chord"）还是弧形（"arc"）<br> 2. 默认创建的是扇形</td> 
  </tr> 
  <tr> 
   <td>tags</td> 
   <td>为创建的画布对象添加标签</td> 
  </tr> 
  <tr> 
   <td>width</td> 
   <td>指定边框的宽度</td> 
  </tr> 
 </tbody> 
</table>

**create\_bitmap(position, \*\*options)**

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

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>activebackground</td> 
   <td>指定当位图对象状态为 "active" 时候的背景颜色</td> 
  </tr> 
  <tr> 
   <td>activebitmap</td> 
   <td>指定当位图对象状态为 "active" 时候填充的位图</td> 
  </tr> 
  <tr> 
   <td>activeforeground</td> 
   <td>指定当位图对象状态为 "active" 时候的前景颜色</td> 
  </tr> 
  <tr> 
   <td>anchor</td> 
   <td>1. 指定位图在 position 参数的相对位置<br> 2. "n", "ne", "e", "se", "s", "sw", "w", "nw", 或 "center" 来定位（ewsn代表东西南北，上北下南左西右东）<br> 3. 默认值是 "center"</td> 
  </tr> 
  <tr> 
   <td>background</td> 
   <td>1. 指定背景颜色<br> 2. 即在位图中值为 0 的点的颜色<br> 2. 空字符串表示透明</td> 
  </tr> 
  <tr> 
   <td>bitmap</td> 
   <td>指定显示的位图</td> 
  </tr> 
  <tr> 
   <td>disabledbackground</td> 
   <td>指定当位图对象状态为 "disabled" 时候的背景颜色</td> 
  </tr> 
  <tr> 
   <td>disabledbitmap</td> 
   <td>指定当位图对象状态为 "disabled" 时候填充的位图</td> 
  </tr> 
  <tr> 
   <td>disabledforeground</td> 
   <td>指定当位图对象状态为 "disabled" 时候的前景颜色</td> 
  </tr> 
  <tr> 
   <td>foreground</td> 
   <td>1. 指定前景颜色<br> 2. 即在位图中值为 1 的点的颜色</td> 
  </tr> 
  <tr> 
   <td>state</td> 
   <td>1. 指定该画布对象的状态<br> 2. 可以是 "normal"， "disabled" （不可用，不响应事件）和 "hidden"（隐藏）<br> 3. 默认值是 "normal"</td> 
  </tr> 
  <tr> 
   <td>tags</td> 
   <td>为创建的位图对象添加标签</td> 
  </tr> 
 </tbody> 
</table>

**create\_image(position, \*\*options)**

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

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>activeimage</td> 
   <td>指定当图片对象状态为 "active" 时候显示的图片</td> 
  </tr> 
  <tr> 
   <td>anchor</td> 
   <td>1. 指定位图在 position 参数的相对位置<br> 2. "n", "ne", "e", "se", "s", "sw", "w", "nw", 或 "center" 来定位（ewsn代表东西南北，上北下南左西右东）<br> 3. 默认值是 "center"</td> 
  </tr> 
  <tr> 
   <td>image</td> 
   <td>指定要显示的图片</td> 
  </tr> 
  <tr> 
   <td>disabledimage</td> 
   <td>指定当图片对象状态为 "disabled" 时候显示的图片</td> 
  </tr> 
  <tr> 
   <td>state</td> 
   <td>1. 指定该图片对象的状态<br> 2. 可以是 "normal"， "disabled" （不可用，不响应事件）和 "hidden"（隐藏）<br> 3. 默认值是 "normal"</td> 
  </tr> 
  <tr> 
   <td>tags</td> 
   <td>为创建的图片对象添加标签</td> 
  </tr> 
 </tbody> 
</table>

**create\_line(coords, \*\*options)**

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

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>activedash</td> 
   <td>当画布对象状态为 "active" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>activefill</td> 
   <td>当画布对象状态为 "active" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>activestipple</td> 
   <td>当画布对象状态为 "active" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>activewidth</td> 
   <td>当画布对象状态为 "active" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>arrow</td> 
   <td>1. 默认线段是不带箭头的<br> 2. 你可以通过设置该选项添加箭头到线段中<br> 3. "first" 表示添加箭头到线段开始的位置<br> 4. "last" 表示添加箭头到线段结束的位置<br> 5. "both" 表示两端均添加箭头</td> 
  </tr> 
  <tr> 
   <td>arrowshape</td> 
   <td>1. 用一个三元组 (a, b, c) 来指定箭头的形状<br> 2. a, b, c 分别代表箭头的三条边的长<br> 3. 默认值是 (8, 10, 3)</td> 
  </tr> 
  <tr> 
   <td>capstyle</td> 
   <td>1. 指定线段两端的样式<br> 2. 该选项的值可以是：<br> -- "butt"（线段的两段平切于起点和终点）<br> -- "projecting"（线段的两段在起点和终点的位置分别延长一半 width 选项设置的长度）<br> -- "round"（线段的两段在起点和终点的位置分别延长一半 width 选项设置的长度并以圆角绘制）<br> 3. 默认值是 "butt"<br> 4. 如果还不理解请看下方图解你就秒懂了~</td> 
  </tr> 
  <tr> 
   <td>dash</td> 
   <td>1. 绘制虚线<br> 2. 该选项值是一个整数元组，元组中的元素分别代表短线的长度和间隔<br> 3. 例如 (3, 5) 代表 3 个像素的短线和 5 个像素的间隔</td> 
  </tr> 
  <tr> 
   <td>dashoffset</td> 
   <td>1. 指定虚线开始的偏移位置<br> 2. 例如当 dash=(5, 1, 2, 1)，dashoffset=3，则从 2 开始画虚线</td> 
  </tr> 
  <tr> 
   <td>disableddash</td> 
   <td>当画布对象状态为 "disabled" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>disabledfill</td> 
   <td>当画布对象状态为 "disabled" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>disabledstipple</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>disabledwidth</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>fill</td> 
   <td>1. 指定填充的颜色<br> 2. 空字符串表示透明</td> 
  </tr> 
  <tr> 
   <td>joinstyle</td> 
   <td>1. 指定当绘制两个相邻线段之间接口的样式<br> 2. 该选项的值可以是：<br> -- "round"（以连接点为圆心，1/2 width 选项设置的长度为半径绘制圆角）<br> -- "bevel"（在连接点处对两线段的夹角平切）<br> -- "miter"（沿着两线段的夹角延伸至一个点）<br> 3. 默认值是 "round"<br> 4. 如果还不理解请看下方 create_line() 函数 joinstyle 选项的图解你就秒懂了~</td> 
  </tr> 
  <tr> 
   <td>offset</td> 
   <td>1. 指定当点画模式时填充位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>smooth</td> 
   <td>1. 该选项的值为 True 时，将绘制贝塞尔样条曲线代替线段（资料：<a href="https://baike.baidu.com/item/%E8%B4%9D%E5%A1%9E%E5%B0%94%E6%9B%B2%E7%BA%BF/1091769?fr=aladdin" rel="nofollow">戳我</a>&nbsp;:贝塞尔样条曲线）<br> 2. 默认值为 False</td> 
  </tr> 
  <tr> 
   <td>splinesteps</td> 
   <td>1. 当绘制贝塞尔样条曲线的时候，该选项指定由多少条折线来构成曲线<br> 2. 默认值是 12<br> 3. 只有当 smooth 选项为 True 时该选项才能生效</td> 
  </tr> 
  <tr> 
   <td>state</td> 
   <td>1. 指定该画布对象的状态<br> 2. 可以是 "normal"，"disabled"（不可用，不响应事件）和 "hidden"（隐藏）<br> 3. 默认值是 "nor,al"</td> 
  </tr> 
  <tr> 
   <td>stipple</td> 
   <td>1. 指定一个位图用于填充<br> 2. 默认值是空字符串，表示实心</td> 
  </tr> 
  <tr> 
   <td>tags</td> 
   <td>为创建的画布对象添加标签</td> 
  </tr> 
  <tr> 
   <td>width</td> 
   <td>指定边框的宽度</td> 
  </tr> 
 </tbody> 
</table>

有关 capstyle 和 joinstyle 选项的图解：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTU2MzE4_size_16_color_FFFFFF_t_70 1][]

**create\_oval(bbox, \*\*options)**

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

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>activedash</td> 
   <td>当画布对象状态为 "active" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>activefill</td> 
   <td>当画布对象状态为 "active" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>activeoutline</td> 
   <td>当画布对象状态为 "active" 的时候，绘制轮廓线</td> 
  </tr> 
  <tr> 
   <td>activeoutlinestipple</td> 
   <td>当画布对象状态为 "active" 的时候，指定填充轮廓的位图</td> 
  </tr> 
  <tr> 
   <td>activestipple</td> 
   <td>当画布对象状态为 "active" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>activewidth</td> 
   <td>当画布对象状态为 "active" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>dash</td> 
   <td>1. 指定绘制虚线轮廓<br> 2. 该选项值是一个整数元组，元组中的元素分别代表短线的长度和间隔<br> 3. 例如 (3, 5) 代表 3 个像素的短线和 5 个像素的间隔</td> 
  </tr> 
  <tr> 
   <td>dashoffset</td> 
   <td>1. 指定虚线轮廓开始的偏移位置<br> 2. 例如当 dash=(5, 1, 2, 1)，dashoffset=3，则从 2 开始画虚线</td> 
  </tr> 
  <tr> 
   <td>disableddash</td> 
   <td>当画布对象状态为 "disabled" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>disabledfill</td> 
   <td>当画布对象状态为 "disabled" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>disabledoutline</td> 
   <td>当画布对象状态为 "disabled" 的时候，绘制轮廓线</td> 
  </tr> 
  <tr> 
   <td>disabledoutlinestipple</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定填充轮廓的位图</td> 
  </tr> 
  <tr> 
   <td>disabledstipple</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>disabledwidth</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>fill</td> 
   <td>1. 指定填充的颜色<br> 2. 空字符串表示透明</td> 
  </tr> 
  <tr> 
   <td>offset</td> 
   <td>1. 指定当点画模式时填充位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>outline</td> 
   <td>指定轮廓的颜色</td> 
  </tr> 
  <tr> 
   <td>outlineoffset</td> 
   <td>1. 指定当点画模式绘制轮廓时位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>outlinestipple</td> 
   <td>1. 当 outline 选项被设置时，该选项用于指定一个位图来填充边框<br> 2. 默认值是空字符串，表示黑色</td> 
  </tr> 
  <tr> 
   <td>state</td> 
   <td>1. 指定该画布对象的状态<br> 2. 可以是 "normal"，"disabled"（不可用，不响应事件）和 "hidden"（隐藏）<br> 3. 默认值是 "normal"</td> 
  </tr> 
  <tr> 
   <td>stipple</td> 
   <td>1. 指定一个位图用于填充<br> 2. 默认值是空字符串，表示实心</td> 
  </tr> 
  <tr> 
   <td>tags</td> 
   <td>为创建的画布对象添加标签</td> 
  </tr> 
  <tr> 
   <td>width</td> 
   <td>指定边框的宽度</td> 
  </tr> 
 </tbody> 
</table>

**create\_polygon(coords, \*\*options)**

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

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>activedash</td> 
   <td>当画布对象状态为 "active" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>activefill</td> 
   <td>当画布对象状态为 "active" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>activeoutline</td> 
   <td>当画布对象状态为 "active" 的时候，绘制轮廓线</td> 
  </tr> 
  <tr> 
   <td>activeoutlinestipple</td> 
   <td>当画布对象状态为 "active" 的时候，指定填充轮廓的位图</td> 
  </tr> 
  <tr> 
   <td>activestipple</td> 
   <td>当画布对象状态为 "active" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>activewidth</td> 
   <td>当画布对象状态为 "active" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>dash</td> 
   <td>1. 指定绘制虚线轮廓<br> 2. 该选项值是一个整数元组，元组中的元素分别代表短线的长度和间隔<br> 3. 例如 (3, 5) 代表 3 个像素的短线和 5 个像素的间隔</td> 
  </tr> 
  <tr> 
   <td>dashoffset</td> 
   <td>1. 指定虚线轮廓开始的偏移位置<br> 2. 例如当 dash=(5, 1, 2, 1)，dashoffset=3，则从 2 开始画虚线</td> 
  </tr> 
  <tr> 
   <td>disableddash</td> 
   <td>当画布对象状态为 "disabled" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>disabledfill</td> 
   <td>当画布对象状态为 "disabled" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>disabledoutline</td> 
   <td>当画布对象状态为 "disabled" 的时候，绘制轮廓线</td> 
  </tr> 
  <tr> 
   <td>disabledoutlinestipple</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定填充轮廓的位图</td> 
  </tr> 
  <tr> 
   <td>disabledstipple</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>disabledwidth</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>fill</td> 
   <td>1. 指定填充的颜色<br> 2. 空字符串表示透明</td> 
  </tr> 
  <tr> 
   <td>joinstyle</td> 
   <td>1. 指定当绘制两个相邻线段之间接口的样式<br> 2. 该选项的值可以是：<br> -- "round"（以连接点为圆心，1/2 width 选项设置的长度为半径绘制圆角）<br> -- "bevel"（在连接点处对两线段的夹角平切）<br> -- "miter"（沿着两线段的夹角延伸至一个点）<br> 3. 默认值是 "round"<br> 4. 如果还不理解请看上方图解你就秒懂了~</td> 
  </tr> 
  <tr> 
   <td>offset</td> 
   <td>1. 指定当点画模式时填充位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>outline</td> 
   <td>指定轮廓的颜色</td> 
  </tr> 
  <tr> 
   <td>outlineoffset</td> 
   <td>1. 指定当点画模式绘制轮廓时位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>outlinestipple</td> 
   <td>1. 当 outline 选项被设置时，该选项用于指定一个位图来填充边框<br> 2. 默认值是空字符串，表示黑色</td> 
  </tr> 
  <tr> 
   <td>smooth</td> 
   <td>1. 该选项的值为 True 时，将绘制贝塞尔样条曲线代替线段（资料：<a href="https://baike.baidu.com/item/%E8%B4%9D%E5%A1%9E%E5%B0%94%E6%9B%B2%E7%BA%BF/1091769?fr=aladdin" rel="nofollow">戳我</a>&nbsp;:贝塞尔样条曲线）<br> 2. 默认值为 False</td> 
  </tr> 
  <tr> 
   <td>splinesteps</td> 
   <td>1. 当绘制贝塞尔样条曲线的时候，该选项指定由多少条折线来构成曲线<br> 2. 默认值是 12<br> 3. 只有当 smooth 选项为 True 时该选项才能生效</td> 
  </tr> 
  <tr> 
   <td>state</td> 
   <td>1. 指定该画布对象的状态<br> 2. 可以是 "normal"，"disabled"（不可用，不响应事件）和 "hidden"（隐藏）<br> 3. 默认值是 "normal"</td> 
  </tr> 
  <tr> 
   <td>stipple</td> 
   <td>1. 指定一个位图用于填充<br> 2. 默认值是空字符串，表示实心</td> 
  </tr> 
  <tr> 
   <td>tags</td> 
   <td>为创建的画布对象添加标签</td> 
  </tr> 
  <tr> 
   <td>width</td> 
   <td>指定边框的宽度</td> 
  </tr> 
 </tbody> 
</table>

**create\_rectangle(bbox, \*\*options)**

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

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>activedash</td> 
   <td>当画布对象状态为 "active" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>activefill</td> 
   <td>当画布对象状态为 "active" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>activeoutline</td> 
   <td>当画布对象状态为 "active" 的时候，绘制轮廓线</td> 
  </tr> 
  <tr> 
   <td>activeoutlinestipple</td> 
   <td>当画布对象状态为 "active" 的时候，指定填充轮廓的位图</td> 
  </tr> 
  <tr> 
   <td>activestipple</td> 
   <td>当画布对象状态为 "active" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>activewidth</td> 
   <td>当画布对象状态为 "active" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>dash</td> 
   <td>1. 指定绘制虚线轮廓<br> 2. 该选项值是一个整数元组，元组中的元素分别代表短线的长度和间隔<br> 3. 例如 (3, 5) 代表 3 个像素的短线和 5 个像素的间隔</td> 
  </tr> 
  <tr> 
   <td>dashoffset</td> 
   <td>1. 指定虚线轮廓开始的偏移位置<br> 2. 例如当 dash=(5, 1, 2, 1)，dashoffset=3，则从 2 开始画虚线</td> 
  </tr> 
  <tr> 
   <td>disableddash</td> 
   <td>当画布对象状态为 "disabled" 的时候，绘制虚线</td> 
  </tr> 
  <tr> 
   <td>disabledfill</td> 
   <td>当画布对象状态为 "disabled" 的时候，填充颜色</td> 
  </tr> 
  <tr> 
   <td>disabledoutline</td> 
   <td>当画布对象状态为 "disabled" 的时候，绘制轮廓线</td> 
  </tr> 
  <tr> 
   <td>disabledoutlinestipple</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定填充轮廓的位图</td> 
  </tr> 
  <tr> 
   <td>disabledstipple</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定填充的位图</td> 
  </tr> 
  <tr> 
   <td>disabledwidth</td> 
   <td>当画布对象状态为 "disabled" 的时候，指定边框的宽度</td> 
  </tr> 
  <tr> 
   <td>fill</td> 
   <td>1. 指定填充的颜色<br> 2. 空字符串表示透明</td> 
  </tr> 
  <tr> 
   <td>offset</td> 
   <td>1. 指定当点画模式时填充位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>outline</td> 
   <td>指定轮廓的颜色</td> 
  </tr> 
  <tr> 
   <td>outlineoffset</td> 
   <td>1. 指定当点画模式绘制轮廓时位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>outlinestipple</td> 
   <td>1. 当 outline 选项被设置时，该选项用于指定一个位图来填充边框<br> 2. 默认值是空字符串，表示黑色</td> 
  </tr> 
  <tr> 
   <td>state</td> 
   <td>1. 指定该画布对象的状态<br> 2. 可以是 "normal"， "disabled" （不可用，不响应事件）和 "hidden"（隐藏）<br> 3. 默认值是 "normal"</td> 
  </tr> 
  <tr> 
   <td>stipple</td> 
   <td>1. 指定一个位图用于填充<br> 2. 默认值是空字符串，表示实心</td> 
  </tr> 
  <tr> 
   <td>tags</td> 
   <td>为创建的画布对象添加标签</td> 
  </tr> 
  <tr> 
   <td>width</td> 
   <td>指定边框的宽度</td> 
  </tr> 
 </tbody> 
</table>

**create\_text(position, \*\*options)**

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

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>activefill</td> 
   <td>指定当文本对象状态为 "active" 时候文本的颜色</td> 
  </tr> 
  <tr> 
   <td>activestipple</td> 
   <td>指定当文本对象状态为 "active" 时候文本填充的位图</td> 
  </tr> 
  <tr> 
   <td>anchor</td> 
   <td> <p>1. 指定文本在 position 参数的相对位置<br> 2. "n", "ne", "e", "se", "s", "sw", "w", "nw", 或 "center" 来定位（ewsn代表东西南北，上北下南左西右东）<br> 3. 默认值是 "center"</p> </td> 
  </tr> 
  <tr> 
   <td>disabledfill</td> 
   <td>指定当文本对象状态为 "disabled" 时候文本的颜色</td> 
  </tr> 
  <tr> 
   <td>disabledstipple</td> 
   <td>指定当文本对象状态为 "disabled" 时候文本填充的位图</td> 
  </tr> 
  <tr> 
   <td>fill</td> 
   <td>指定文本的颜色</td> 
  </tr> 
  <tr> 
   <td>font</td> 
   <td>指定文本的字体、尺寸等信息</td> 
  </tr> 
  <tr> 
   <td>justify</td> 
   <td>1. 指定对于多行文本的对齐方式<br> 2. 该选项可以使用的值有："left"（默认）、"center" 和 "right"</td> 
  </tr> 
  <tr> 
   <td>offset</td> 
   <td>1. 指定当点画模式时填充位图的偏移<br> 2. 该选项的值可以是："x,y", "#x,y", "n", "ne", "e", "se", "s", "sw", "w", "nw", "center"</td> 
  </tr> 
  <tr> 
   <td>state</td> 
   <td>1. 指定该画布对象的状态<br> 2. 可以是 "normal"，"disabled"（不可用，不响应事件）和 "hidden"（隐藏）<br> 3. 默认值是 "normal"</td> 
  </tr> 
  <tr> 
   <td>stipple</td> 
   <td>1. 指定一个位图用于填充<br> 2. 默认值是空字符串，表示实心</td> 
  </tr> 
  <tr> 
   <td>tags</td> 
   <td>为创建的位图对象添加标签</td> 
  </tr> 
  <tr> 
   <td>text</td> 
   <td>指定该文本对象将要显示的文本内容</td> 
  </tr> 
  <tr> 
   <td>width</td> 
   <td>1. 如果指定该选项，则文本会在该宽度处自动断行<br> 2. 如果不指定该选项，文本对象的宽度等于文本最长行的长度</td> 
  </tr> 
 </tbody> 
</table>

**create\_window(position, \*\*options)**

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

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>anchor</td> 
   <td>1. 指定位图在 position 参数的相对位置<br> 2. "n", "ne", "e", "se", "s", "sw", "w", "nw", 或 "center" 来定位（ewsn代表东西南北，上北下南左西右东）<br> 3. 默认值是 "center"</td> 
  </tr> 
  <tr> 
   <td>height</td> 
   <td>指定窗口组件的高度</td> 
  </tr> 
  <tr> 
   <td>state</td> 
   <td>1. 指定该图片的状态<br> 2. 可以是 "normal"，"disabled"（不可用，不响应事件）和 "hidden"（隐藏）<br> 3. 默认值是 "normal"</td> 
  </tr> 
  <tr> 
   <td>tags</td> 
   <td>为创建的图片对象添加标签</td> 
  </tr> 
  <tr> 
   <td>width</td> 
   <td>指定窗口组件的宽度</td> 
  </tr> 
  <tr> 
   <td>window</td> 
   <td>指定一个窗口组件</td> 
  </tr> 
 </tbody> 
</table>

**dchars(item, from, to=None)**  
\-- 删除 item 中从 from 到 to（包含）参数中的字符串  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**delete(item)**  
\-- 删除 item 参数指定的画布对象  
\-- 如果不存在 item 指定的画布对象，并不会产生错误  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**dtag(item, tag=None)**  
\-- 在 item 参数指定的画布对象中删除指定的 tag  
\-- 如果 tag 参数被忽略，则删除指定画布对象所有的 tags  
\-- 如果不存在 item 指定的画布对象，并不会产生错误  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**find\_above(item)**  
\-- 返回在 item 参数指定的画布对象之上的 ID  
\-- 如果有多个画布对象符合要求，那么返回最顶端的那个  
\-- 如果 item 参数指定的是最顶层的画布对象，那么返回一个空元组  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**find\_all()**  
\-- 返回 Canvas 组件上所有的画布对象  
\-- 返回格式是一个元组，包含所有画布对象的 ID  
\-- 按照显示列表的顺序返回  
\-- 该方法相当于 find\_withtag("all")  
  
**find\_below(item)**  
\-- 返回在 item 参数指定的画布对象之下的 ID  
\-- 如果有多个画布对象符合要求，那么返回最底端的那个  
\-- 如果 item 参数指定的是最底层的画布对象，那么返回一个空元组  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**find\_closest(x, y, halo=None, start=None)**  
\-- 返回一个元组，包含所有靠近点（x, y）的画布对象的 ID  
\-- 如果没有符合的画布对象，则返回一个空元组  
\-- 可选参数 halo 用于增加点（x, y）的辐射范围  
\-- 可选参数 start 指定一个画布对象，该方法仅返回在显示列表中低于但最接近的一个 ID  
\-- 注意，点（x, y）的坐标是采用画布坐标系来表示  
  
**find\_enclosed(x1, y1, x2, y2)**  
\-- 返回完全包含在限定矩形内所有画布对象的 ID  
  
**find\_overlapping(x1, y1, x2, y2)**  
\-- 返回所有与限定矩形有重叠的画布对象的 ID（让然也包含在限定矩形内的画布对象）  
  
**find\_withtag(item)**  
\-- 返回 item 指定的所有画布对象的 ID  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**focus(item=None)**  
\-- 将焦点移动到指定的 item  
\-- 如果有多个画布对象匹配，则将焦点移动到显示列表中第一个可以接受光标输入的画布对象  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**gettags(item)**  
\-- 返回与 item 相关联的所有 Tags  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**icursor(item, index)**  
\-- 将光标移动到 item 指定的画布对象  
\-- 这里要求 item 指定的画布对象支持文本输入和转移焦点  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**index(item, index)**  
\-- 返回 index 在指定 item 中的位置（沿用 Python 的惯例：0 表示第一）  
\-- index 参数可以是："insert"（当前光标的位置），"end"（最后一个字符的位置），"sel\_first"（当前选中文本的起始位置），"sel\_last"（当前选中文本的结束位置），还可以使用格式为 "@x, y"（x 和 y 是画布坐标系）来获得与此坐标最接近的位置  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**insert(item, index, text)**  
\-- 在允许进行文本编辑的画布对象的指定位置插入文本  
\-- index 参数可以是："insert"（当前光标的位置），"end"（最后一个字符的位置），"sel\_first"（当前选中文本的起始位置），"sel\_last"（当前选中文本的结束位置），还可以使用格式为 "@x, y"（x 和 y 是画布坐标系）来获得与此坐标最接近的位置  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**itemcget(item, option)**  
\-- 获得指定 item 的选项的当前值  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**itemconfig(item, \*\*options)**  
\-- 修改指定 item 的选项的当前值  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**itemconfigure(item, \*\*options)**  
\-- 跟 itemconfig() 一样  
  
**lift(item, \*\*options)**  
\-- 将指定画布对象移动到显示列表的顶部  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
\-- 跟 tag\_raise 一样  
  
**lower(item, \*\*options)**  
\-- 将指定画布对象移动到显示列表的底部  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
\-- 跟 tag\_lower 一样  
  
**move(item, dx, dy)**  
\-- 将 item 移动到新位置（x, y）  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**postscript(\*\*options)**  
\-- 将 Canvas 的当前内容封装成 PostScript 格式（[什么是 PostScript][PostScript]）表示  
\-- 下方表格列举了各个 options 选项的具体含义：

<table> 
 <tbody> 
  <tr> 
   <td><strong>选项</strong></td> 
   <td><strong>含义</strong></td> 
  </tr> 
  <tr> 
   <td>colormode</td> 
   <td>该选项的值可以是：'color'（颜色输出），'gray'（灰阶输出）和 'mono'（黑白输出）</td> 
  </tr> 
  <tr> 
   <td>file</td> 
   <td>1. 该选项指定一个文件，将 PostScript 写入该文件中<br> 2. 如果忽略该选项，PostScript 将以字符串的形式返回</td> 
  </tr> 
  <tr> 
   <td>height</td> 
   <td>1. 指定要打印的 Canvas 组件的高度<br> 2. 默认值是 Canvas 组件的整体高度</td> 
  </tr> 
  <tr> 
   <td>rotate</td> 
   <td>1. 如果该选项的值为 False，该页面将以纵向呈现<br> 2. 如果该选项的值为 True，该页面将以横向呈现</td> 
  </tr> 
  <tr> 
   <td>x</td> 
   <td>开始打印的最左边位置，以画布坐标系表示</td> 
  </tr> 
  <tr> 
   <td>y</td> 
   <td>开始打印的最顶端位置，以画布坐标系表示</td> 
  </tr> 
  <tr> 
   <td>width</td> 
   <td>1. 指定要打印的 Canvas 组件的宽度<br> 2. 默认值是 Canvas 组件的整体宽度</td> 
  </tr> 
 </tbody> 
</table>

**scale(item, xOrigin, yOrigin, xScale, yScale)**  
\-- 缩放 item 指定的画布对象  
\-- xOrigin 和 yOrigin 决定要缩放的位置  
\-- xScale 和 yScale 决定缩放的比例  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
\-- 注意：该方法无法缩放 Text 画布对象  
  
**scan\_dragto(x, y)**  
\-- 见下方 scan\_mark(x, y)  
  
**scan\_mark(x, y)**  
\-- 使用这种方式来实现 Canvas 内容的滚动  
\-- 需要将鼠标按钮事件及当前鼠标位置绑定到 scan\_mark(x, y) 方法，然后再将 <motion> 事件及当前鼠标位置绑定到 scan\_dragto(x, y) 方法，就可以实现 Canvas 在当前位置和 sacn\_mack(x, y) 指定的位置 (x, y) 之间滚动  
  
**select\_adjust(item, index)**  
\-- 调整选中范围，使得给定的 index 参数指定的位置在范围内  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**select\_clear()**  
\-- 取消 Canvas 组件中所有选中的范围  
  
**select\_from(item, index)**  
\-- 调整选中范围的起始位置为 index 参数指定的位置  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**select\_item()**  
\-- 范围在 Canvas 组件中当前文本的选中范围  
\-- 如果没有则返回 None  
  
**select\_to(item, index)**  
\-- 调整选中范围的结束位置为 index 参数指定的位置  
  
**tag\_bind(item, event=None, callback, add=None)**  
\-- 为 Canvas 组件上的画布对象绑定方法  
\-- event 参数是绑定的事件名称，callback 是与之关联的方法  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
\-- 注意：与绑定事件关联的是画布对象，而不是 Tag  
  
**tag\_lower(item)**  
\-- 将一个或多个画布对象移至底部  
\-- 如果是多个画布对象，将它们都移至底部并保留原有顺序  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
\-- 注意：该方法对窗口组件无效，请使用 lower 代替  
  
**tag\_raise(item)**  
\-- 将一个或多个画布对象移至顶部  
\-- 如果是多个画布对象，将它们都移至顶部并保留原有顺序  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
\-- 注意：该方法对窗口组件无效，请使用 lift 代替  
  
**tag\_unbind(item, event, callback=None)**  
\-- 解除与 item 绑定的事件  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
  
**tkraise(item, \*\*options)**  
\-- 将指定画布对象移动到显示列表的顶部  
\-- item 可以是单个画布对象的 ID，也可以是某个 Tag  
\-- 跟 tag\_raise 一样  
  
**type(item)**  
\-- 返回指定画布对象的类型  
\-- 返回值可以是："arc", "bitmap", "image", "line", "oval", "polygon", "rectangle", "text", 或 "window"  
  
**xview(\*args)**  
\-- 该方法用于在水平方向上滚动 Canvas 组件的内容，一般通过绑定 Scollbar 组件的 command 选项来实现（具体操作参考：[Scrollbar][]）  
\-- 如果第一个参数是 "moveto"，则第二个参数表示滚动到指定的位置：0.0 表示最左端，1.0 表示最右端  
\-- 如果第一个参数是 "scroll"，则第二个参数表示滚动的数量，第三个参数表示滚动的单位（可以是 "units" 或 "pages"），例如：xview("scroll", 3, "units") 表示向右滚动三行  
  
**xview\_moveto(fraction)**  
\-- 跟 xview("moveto", fraction) 一样  
  
**xview\_scroll(number, what)**  
\-- 跟 xview("scroll", number, what) 一样  
  
**yview(\*args)**  
\-- 该方法用于在垂直方向上滚动 Canvas 组件的内容，一般通过绑定 Scollbar 组件的 command 选项来实现（具体操作参考：[Scrollbar][]）  
\-- 如果第一个参数是 "moveto"，则第二个参数表示滚动到指定的位置：0.0 表示最顶端，1.0 表示最底端  
\-- 如果第一个参数是 "scroll"，则第二个参数表示滚动的数量，第三个参数表示滚动的单位（可以是 "units" 或 "pages"），例如：yview("scroll", 3, "pages") 表示向下滚动三页  
  
**yview\_moveto(fraction)**  
\-- 跟 yview("moveto", fraction) 一样  
  
**yview\_scroll(number, what)**  
\-- 跟 yview("scroll", number, what) 一样

[20181227085906965.png]: /images/20220402/1a70db678508494fb30d3cf9a3bb7dd3.png
[20181227090300111.png]: /images/20220402/b7cd9a43ef09464287b4942ccf112f2f.png
[2018122709061293.png]: /images/20220402/afd214f9611a4773880f072691bc3c28.png
[20181227090806578.png]: /images/20220402/e749f9ed0aaa4f339092d53919aa1961.png
[20181227091006910.png]: /images/20220402/93a640a7292f4c2d8f08cd5e2a1765a2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTU2MzE4_size_16_color_FFFFFF_t_70]: /images/20220402/3ff9ecc2aa954e75995e6f585264b5c8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxNTU2MzE4_size_16_color_FFFFFF_t_70 1]: /images/20220402/2c9feae621aa43c58f7c8ad9e96c6c69.png
[PostScript]: http://baike.baidu.com/view/121488.htm
[Scrollbar]: https://blog.csdn.net/qq_41556318/article/details/85108366