GTK3中如何为自定义Widget添加可通过props访问的自定义属性？

要让你的MyWidget支持GTK组件一致的props属性访问，不能用Python原生的@property装饰器，得用GObject的属性注册机制——毕竟所有GTK部件都是GObject的子类，props接口是GObject属性系统的标准用法。

基础实现方式 #

只需要在MyWidget类中用GObject.Property()定义类属性，就能自动接入GObject的属性系统，支持props访问：

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk, GObject

class MyWidget(Gtk.Grid):
    # 注册GObject自定义属性
    my_custom_property = GObject.Property(
        type=int,               # 指定属性类型（必填，保证类型安全）
        default=0,              # 设置默认值
        nick="My Custom Prop",  # 属性的简短别名（可选）
        blurb="An integer property for MyWidget",  # 属性描述（可选）
        flags=GObject.ParamFlags.READWRITE  # 读写权限（默认就是READWRITE，可省略）
    )

# 使用示例
if __name__ == "__main__":
    my_widget = MyWidget()
    
    # 用props接口设置和读取属性（和GTK原生部件用法一致）
    my_widget.props.my_custom_property = 12
    print(my_widget.props.my_custom_property)  # 输出: 12
    
    # PyGObject还会自动把GObject属性映射为Python类属性，所以也可以直接访问
    my_widget.my_custom_property = 24
    print(my_widget.my_custom_property)  # 输出: 24

自定义Getter/Setter逻辑 #

如果需要在属性读写时加入自定义逻辑（比如值范围校验、状态同步），可以给GObject.Property()传入getter和setter参数：

class MyWidget(Gtk.Grid):
    def __init__(self):
        super().__init__()
        self._internal_value = 0  # 用内部变量存储实际值

    def _get_custom_prop(self):
        # 自定义获取逻辑
        return self._internal_value

    def _set_custom_prop(self, value):
        # 自定义设置逻辑：比如限制值不能小于0
        if value < 0:
            value = 0
        self._internal_value = value
        # 还可以在这里触发UI更新、信号通知等操作

    # 注册带自定义逻辑的属性
    my_custom_property = GObject.Property(
        type=int,
        default=0,
        getter=_get_custom_prop,
        setter=_set_custom_prop,
        flags=GObject.ParamFlags.READWRITE
    )

关键说明 #

• 必须指定type参数：GObject属性是强类型的，这能保证属性值的类型安全，也符合GTK部件的设计规范。
• flags参数控制权限：常用的有READWRITE（可读写）、READABLE（只读）、WRITABLE（只写）。
• 注册后的属性会自动支持props访问，同时兼容直接的Python属性操作，完全对齐GTK原生部件的接口风格。

内容的提问来源于stack exchange，提问作者eugenhu