Python GTK+ 3 中的标签

在 Python GTK+ 3 中，标签可以用来显示文本或图像。标签可以在窗口的任何位置显示，并且可以应用不同的样式和属性来强调其内容。本文将介绍 Python GTK+ 3 中的标签，包括其创建和使用方法、属性、事件以及一些示例代码。

标签的创建和使用

创建标签可以使用 Gtk.Label() 函数，该函数接受一个字符串参数，即标签所显示的文本。例如，要创建一个显示“Hello World！”的标签，可以使用以下代码：

import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk

label = Gtk.Label("Hello World!")

要将标签添加到窗口中，可以将其作为其他 GTK+3 控件的子控件添加。例如，要将标签添加到一个 Gtk.Window 窗口中，可以使用以下代码：

import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk

class MainWindow(Gtk.Window):

    def __init__(self):
        Gtk.Window.__init__(self, title="Example Window")
        self.set_default_size(400, 300)

        # 创建标签并添加到窗口中
        label = Gtk.Label("Hello World!")
        self.add(label)

win = MainWindow()
win.connect("delete-event", Gtk.main_quit)
win.show_all()
Gtk.main()

标签的属性

标签具有许多属性，可以通过设置标签的属性来控制其在窗口中的外观和行为。下面是一些常用属性的概述：

• label：标签所显示的文本。
• use_markup：指示标签是否使用标记语言（如 HTML）进行格式化。如果为 True，则 label 属性中包含的文本将被解释为标记语言。
• bold：指示标签是否显示为粗体。
• underline：指示标签是否显示为带下划线的文本。
• xalign：指示标签在其分配给它的空间中水平对齐的方式。值为 0.0 表示左对齐，0.5 表示居中，1.0 表示右对齐。
• yalign：指示标签在其分配给它的空间中垂直对齐的方式。值为 0.0 表示上对齐，0.5 表示居中，1.0 表示下对齐。
• wrap：指示标签是否在达到其分配给它的空间的最大宽度时换行。
• wrap_mode：指定标签文本换行的方式。可选值包括 Gtk.WrapMode.NONE（不换行）、Gtk.WrapMode.CHAR（在字符边界换行）、Gtk.WrapMode.WORD（在单词边界换行）等。
• justify：指定标签中文本的对齐方式。可选值包括 Gtk.Justification.LEFT（左对齐）、Gtk.Justification.CENTER（居中对齐）、Gtk.Justification.RIGHT（右对齐）等。

要设置标签的属性，可以使用标签对象的 set_xxx() 方法，其中 xxx 为属性名称。例如，要将标签文本设置为“Hello World！”并将其设置为粗体，可以使用以下代码：

import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk

label = Gtk.Label()
label.set_markup("<b>Hello World!</b>")

标签的事件

标签可以响应用户的交互事件，例如鼠标单击或悬停。要响应事件，需要将标签的信号与回调函数相关联。以下是标签支持的一些常见信号：

• activate：当用户激活标签时触发，例如单击或按下 Enter 键。
• enter：当鼠标进入标签时触发。
• leave：当鼠标离开标签时触发。

以下是一个示例代码，演示了如何在标签上显示鼠标悬停的信息：

import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk

class MainWindow(Gtk.Window):

    def __init__(self):
        Gtk.Window.__init__(self, title="Example Window")
        self.set_default_size(400, 300)

        # 创建标签并添加到窗口中
        label = Gtk.Label("Move your mouse here")
        self.add(label)

        # 连接标签的 "enter-notify-event" 和 "leave-notify-event" 编辑信号
        label.connect("enter-notify-event", self.on_mouse_enter)
        label.connect("leave-notify-event", self.on_mouse_leave)

    def on_mouse_enter(self, widget, event):
        widget.set_markup("<span foreground='blue'>Mouse entered!</span>")

    def on_mouse_leave(self, widget, event):
        widget.set_markup("Move your mouse here")

win = MainWindow()
win.connect("delete-event", Gtk.main_quit)
win.show_all()
Gtk.main()

标签的示例代码

以下是一些使用标签的示例代码，可以帮助您更好地了解如何创建和使用标签：

• 显示图像

import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk, GdkPixbuf

class MainWindow(Gtk.Window):

    def __init__(self):
        Gtk.Window.__init__(self, title="Example Window")
        self.set_default_size(400, 300)

        # 加载图像文件并创建标签对象
        pixbuf = GdkPixbuf.Pixbuf.new_from_file("image.png")
        image = Gtk.Image.new_from_pixbuf(pixbuf)
        label = Gtk.Label()
        label.set_image(image)

        # 将标签对象添加到窗口中
        self.add(label)

win = MainWindow()
win.connect("delete-event", Gtk.main_quit)
win.show_all()
Gtk.main()

• 改变文本颜色

import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk, Pango

class MainWindow(Gtk.Window):

    def __init__(self):
        Gtk.Window.__init__(self, title="Example Window")
        self.set_default_size(400, 300)

        # 创建标签对象并设置文本和颜色
        label = Gtk.Label("Hello World!")
        label.modify_fg(Gtk.StateFlags.NORMAL, Gdk.RGBA(1, 0, 0, 1))

        # 将标签对象添加到窗口中
        self.add(label)

win = MainWindow()
win.connect("delete-event", Gtk.main_quit)
win.show_all()
Gtk.main()

• 模拟链接

import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk

class MainWindow(Gtk.Window):

    def __init__(self):
        Gtk.Window.__init__(self, title="Example Window")
        self.set_default_size(400, 300)

        # 创建标签对象并设置文本和样式
        label = Gtk.Label()
        label.set_markup("<a href='https://www.google.com'>Click here to go to Google</a>")
        label.set_has_tooltip(True)

        # 将标签对象添加到窗口中
        self.add(label)

win = MainWindow()
win.connect("delete-event", Gtk.main_quit)
win.show_all()
Gtk.main()

总结

本文介绍了 Python GTK+ 3 中的标签，包括其创建和使用方法、属性、事件以及一些示例代码。通过本文的学习，您应该能够根据需要创建自己的标签，并使用其丰富的功能来增强应用程序的用户界面。