ドキュメント/クラスリファレンス内のクラスパラメータの区別

Question

GTK + 3のドキュメントを読むのにいくつかの問題があります。複数のクラスリファレンスを参照して私の手がかりを探しました。クラスのインスタンス化が古く、いくつかのクラスが欠落している場合。他の3または4は、どのパラメータを渡す必要があるかを明示していないようにレイアウトされています。

私が見つけた最も完全なクラスリファレンスはhereです。例として "Button"を使用すると、label、relief、xalign、yalignなどのプロパティのリストが得られます。しかし、インスタンス化するときに渡す必要のあるものは識別しません。

これはこのドキュメントライブラリに固有のものではありませんが、今は私が悲しんでいる原因です。この情報を見つけるにはどこを調べる必要がありますか？

編集：具体的には、kwargsと、コントロールクラスがそれらをどのように処理するのかを探しています。ボタンの例では、文字列を引数として入力するとラベルが設定されます。しかし、なぜこれがドキュメントのケースであるのかわかりません。

Answer 1

のPythonからのGObjectベースのライブラリを使用して、コンストラクタの引数のための親指の次の2つの規則に頼ることができます。コンストラクタで位置引数を使用して

1. は推奨されません。
2. キーワードargsは書き込み可能なプロパティに対応します。

たとえば、Gtk.Buttonの場合、hereは、許可されたkwargsを見つける場所です。 "Flags"の下にリストされている "w"（ "書き込み可能"の）プロパティは、オブジェクトの作成時にキーワードargとして設定できます。

位置指定引数についての情報がどこにあるかについてのご質問は、廃止されており、最新のAPIドキュメントには記載されていません。古いPyGTK API referenceに戻って互換性のためにエミュレートされているものを見ることができますが、ポジショナルコンストラクタ引数を持つ新しいコードを書くことはお勧めしません。

だけ

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