最近博主在 CSDN 上看到許多關于海龜畫圖的案例，如畫圣誕樹、五角星等，但是都是直接給出了原始碼以及一些簡單的注釋，沒有對其詳細的說明，會讓很多初學者迷糊很久，故這里博主詳細地對 turtle 模塊中的方法進行詳解，讓廣大博友能夠做到自由畫圖，

海龜繪圖是 Python 內置的一個比較有趣的模塊，模塊名稱為 turtle，它最初源于 20世紀60年代 的 Logo 語言，之后成為了 Python 的內置模塊，海龜繪圖提供了一些簡單的繪圖方法，可以根據撰寫的控制指令(代碼)，讓一個 “海龜” 在螢屏上來回移動，而且可以在它爬行的路徑上繪制圖形，通過海龜繪圖，不僅可以在螢屏上繪制圖形，還可以看到整個繪制程序，另外，海龜繪圖對初學者十分友好，它能夠輕松地撰寫出很多有趣的實體，

一、輸入/輸出文字

在海龜繪圖中，也可以輸入或者輸出文字，下面分別進行介紹，

1. 輸出文字

輸出文字可以使用 write() 方法來實作，語法如下：

def write(self, arg, move=False, align="left", font=("Arial", 8, "normal"))

引數說明：

1. arg：必選引數，用于指定要輸出的文字內容，該內容會輸出到當前海龜游標的所在位置，
2. move：可選引數，用于指定是否移影片筆到文本的右下角，默認為False (不移動)，
3. align：可選引數，用于指定文字的對齊方式，其引數值為left（居左）、center（居中）或者right（居右）中的任意一個，默認為 left，
4. font：可選引數，用于指定字體、字號和字形，通過一個三元組(字體,字號,字形)指定，

說明：字形可設定的值為normal（表示正常）、bold（粗體）、italic（斜體）、underline（下劃線）等，例如，在螢屏中心輸出文字 命運給予我們的不是失望之酒，而是機會之杯，，指定字體為宋體，字號為18，字形為normal（表示正常），代碼如下：

# -*- coding: UTF-8 -*-
"""
@author:AmoXiang
@file:12.輸出文字.py
@time:2020/12/30
"""
import turtle  # 匯入海龜繪圖模塊

turtle.color("green")  # 填充顏色
turtle.up()  # 抬筆
turtle.goto(-300, 50)
turtle.down()  # 落筆
turtle.write("命運給與我們的不是失望之酒，而是機會之杯，", font=("宋體", 18, "normal"))
turtle.done()  # 海龜繪圖程式的結束陳述句（開始主回圈）

運行上面的代碼，將顯示下圖所示的效果，

從上圖中可以看出，輸出文字時，海龜游標并沒有移動，如果將write() 方法修改為以下代碼：

turtle.write("命運給與我們的不是失望之酒，而是機會之杯，", True, font=("宋體", 18, "normal"))

再次運行結果，將顯示下圖所示的效果：

2. 輸入文字

在海龜繪圖中，如果想與用戶互動，獲取用戶輸入的文字，可以通過 textinput() 方法彈出一個輸入對話框來實作，該方法的回傳值為字串型別，textinput() 方法的語法如下：

def textinput(self, title, prompt):

引數說明：

1. title：用于指定對話框的標題，顯示在標題欄上，
2. prompt：用于指定對話框的提示文字，提示要輸入的資訊，3. 回傳值：回傳輸入的字串，如果對話框被取消則回傳 None，

例如，先彈出輸入對話框，要求用戶輸入一段文字，然后輸出到螢屏上，代碼如下：

# -*- coding: UTF-8 -*-
"""
@author:AmoXiang
@file:13.輸入文字.py
@time:2020/12/30
"""
import turtle  # 匯入海龜繪圖模塊

turtle.color("green")  # 填充顏色
word = turtle.textinput("溫馨提示：", "請輸入要列印的文字")  # 彈出輸入對話框
turtle.write(word, True, font=("宋體", 18, "italic"))  # 輸出文字
turtle.done()  # 海龜繪圖程式的結束陳述句(開始主回圈)

通過 textinput() 方法回傳的內容為字串，如果想要輸入數值，可以使用 numinput() 方法實作，該方法的回傳值為浮點型別，numinput() 方法的語法如下：

def numinput(self, title, prompt, default=None, minval=None, maxval=None):

引數說明：

1. title：必選引數，用于指定對話框的標題，顯示在標題欄上，
2. prompt：必選引數，用于指定對話框的提示文字，提示要輸入什么資訊，
3. default：可選引數，用于指定一個默認數值，
4. minval：可選引數，用于指定可輸入的最小數值，
5. maxval :可選引數，用于指定可輸入的最大數值，

例如，先彈出輸入對話框，要求用戶輸入一個 1~9 之間的數，然后輸出到螢屏上，代碼如下：

import turtle  # 匯入海龜繪圖模塊

turtle.color("green")  # 填充顏色
# 數字輸入框
num = turtle.numinput("溫馨提示：", "請輸入1~9之間的數字：", default=1, minval=1, maxval=9)
turtle.write(num, True, font=("宋體", 18, "normal"))  # 輸出獲取的數字
turtle.done()  # 海龜繪圖程式的結束陳述句(開始主回圈)

二、滑鼠與鍵盤互動設計

在海龜繪圖中，也支持與滑鼠或鍵盤的互動操作，它提供了監聽鍵盤按鍵事件、滑鼠事件以及定時器等方法，下面分別進行介紹，

1. 鍵盤事件

海龜繪圖中提供了對鍵盤事件進行監聽的方法，在執行鍵盤事件監聽時，需要呼叫 listen() 方法，該方法用于讓海龜螢屏（TurtleScreen）可以獲得焦點，為接收鍵盤事件做好準備，呼叫listen() 方法的代碼如下：

turtle.listen()

海龜繪圖中的鍵盤事件主要有以下兩個：onkey() | onkeyrelease()：當按鍵被按下并釋放時發生，語法如下：

def onkey(self, fun, key):
def onkeyrelease(self, fun, key):

引數說明：

1. fun：必選引數，表示一個無引數的函式，用于指定當按下并釋放指定按鍵時，執行的函式，也可以指定為 None，表示什么都不做，
2. key：必選引數，表示被按下的鍵對應的字串，如 a 或 space，當指定 a 時，表示當按下并釋放 <a> 鍵時執行 fun 引數所指定的函式，

例如，當按下并釋放鍵盤上的 <w> 鍵時，海龜向上移動 100 像素，代碼如下：

# -*- coding: UTF-8 -*-
"""
@author:AmoXiang
@file:15.鍵盤事件.py
@time:2020/12/30
"""

import turtle


def move():
    turtle.left(90)
    turtle.forward(100)


turtle.listen()
turtle.onkey(move, "w")
turtle.done()

onkeypress()：當按鍵被按下(不釋放)時發生，語法如下：

def onkeypress(self, fun, key=None):

引數說明：

1. fun：表示一個無引數的函式，用于指定當按下（不釋放）指定按鍵時，執行的函式，也可以指定為 None，表示什么都不做，
2. key：可選引數，表示被按下的鍵對應的字串，如a 或 space，當指定 a 時，表示當按下（不釋放）<a> 鍵時執行 fun 引數所指定函式，如果未指定，則移除事件系結，

例如，當一直按下（不釋放）鍵盤上的 ↑ 鍵時，讓海龜一直向前移動，釋放按鍵即停止移動，代碼如下：

import turtle


def move():
    turtle.forward(2)


turtle.listen()
turtle.onkeypress(move, "Up")
turtle.done()

運行上面的代碼，當一直按下(不釋放) 鍵盤上的 ↑ 鍵時，海龜將一直向前移動，

2. 滑鼠事件

在海龜繪圖中提供了對滑鼠事件進行監聽的方法，海龜繪圖中的滑鼠事件主要有以下 3 個：
(1) onclick() | onscreenclick()：表示處理滑鼠點擊螢屏事件，語法如下：

turtle.getscreen().onclick(self, fun, btn=1, add=None):
turtle.onscreenclick(fun, btn=1, add=None)

1. fun：表示一個函式，用于指定當滑鼠按鍵被按下時執行的函式，該函式呼叫時將傳入兩個引數，表示在螢屏上點擊位置的坐標，所以指定的函式需要帶有兩個引數，
2. btn：滑鼠按鍵編號，默認值為1（滑鼠左鍵)、2 (滑鼠中鍵，即按下滑輪)、3（滑鼠右鍵），
3. add：一個布林值，表示是否添加新系結，如果為True，則添加一個新系結，否則將取代先前的系結，
4. 說明：如果將 fun 引數設定為 None，則將移除事件系結，

2.1 獲取滑鼠點擊的位置

當使用滑鼠左鍵點擊螢屏時，顯示點擊位置的坐標，代碼如下：

# -*- coding: UTF-8 -*-
"""
@author:AmoXiang
@file:16.滑鼠事件.py
@time:2020/12/30
"""

import turtle


def click(x, y):
    turtle.clear()
    turtle.write((x, y), font=("宋體", 18, "normal"))


turtle.onscreenclick(click, 1)
turtle.done()

onclick() 方法也可以作為海龜物件的方法，例如，下面的代碼將實作在單擊螢屏中的海龜時，顯示當前的坐標位置：

import turtle

t = turtle.Turtle()
t.shape("turtle")


def click(x, y):
    turtle.clear()
    turtle.write((x, y), font=("宋體", 15, "normal"))


t.onclick(click, 1)
turtle.done()

運行上面的代碼，只在單擊螢屏上的小海龜時，才會顯示當前的坐標位置，
(2) onrelease()：該方法為海龜物件的方法，表示處理滑鼠釋放事件語法如下：

turtle.onrelease(self, fun, btn=1, add=None):

引數說明：

1. fun：表示一個事件觸發時執行的函式，該函式呼叫時將傳入兩個引數表示釋放滑鼠按鍵時滑鼠位置的坐標，所以指定的函式需要帶有兩個引數，
2. btn：滑鼠按鍵編號，默認值為1(滑鼠左鍵)、2(滑鼠中鍵，即按下滑輪)、3(滑鼠右鍵)，
3. add：一個布林值，表示是否添加新系結，如果為True，則添加一個新系結，否則將取代先前的系結，

例如，創建一個海龜物件，當用戶在海龜物件上按下滑鼠左鍵并釋放時顯示釋放時滑鼠位置的坐標，代碼如下：

import turtle

t = turtle.Turtle()
t.shape("turtle")


def fun(x, y):
    turtle.clear()
    turtle.write((x, y), font=("宋體", 15, "normal"))


t.onrelease(fun, 1)
turtle.done()

(3) ondrag()：表示處理滑鼠拖動事件，語法如下：

def ondrag(self, fun, btn=1, add=None):

引數說明：

1. fun：表示按住滑鼠左鍵并拖動時執行的函式，該函式呼叫時將傳入兩個引數表示釋放滑鼠按鍵時滑鼠位置的坐標，所以指定的函式需要帶有兩個引數，
2. btn：滑鼠按鍵編號，默認值為1(滑鼠左鍵)、2(滑鼠中鍵，即按下滑輪)、3(滑鼠右鍵)，
3. add：一個布林值，表示是否添加新系結，如果為True，則添加一個新系結，否則將取代先前的系結，
4. 說明：當畫筆為落筆狀態時，在海龜物件上單擊并拖動海龜可在螢屏上手繪線條，

例如，創建一個海龜物件，并且為該物件添加拖動事件，實作拖動螢屏中的海龜時，在螢屏上手繪線條，代碼如下：

import turtle

t = turtle.Turtle()
t.shape("turtle")
t.color("blue")
turtle.listen()


def fun(x, y):
    t.pendown()
    t.goto(x, y)


t.ondrag(fun, 1)
turtle.done()

3. 計時器

在海龜繪圖中，提供了 ontimer() 方法來實作一個計時器，用于達到指定時間時，執行一個操作，語法如下：

def ontimer(self, fun, t=0):

引數說明：

1. fun：無引數的函式，當計時器到指定時間時執行，
2. t：指定一個大于或等于 0 的數值，表示多長時間（單位為毫秒）后觸發 fun 指定的函式，

例如，安裝一個計時器，在 300 毫秒后呼叫畫正方形的函式，代碼如下：

# -*- coding: UTF-8 -*-
"""
@author:AmoXiang
@file:14.計時器.py
@time:2020/12/30
"""
import turtle


def fun():  # 繪制正方形
    for i in range(4):
        turtle.forward(100)
        turtle.left(90)


turtle.getscreen().ontimer(fun, 300)  # 設定計時器
turtle.done()  # 海龜繪圖程式的結束陳述句（開始主回圈）