在 documentation/class 参考中识别 class 参数

Discerning class parameters in documentation/class reference

在阅读 GTK+ 3 的文档时遇到一些问题。我查找了多个 class 参考资料,可能会给我一些线索。我发现的一个参考资料明确说明了实例化时传递的参数一个 class 已经过时并且缺少几个 class。其他 3 或 4 个布局方式似乎没有明确说明我需要传递哪些参数。

我找到的最完整的 class 参考是 here。以"Button"为例,它给出了一个属性列表,包括label、relief、xalign、yalign等。然而,它并没有指出我在实例化时需要传递哪些。

这不是该文档库所特有的,但它是现在让我感到悲伤的问题。我需要在哪里查找此信息?

编辑:更具体地说,我正在寻找 kwargs,以及控件 class 如何处理它们。在按钮示例中,输入字符串作为参数设置标签。但是,我在文档中找不到为什么会这样。

使用来自 Python 的基于 GObject 的库,您可以依赖以下两条关于构造函数参数的经验法则:

  1. 在构造函数中使用位置参数已被弃用。
  2. 关键字参数对应于可写属性。

因此,例如对于 Gtk.Buttonhere 是您可以找到允许的 kwargs 的地方。在 "Flags" 下列出的具有 "w"(对于 "writable")的任何 属性 都可以在构造对象时设置为关键字参数。

关于您关于在哪里可以找到有关位置参数的信息的问题:它们已被弃用,因此不会出现在现代 API 文档中。您可以返回到旧的 PyGTK API reference 以查看为了兼容性而模拟的内容,但我不建议使用位置构造函数参数编写任何新代码。

只需使用

button = Gtk.Button(label='Some text')