在文档/类参考中辨别类参数

Question

在阅读GTK + 3的文档时遇到了一些麻烦。我已经查找了多个可能提示我的类的引用。我发现一个引用明确指出传递的参数当实例化一个类已经过时并且缺少几个类时。其他3或4的布局方式似乎没有明确说明我需要通过哪些参数。

我找到的最全面的课程资料是here。以“Button”为例，它给出了属性列表，包括标签，浮雕，xalign，yalign等。然而，它并不能确定我在实例化时需要通过哪些属性。

这不是特定于这个文档库，但它是现在引起我悲伤的人。我需要在哪里寻找这些信息？

编辑：更具体地说，我正在寻找kwargs，以及控制类如何处理它们。在按钮示例中，输入一个字符串作为参数来设置标签。但是，我无法找到文档中为什么会出现这种情况。

Answer 1

运用基于Python的GObject库，你可以依靠拇指以下两个规则构造函数的参数：

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

因此，例如对于Gtk.Button，here是你可以找到允许的kwargs的地方。在构造对象时，任何在“Flags”下列出的具有“w”（用于“可写”）的属性都可以设置为关键字arg。

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

只需使用

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