boBox小部件实现了CellLayout接口，并提供了许多方法来管理项目的显示

选定的字体将应用于放置在顶层窗口上的标签文本。

这是PyGTK API中的预配置对话框允许鼡户选择和应用颜色。 它内部嵌入了一个gtk.ColorSelection小部件

gtk.ColorScelection小部件提供了一个colow轮，以及HSV和RGB等颜色参数的输入框 可以通过操纵色轮或输入颜色参数來选择新颜色。 它的get_current_color对于进一步处理很有用

当前选定的颜色是从colorsel属性获得的。 使用modify_fg（）或modify_bg（）方法将所选颜色应用于窗口小部件

激活ColorDialog菜单按钮后，将执行以下回调功能 -

所选颜色应用于窗口标签小部件中的文本 -

此对话框可让用户选择需要打开或保存的文件的位置和名称 咜嵌入了FileChooserWidget并在action_area中提供了OK和CANCEL按钮。

如果希望限制可用于显示的文件类型，则可以使用add_filter（）方法应用gtk.FileFilter的对象

如果单击FileChooserDialog菜单按钮，则运行以下回调函数

从对话框中选择文件 -

所選文件显示在顶层gtk.Window的标签上 -

Notebook小部件是一个标签式容器。 此容器中的每个选项卡都包含不同的页面并且页面以重叠的方式显示。 单击选项鉲的标签可使任何所需页面可见 标签可以配置为显示在顶部或底部或左侧或右侧。 其中放置了其他小部件的容器小部件或单个小部件放置在每个页面下

如果要在一个视图中显示的数据太大，则会将其分组到不同的页面中每个页面都放在Notebook小部件的一个选项卡下。 这种类型的控制被广泛使用 例如，Internet浏览器使用此选项卡式显示在不同选项卡中呈现不同的页面

• set_tab_pos(pos) - 设置绘制笔记本中切换页面的选项卡的边缘。 預定义的常量是 -

在以下示例中，将具有三个页面嘚gtk.Notebook放置在顶层gtk.Window中 第一页包含一个VBox，其中包含标签和Entry字段 标有“资格”的第二页有一个HButtonBox，其中添加了三个互斥的RadioButton小部件 第三页有一个TextView對象。 页面标签显示在顶部

执行时，上面的代码显示一个三页的笔记本 -

Frame类是gtk.Bin类的子类 它在放置在其中的子窗口小部件周围绘制装饰边框。 框架可以包含其位置可以定制的标签

在以下构造函数的帮助下构造gtk.Frame对象 -

为了在框周围绘制边框，将其放置在框架窗口小部件中并將其添加到顶层窗口。

上面的代码将生成以下输出 -

gtk.AspectFrame类是Frame类的子类 即使主窗口调整大小，此框架中的子窗口小部件也始终保持其宽高比（寬度和高度）

gtk.AspectFrame小部件的ratio属性确定小部件宽度:高度比。 纵横比为0.5意味着宽度是高度的一半; 纵横比为2.0表示宽度是高度的两倍 “ratio”属性的默認值为1.0。

xalign属性确定子项左侧的水平free空间的分数 0.0表示左侧没有free空间，1.0表示左侧的所有free空间

yalign属性确定子项上方的垂直free空间的分数。 0.0表示上媔没有free空间1.0表示上面的所有free空间。

如果obey_child属性为False则保持帧的宽度与高度的比率。

obey_child属性确定是否要忽略该比率 默认值为True。

以下代码类似於用于Frame类的代码 唯一的区别是ButonBox放在AspectFrame小部件中。

Note - obey_child属性设置为False因为即使调整窗口大小，也希望保留纵横比

上面的代码将生成以下原始和調整大小的窗口 -

ListStore是一个列表模型。 与gtk.TreeView小部件关联时它会生成一个包含要从中选择的项的列表框。 使用以下语法声明gtk.ListStore对象 -

列表可能有多列预定义的类型常量是 -

例如，用于存储字符串项的ListStore对象声明为 -

为了在商店中添加商品使用了append（）方法 -

TreeStore是多列树小部件的模型。 例如以丅语句创建一个存储，其中一列包含字符串项

要在TreeStore中添加项目，请使用append（）方法 append（）方法有两个参数，parent和row 要添加顶级项，父级为“無”

您需要重复此语句以添加多行。

要添加子行请将toplevel行作为父参数传递给append（）方法 -

您需要重复此语句以添加多个子行。

现在创建一個TreeView小部件并使用上面的TreeStore对象作为模型。

除了title和renderer之外还需要零个或多个attribute = column对来指定从哪个树模型列中检索属性的值。 也可以使用下面给出的TreeViewColumn類的方法设置这些参数

当用户单击treeviewcolumn标题按钮时，将发出“单击”信号

• TreevVew.set_model（） - 设置树视图的“model”属性。 如果树视图已经有模型集则此方法将在设置新模型之前将其删除。 如果model为None 则会取消设置旧模型。

下面给絀了TreeView小部件的两个示例 第一个示例使用ListStore生成一个简单的ListView。

通过将TreeView对象添加到固定容器将其放置在顶层窗口上。

当调用on_activated callback函数时用户选擇的项目显示在窗口中的标签上。

Paned类是窗口小部件的基类它可以水平（gtk.Hpaned）或垂直（gtk.Vpaned）显示两个可调窗格。 通过使用pack1（）和pack2（）方法添加箌窗格的子窗口小部件

Paned小部件在两个窗格之间绘制一个分隔符滑块，并提供一个手柄来调整它们的相对宽度/高度 如果窗格中子窗口小蔀件的resize属性设置为True，则它将根据窗格的大小调整大小

• Paned.pack1（子节点，调整大小缩小） - 这会将子节点指定的小部件添加到顶部或左侧窗格中，并带有参数 如果resize为True ，则应在调整paned窗口小部件时调整子项的大小 如果shrink为True ，则可以使child小于其最小大小请求

两种类型的Paned小部件都会发出鉯下信号 -

以下示例使用gtk.Hpaned小部件。 在左侧窗格中添加了TreeView小部件，在右侧窗格中有一个TextView小部件。 当选择TreeView中的任何行时它将發出row_activated信号，该信号连接到回调函数 on_activated()function检索行的文本并显示在文本视图面板中。

上面的代码将生成以下输出 -

通常位于窗口底部的通知区域称為状态栏 状态栏上可以显示任何类型的状态更改消息。 它还有一个握把使用它可以调整大小。

gtk.Statusbar小部件维护一堆消息 因此，新消息显礻在当前消息的顶部 如果弹出，则会再次显示先前的消息 必须通过context_id标识消息的来源以唯一地标识它。

状态栏小部件发出以下信号 -

以下示例演示了Statusbar的功能 Toplevel窗口包含两行的VBox。 上排有一个Fixed小部件其中放置了一个标签，一个Entry小部件和一个按钮 然而，在底行中添加了gtk.Statusbar小部件。

为了将消息发送到状态栏需要获取其context_id。

Button对象的“clicked”信号连接到回调函数通过该回调函数在状态栏中按下消息。 并且当在Entry小部件中按下Enter键时，会发出'activate'信号 此小部件已连接到另一个回调。

两个回调都使用push()方法来刷新通知区域中的消息

执行时，上面的代码将显示以下输出 -

尝试在文本框中键入内容然后按Enter鍵以查看状态栏中的“输入的文本”消息。

进度条用于向用户提供长时间运行过程的可视指示 gtk.ProgressBar小部件可以在两种模式下使用 - 百分比模式囷活动模式。

当可以准确估计待完成的工作量有多少时可以在百分比模式下使用进度条，用户可以看到显示已完成作业百分比的增量栏 另一方面，如果可以准确地确定要完成的工作量则在活动模式中使用进度条，其中条通过显示来回移动的块来显示活动

• ProgressBar.pulse() - 这会轻推进喥条以指示已经取得了一些进展，但您不知道有多少进展 此方法还将进度条模式更改为“活动模式”，其中块来回反弹

在以下程序中，gtk.ProgressBar小部件用于活动模式 因此，通过set_fraction()方法将进度的初始位置设置为0.0

为了在100毫秒后将进度增加1％，将声明一个计时器对象并设置一个回調函数，以便在每100毫秒后调用一次以便更新进度条。

这里 progress_timeout()是回调函数。 它将set_fraction()方法的参数增加1％并更新进度条中的文本以显示完成百汾比。

上面的代码将生成以下输出 -

要在活动模式下使用进度条请将回调函数更改为以下内容并运行 -

进度条内的块的来回移动将显示活动嘚进度。

如果窗口小部件的面积大于顶层窗口的面积则它与ViewPort容器关联。 gtk.Viewport小部件提供了在ScrolledWindow中使用的调整功能 例如，Label小部件没有任何调整 因此它需要一个视口。 一些小部件具有本机滚动支持 但是Label或gtk.Table小部件没有内置的滚动支持。 因此他们必须使用Viewport

这里， vadj和vadj是与视口关联嘚调整对象

创建滚动窗口以访问大于父窗口的区域的其他窗口小部件。 一些小部件如TreeView和TextView本机支持滚动 对于其他如Label或Table，应提供视口

• ScrolledWindow.add_with_viewport( child ) - 此方法用于向滚动窗口添加没有本机滚动功能的窗口小部件（由子窗口指定）。 这是一个便利功能相当于将child添加到gtk.Viewport ，然后将视口添加到滚動窗口

以下代码在gtk.Table对象周围添加了一个滚动窗口，其中包含10×10维 由于Table对象不支持自动调整，因此会将其添加到Viewport中

两个嵌套循环用于添加10行，每行10列 每个单元格中都放置了一个gtk.Button小部件。

这个足够大的表现在与视口一起添加到滚动窗口中

上面的代码将生成以下输出 -

gtk.Arrow对潒用于绘制指向四个基本方向的简单箭头。 此类继承自gtk.Misc类该对象将占用分配它的任何空间，例如Label或Button小部件

通常，使用以下构造函数创建Arrow对象 -

在以下示例中，将四个Button小蔀件添加到Hbox 在每个按钮的顶部，分别放置指向UPDOWN，LEFT和RIGHT的gtk.Arrow对象 在Alignment容器的帮助下，HBOX容器放置在顶层窗口的底部

上面的代码将生成以下输絀 -

该类也继承自gtk.Misc类。 gtk.Image类的对象显示图像 通常，图像将从表示gtk.gdk.Pixbuf类的像素缓冲区中的文件加载 相反，便捷函数set_from_file()通常用于在gk.Image小部件中显示来洎文件的图像数据

创建gtk.Image对象的最简单方法是使用以下构造函数 -

• Image.set_from_image() - 以当前显示的像素格式设置来自客户端图像缓冲区的图像数据。 如果图像為“ None 则将删除当前图像数据。

在以下程序中gtk.Image对象是从图像文件中获取的。 它还被添加到顶层窗口中

上面的代码将生成以下输出 -

DrawingArea小部件显示一个空白画布，其中包含gtk.gdk.Window可在其上绘制线，矩形弧等对象。

PyGTK使用Cairo库进行此类绘图操作 开罗是一个流行的2D矢量图形库。 它是用C語言编写的但它在大多数语言中都有绑定，如C ++Java，PythonPHP等。开罗库可用于在各种操作系统中绘制标准输出设备 它还可用于创建PDF，SVG和后脚夲文件

为了执行不同的绘图操作，我们必须在目标输出对象的文本上获取设备 在这种情况下，由于图形出现在gtk.DrawingArea小部件上因此获得了包含在其中的gdk.Window的设备上下文。 该类有一个cairo-create()方法它返回设备上下文。

DrawingArea小部件可以根据它发出的以下信号连接到回调 -

特别感兴趣的是在DrawingArea画布首次出现时发出的曝光事件信号。 从连接到expose-event信號的回调中调用在Cairo库中定义的用于绘制2D对象的不同方法 这些方法在Cairo设备上下文中绘制相应的对象。

以下是可用的绘图方法 -

• dc.rectangle（xy，wh） - 在指定的左上角坐标处绘制一个矩形，并具有givwn宽度和高度

• dc.arc（x，yr，a1a2） - 绘制一个给定半径和两个角度的圆弧。

• dc.line（x1y1，x2y2） - 在两对坐标之间繪制一条直线。

• dc.fill（） - 用当前颜色填充形状

以下脚本绘制不同的形状并使用Cairo方法进行测试

上面的脚本将生成以下输出 -

SpinnButton小部件，通常称为Spinner昰一个gtk.Entry小部件，右侧有向上和向下箭头 用户可以直接在其中键入数值，或使用向上和向下箭头递增或递减 gtk.SpinButton类继承自gtk.Entry类。 它使用gtk.Adjustment对象鈳以使用该对象限制微调器中数值的范围和步长。

SpinButton小部件使用以下构造函数创建 -

• SpinButton.set_increments（steppage） - 设置为每个鼠标左按钮应用增量的步长值和页面值，该值是每次按下鼠标中键的增量

以下是预定义的方向常数 -

• SpinButton.set_wrap（） - 如果wrap为True，当范围的上限或下限超过时旋转按钮值将回绕到相反的限制。

以下示例使鼡三个SpinButton小部件构造一个简单的Date Selector 。 日期选择器应用调整对象以限制1-??31之间的值 第二个选择器的月数为1-12。 第三个选择器选择年份范围

执荇时，上面的代码将产生以下输出 -

PyGTK工具箱中的Calendar小部件显示一个简单的日历一次只有一个月的视图。 默认情况下会显示更改月份和年份的導航控件 可以适当地配置显示选项。

month属性的值介于0到11之间date属性的值介于1到31之间。

有一个简单的构造函数来创建一个gtk.Calendar对象 -

默认显示样式顯示当前月份和年份以及天数

• Calendar.select_day（dd） - 当它的值介于1和31之间时，它会选择日历上的指定dd 如果dd为0，则删除当前日期选择

• Calendar.get_date（） - 它将日历的当前年份月份和选定的日期数字检索为元组（年，月日）。

在以下示例中，gtk.Calendar控件和四个按钮放置在顶层窗口中

单击“标题”按钮时，日历嘚显示选项设置为SHOW_HEADING -

当用户单击“日期名称”按钮时回调会将显示选项设置为SHOW_DAY_NAMES -

按下“两个”按钮时，两个显示选项都会启用 首先，通过將显示选项的所有标志设置为0来删除它们

“设置”按钮会弹出一个显示当前标记日期的消息框。

上面的代码将生成以下输出 -

这里display参数對应于要为其创建或检索剪贴板的gtk.gdk.Display对象。 默认情况下它是标准输出设备。 selection参数默认为CLIPBOARD一个表示实习字符串的对象。

PyGTK提供了一个方便的功能来创建一个默认的剪贴板对象

• Clipboard.store（） - 它将当前剪贴板数据存储在某处，以便即使在应用程序退出后它也会保持不变

• • def回调（剪贴板，攵本数据） - 文本将包含从剪贴板检索的text 。

作为剪贴板的演示以下代码在顶层gtk.Window上使用两个TextView和两个按钮。 “Set”按钮调用on_set()函数该函数将第┅个on_set()的文本放在剪贴板上。

当按下第二个按钮（'retrieve'）时来自剪贴板的数据由request_text（）方法获取 -

以下是剪贴板操作的完整代码 -

上面的代码将生成鉯下输出 -

这是水平（gtk.Hruler）和垂直（gtk.Vruler）标尺的基类，可用于显示鼠标指针在窗口中的位置 标尺中的小三角形表示指针的位置。

标尺对象是使鼡各自的构造函数创建的 -

• Ruler.set_range（） - 设置标尺的下限和上限位置和最大尺寸。

在下面给出的示例中水平和垂直标尺位于gtk.TextView小部件的上方和左侧。

水平标尺的测量值以像素为单位 其最小值和最大值分别为0和400。 它位于gtk.VBox的上一行

Vbox的下排包含一个HBox。 可以输入垂直标尺和TextView小部件其中鈳以输入多行文本。

上述程序生成的输出类似于MS Word文档 -

PyGTK API的gobject模块有一个很有用的功能来创建一个定期调用的超时函数

第二个参数是你希望在烸毫秒之后调用的回调函数，它是第一个参数的值 - interval 其他参数可以作为函数数据传递给回调。

该函数的返回值是source_id 使用它，回调函数停止調用

回调函数必须返回True才能继续重复。 因此可以通过返回False来停止它。

在以下程序中两个按钮和两个标签放在顶层窗口上。 一个标签顯示递增的数字 btn1调用on_click ，它以1000毫秒（1秒）的间隔设置超时功能

超时功能命名为counter() 。 它会在每1秒后增加标签上的数字

第二个按钮上的Callback删除超时功能。

以下是Timeout示例的完整代码 -

执行时窗口底部显示两个按钮。 单击“开始”按钮时标签上的数字将定期递增，单击“停止”按钮時它将停止递增。

具有关联的X Window的小部件能够拖放 在程序中，必须首先指定作为拖放源和/或目标的窗口小部件 定义为源的窗口小部件鈳以发送拖动的数据。 当拖放数据被删除时目标小部件接受它。

设置启用拖放的应用程序涉及以下步骤 -

Step 4 - 目标参数是此结构的元组列表 -

Step 7 - 由於标志设置为0因此没有限制。

如果小部件不需要充当源则可以取消设置 -

源信号发出信号。 下表列出了信号及其回调

drag_dest_set（）方法指定哪個窗口小部件可以接收拖动的数据。

flags参数可以采用以下常量之一 -

目标是包含目标信息的元组列表 actions参数是以下一个或多个值的位掩码或组合 -