【渣译】An Introduction To Tkinter - Canvas Widget Class Reference

原文地址:http://effbot.org/tkinterbook/canvas.htm

canvas组件为tkinter提供了结构化的图形绘制功能。其功能强大,既能够绘制点线面等图形,还能够创建出图形编辑器,甚至可以根据界面设计的需要实现出多种多样的自定义组件。

canvas组件的使用场景

canvas是一个通用组件,主要用来显示和编辑图形。

canvas组件还被经常用来实现自定义组件。例如,可以在一个canvas上绘制并更新矩形框来实现一个进度条。

样例

要在canvas上画东西,需要使用create方法来新增item。例如:

from Tkinter import *

master = Tk()

w = Canvas(master, width=200, height=100)
w.pack()

w.create_line(0, 0, 200, 100)
w.create_line(0, 100, 200, 0, fill="red", dash=(4, 4))

w.create_rectangle(50, 25, 150, 75, fill="blue")

mainloop()

注意,在canvas中新增的item会一直存在到你删除它。如果你想改变所画的东西,可以通过coordsitemconfigmove等方法来修改所绘制的item,也可以通过delete方法将其删除。例如:

i = w.create_line(xy, fill="red")

w.coords(i, new_xy) # change coordinates
w.itemconfig(i, fill="blue") # change color

w.delete(i) # remove

w.delete(ALL) # remove all items

一些概念

为了在canvas上显示东西,需要创建几个canvas item,这些item会被存放在一个栈中。默认情况下,新绘制的item会被画在所有已绘制item的最上边,即覆盖掉其他item。

canvas item

canvas组件支持以下标准item:

  • arc(弧、弦、扇形)
  • bitmap
  • imageBitmapImage实例或PhotoImage实例)
  • line
  • oval(圆或椭圆)
  • polygon
  • rectangle
  • text
  • window

弦、扇形、椭圆、多边形、矩形由边和内部区域组成,边和内部区域均可以被设置为透明的。

window item被用来在canvas上放置其他tkinter组件,对于这些item,canvas仅仅管理其几何属性。

item类型可以使用C或C++进行扩展,通过Python包的形式供tkinter使用。

坐标系统

canvas组件使用两种坐标系:window坐标系和canvas坐标系。windows坐标系以窗口左上角作为原点(0, 0),而canvas坐标系则会明确指明item在画布上的位置。通过滚动canvas,可以指明要在window上显示canvas坐标系上的哪一部分区域。

scrollregion属性被用来限制canvas的滚动操作,可以这样对其进行设置:

canvas.config(scrollregion=canvas.bbox(ALL))

通过canvasxcanvasy方法可以将window坐标转换为canvas坐标,代码如下:

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

item标识符:句柄和标签

canvas组件提供了几个标识item的方法:

  • item句柄(整数)
  • 标签
  • ALL
  • CURRENT

item句柄是个整数值,用来标识canvas中的一个item。tkinter会为每个在canvas上新创建的item自动分配一个句柄。item句柄可以通过整数形式或字符串形式传递给canvas提供的各类方法。

标签是附属于item的一个象征性名称。标签是原始字符串,但不能包含空格。一个item可以没有标签,也可以拥有多个标签,且一个标签名可以用于多个item。标签被item所拥有,依附于item而存在。

要为一个item增加标签,可以使用itemconfig方法设置item的tags属性或通过addtag_withtag方法直接新增。item的tags属性可接受字符串或字符串元组作为入参。代码如下:

item = canvas.create_line(0, 0, 100, 100, tags="uno")
canvas.itemconfig(item, tags=("one", "two"))
canvas.addtag_withtag("three", "one")

要获取一个特定item的所有标签,可使用gettags方法。要通过标签获取相关item,可使用find_withtag方法。代码如下:

>>> print canvas.gettags(item)
('one', 'two', 'three')
>>> print canvas.find_withtag("one")
(1,)

canvas组件提供了两个预定义标签:

  • ALL (或字符串"all")其匹配canvas中的所有item。
  • CURRENT (或字符串"current")其匹配鼠标指针所指向的item。这可以在鼠标事件的处理中来找到触发事件的item。

打印

tkinter组件支持向PostScript打印机进行输出。

性能问题

canvas组件实现了一个直接的毁掉重来型的显示模式(straight-forward damage/repair display model,这..有啥官方翻译不...)。任何对canvas的修改和如Expose之类的外部事件都被认为是对屏幕的破坏。组件维护了一个dirty rectange来记录被破坏的区域。

当第一个破坏事件到来时,canvas注册一个待机任务(通过after_idle方法),该任务会在程序回到tkinter主循环时修复canvas。此外也可以通过调用update_idletasks来强制更新canvas。

在重绘canvas时,会先分配一个与dirty rectangle尺寸一样的像素图(一块内存)。之后遍历canvas中的item并对其中与dirty rectangle有重叠的item进行重绘。最后,这块像素图会被复制到显示屏上,同时存放像素图的内存被释放,这个复制过程在现代计算机上会非常快。

由于canvas仅使用了一个dirty rectangle,因此可以通过强制更新来得到更好的性能。例如,如果要同时改变画布中不同的几个区域,可以通过在改变后直接调用update_idletasks()来分别进行更新,以避免回到主循环进行重绘的时候dirty rectangle较大而不得不重绘大量其实并没有被改变的item。

API参考手册

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,440评论 5 467
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,814评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,427评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,710评论 1 270
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,625评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,014评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,511评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,162评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,311评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,262评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,278评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,989评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,583评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,664评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,904评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,274评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,856评论 2 339

推荐阅读更多精彩内容