原文： http://zetcode.com/gui/pygtk/customwidget/

工具箱通常仅提供最常见的窗口小部件，例如按钮，文本窗口小部件，滑块等。没有工具箱可以提供所有可能的窗口小部件。

客户程序员必须创建更专业的小部件。 他们使用工具箱提供的绘图工具来完成此任务。 有两种可能：程序员可以修改或增强现有的小部件，或者可以从头开始创建自定义小部件。

刻录小部件

这是我们从头开始创建的小部件的示例。 可以在各种媒体刻录应用（例如 Nero 刻录 ROM）中找到此小部件。

burning.py

  1. #!/usr/bin/python
  2. # -*- coding: utf-8 -*-
  4. # ZetCode PyGTK tutorial 
  5. #
  6. # This example creates a burning
  7. # custom widget
  8. #
  9. # author: Jan Bodnar
  10. # website: zetcode.com 
  11. # last edited: April 2011
  13. import gtk
  14. import cairo
  16. class Burning(gtk.DrawingArea):
  18.     def __init__(self, parent):
  20.         self.par = parent
  21.         super(Burning, self).__init__()
  23.         self.num = ( "75", "150", "225", "300", 
  24.             "375", "450", "525", "600", "675" )
  26.         self.set_size_request(-1, 30)
  27.         self.connect("expose-event", self.expose)
  29.     def expose(self, widget, event):
  31.         cr = widget.window.cairo_create()
  32.         cr.set_line_width(0.8)
  34.         cr.select_font_face("Courier", 
  35.             cairo.FONT_SLANT_NORMAL, cairo.FONT_WEIGHT_NORMAL)
  36.         cr.set_font_size(11)
  38.         width = self.allocation.width
  40.         self.cur_width = self.par.get_cur_value()
  42.         step = round(width / 10.0)
  44.         till = (width / 750.0) * self.cur_width
  45.         full = (width / 750.0) * 700
  47.         if (self.cur_width >= 700):
  49.             cr.set_source_rgb(1.0, 1.0, 0.72)
  50.             cr.rectangle(0, 0, full, 30)
  51.             cr.save()
  52.             cr.clip()
  53.             cr.paint()
  54.             cr.restore()
  56.             cr.set_source_rgb(1.0, 0.68, 0.68)
  57.             cr.rectangle(full, 0, till-full, 30)
  58.             cr.save()
  59.             cr.clip()
  60.             cr.paint()
  61.             cr.restore()
  63.         else:     
  64.             cr.set_source_rgb(1.0, 1.0, 0.72)
  65.             cr.rectangle(0, 0, till, 30)
  66.             cr.save()
  67.             cr.clip()
  68.             cr.paint()
  69.             cr.restore()
  71.         cr.set_source_rgb(0.35, 0.31, 0.24)
  73.         for i in range(1, len(self.num) + 1):
  74.             cr.move_to(i*step, 0)
  75.             cr.line_to(i*step, 5)
  76.             cr.stroke()
  78.             (x, y, width, height, dx, dy) = cr.text_extents(self.num[i-1])
  79.             cr.move_to(i*step-width/2, 15)
  80.             cr.text_path(self.num[i-1])
  81.             cr.stroke()
  83. class PyApp(gtk.Window): 
  85.     def __init__(self):
  86.         super(PyApp, self).__init__()
  88.         self.set_title("Burning")
  89.         self.set_size_request(350, 200)        
  90.         self.set_position(gtk.WIN_POS_CENTER)
  91.         self.connect("destroy", gtk.main_quit)
  93.         self.cur_value = 0
  95.         vbox = gtk.VBox(False, 2)
  97.         scale = gtk.HScale()
  98.         scale.set_range(0, 750)
  99.         scale.set_digits(0)
  100.         scale.set_size_request(160, 40)
  101.         scale.set_value(self.cur_value)
  102.         scale.connect("value-changed", self.on_changed)
  104.         fix = gtk.Fixed()
  105.         fix.put(scale, 50, 50)
  107.         vbox.pack_start(fix)
  109.         self.burning = Burning(self)
  110.         vbox.pack_start(self.burning, False, False, 0)
  112.         self.add(vbox)
  113.         self.show_all()
  115.     def on_changed(self, widget):
  116.         self.cur_value = widget.get_value()
  117.         self.burning.queue_draw()
  119.     def get_cur_value(self):
  120.         return self.cur_value
  122. PyApp()
  123. gtk.main()

我们在窗口底部放置一个DrawingArea并手动绘制整个窗口小部件。 所有重要的代码都驻留在Burning类的expose()方法中。 此小部件以图形方式显示了介质的总容量和可供我们使用的可用空间。 该小部件由比例小部件控制。 自定义窗口小部件的最小值为 0，最大值为 750。如果值达到 700，则开始绘制红色。 这通常表示过度燃烧。

  1. self.num = ( "75", "150", "225", "300", 
  2.     "375", "450", "525", "600", "675" )

这些数字显示在刻录小部件上。 它们显示了介质的容量。

  1. self.cur_width = self.par.get_cur_value()

这两行从刻度小部件获取当前数字。 我们获得父窗口小部件，并从父窗口小部件中获得当前值。

  1. till = (width / 750.0) * self.cur_width
  2. full = (width / 750.0) * 700

直到参数确定要绘制的总大小。 该值来自滑块小部件。 它占整个面积的一部分。 full参数确定了我们开始绘制红色的点。

  1. cr.set_source_rgb(1.0, 1.0, 0.72)
  2. cr.rectangle(0, 0, till, 30)
  3. cr.save()
  4. cr.clip()
  5. cr.paint()
  6. cr.restore()

此代码在此处绘制了一个黄色矩形，直到介质充满为止。

  1. (x, y, width, height, dx, dy) = cr.text_extents(self.num[i-1])
  2. cr.move_to(i*step-width/2, 15)
  3. cr.text_path(self.num[i-1])
  4. cr.stroke()

这里的代码在刻录小部件上绘制数字。 我们计算TextExtents来正确定位文本。

  1. def on_changed(self, widget):
  2.     self.cur_value = widget.get_value()
  3.     self.burning.queue_draw()

我们从小部件中获取值，并将其存储在cur_value变量中以备后用。 我们重新绘制刻录的小部件。

PyGTK 中的自定义小部件 - 图1

图：刻录小部件

在本章中，我们在 PyGTK 中创建了一个自定义小部件。