wx.Pythonの物語

こんにちは、ハブラブ！

この記事では、 wxPythonなどのすばらしいライブラリーについての考えを定式化します。 カットの下には、少しの理論、フォームの説明、フォームのプロパティの分析、さまざまなコントロール、wxPythonに関連するすべてがあります。
wxPythonへようこそ 。

初期データ

いくつかの理論紹介。

1. wxPython in action（ロシア語） -本のロシア語版（オリジナルの方が好きなので、その品質と起源については何も言えませんが、実際にはwxPythonが動作しています（英語） -ここでは紙の形式で54ドル（電子）一般的な意見は、この本は優れているということです。すべてが詳細に記述され、書かれています。もちろん、多くの点は詳細ではなく、いくつかの事柄はドキュメントで最もよく見られますが、一般に、すべての例は真実です。初心者に最適です。

2.wxPython 2.8アプリケーション開発クックブック 。 私はロシア語版でこの本を見つけようとさえしませんでした。 この本には、GUIフォームを書くための「レシピ」が含まれていますが、それはたいてい簡単ではなく、解析も簡単ではありません（ただし、本の各行を理解しようとする試みがあります。

3. python.suは、さまざまなトピックに関するトピックの優れたデータベースを備えた優れたフォーラムです。 広告とは考えないでください。しかしそれは本当に良いことです。最近安定して機能していないのは残念です。

4. habrahabr.ru-ここで大失敗が待っていた。 私が探していたその瞬間、このライブラリに関する記事は1つもありませんでした。 ほんの少し前に、基本の小さな記事がフラッシュされました（最初のページの本に書かれているもの）。 実際、それでもこの記事を書くことを考えていました。

将来に目を向けて、私は図書館で長い間働いた後に見つけたいくつかのツールをすぐにアドバイスしたいと思います。

1.wxPythomのデモとドキュメント これは、wxpythonライブラリを使用して記述されたコントロールとフォームの最良の例です。 さまざまなフォームとコントロール、リスト、ツリー、およびそれらのさまざまな組み合わせの例があります。 これらすべての例のソースコードにはコメントが豊富ではないので、後でそれを見つけて、何が起こっているのかを理解すると、何が起こっているのかを理解するのに非常に役立ちました。

2. wxFormBuilder -wxPythonのフォームとコントロールのアプリケーションコンストラクター（だけではありません）。 このアプリケーションは、30個のフォームを手で書いたときに見つけました。 つまり フォームのサイズから、さまざまなタイプのサイザーとそのプロパティの使用まで、すべてが手で書かれました。 そうすれば、何をどこで、どのように、なぜ知っているので、時間を節約できます。 このアプリケーションにはライブラリ全体の完全な機能はありません。これは理解できます。wxは複雑で非常に膨大なライブラリです。ライブラリコンストラクタの完全な記述には膨大な時間がかかります。特別な必要はありません。 このアプリケーションを使用してフォームを急いで作成することは一度に価値がありません。ライブラリ全体の機能の30％をキャッチすることはできず、インターフェイスは3つのボタンと2つのイベントに制限されます。

はじめに

さまざまな種類のウィンドウとそのプロパティについて詳しく調べる前に、いくつかのポイントを学習する必要があります。これらのポイントがないと、ウィンドウの種類と方法を理解するのが難しくなります。
1.すべてのアイテムはサイザー内になければなりません。 Sizer（ wx.Sizer ）は、フォームのすべてのコンポーネントの場所を示す特定の非表示フォーム要素です。
2.階層は次のとおりです。フォーム（ wx.Frame ）にはサイザーがあり、コンテナーパネル（ wx.Panel ）がサイザーに追加され、別のサイザーがパネルに追加され、すべてのフォーム要素がこのサイザーに既に追加されています。
3.コンポーネントをサイザーに追加せずにパネルに追加するのは正しくありません （wxFormBuilderではこれを実行できません）。
4.すべてのコントロールのプロパティが完全に規定されていない場合があります。 テキスト入力フィールドのサイズが重要でない場合、標準として自動的に構築されます。

基本要素

wxにはいくつかのタイプのフォームがあります。
wx.Dialog-ダイアログボックス。
wx.Frame-標準機能（最小化（ wx.ICONIZE ）、最大化（ wx.MAXIMIZE ）、閉じる（ wx.Close ））を持つウィンドウを表す通常のフォーム。

コード内のwx.Frameの通常の表現：

wx.Frame.__init__ ( self, parent=None, id = wx.ID_ANY, title = u"NameWindow", pos = wx.DefaultPosition, size = wx.Size( int,int ), style = wx.CAPTION ) 

このコード行はフォームを初期化し、入力されたプロパティを使用してフォームを描画します。 ところで：

 wx.Frame.__init__ (self, parent = None) 

また、フォームを描画し、フォームのすべてのプロパティが標準になります。

selfとparentは 、任意の形式の2つの必須パラメーターです。

フォームの初期化を分析しましょう：
selfはクラスを表し、parentはこのウィンドウの親を表します。 id-各要素。ウィンドウは、要素にアクション、イベントにアクセスまたは割り当てるための独自のIDを持っています。 これを気にせず、-1またはwx.ID_ANYを設定することはできません-これは任意のIDを形式化します（各要素は独自の一意のIDを持つ必要があり、これを呼び出したり要素にアクションを割り当てるために使用できます。これが不要な場合は、IDを設定できますwx.ID_ANY値、実際は-1）。 title-ウィンドウのタイトル、 pos-画面上のxおよびy座標でのフォームの位置、 size-ピクセル単位のフォームのサイズ、style-ウィンドウスタイル ドキュメントであらゆる種類のスタイルを見ることができます。 いくつか注意してください：
wx.CAPTION-タイトル付きのトップバーを表示しますが、システムメニューはありません。 wx.STAY_ON_TOP-他のアプリケーションのウィンドウの最上部にとどまります。詳細を1つ説明します。複数のウィンドウにこのスタイルがある場合、アプリケーションの親階層の上位にあるウィンドウは「最上部」のままになります。 wx.SYSTEM_MENU- 「閉じる」ボタンがトップバーに表示されますが、アクティブではありません。

ダイアログとフレームの違いは次のとおりです。
1.ダイアログモーダルウィンドウ、つまり このウィンドウでアクションを実行するまで、ユーザーは開いている他のウィンドウに移動できません
このアプリケーション。
2.ダイアログウィンドウには既にパネルが含まれているため、ダイアログボックスにはサイザーのみが必要であり、すべての要素はこのサイザーに既に配置されている必要があります。
3.ダイアログボックスは、ボタン上の追加イベントなしで実行できます（詳細は後ほど）。

ライブラリが所有するさまざまなコントロールの豊富さは驚くべきものです。 ボタンからタブ付きのノートブックまで、すべてがあります（いくつかのタイプがあります）。

ここですべてのことを話すのは無意味です。数か月間続きますので、いくつかの要素について簡単に説明し、ほとんどすべてのコントロールと要素に標準的な瞬間を説明します。

最も単純な要素を次のコードに示します。

 class regexps ( wx.Frame ): def __init__( self, main, schema, table, connection ): wx.Frame.__init__ ( self, parent=None, id = wx.ID_ANY, title = u"Data Quality --     ", pos = wx.DefaultPosition, size = wx.Size( 510,477 ), style = wx.CAPTION|wx.STAY_ON_TOP|wx.TAB_TRAVERSAL ) sizer1 = wx.BoxSizer( wx.HORIZONTAL ) self.regexps_notebook = wx.Notebook( self, wx.ID_ANY, wx.DefaultPosition, wx.DefaultSize, 0 ) self.dq_params_tab = wx.Panel( self.regexps_notebook, wx.ID_ANY, wx.DefaultPosition, wx.DefaultSize, wx.TAB_TRAVERSAL ) 

タイプwx.Frameのウィンドウの初期化、 ご覧のとおり 、すべてのプロパティが存在します。 それらのいくつかは標準値に与えられます。 スタイルのレイアウトに注意する価値があります。 ウィンドウには、トップバーと、非アクティブな閉じるボタンとしてのシステムメニューが表示されます。 また、ウィンドウは常にアクティブです（ wx.STAY_ON_TOP ）。 サイザー発表。 サイザータイプwx.BoxSizerはボックスです。 すべてのエディメントが水平方向または垂直方向に次々に並んでいます（この場合は、 サイズ決定プログラムに渡された引数がwx.HORIZONTALに責任があります ）。 ノートブック広告（タブ付きパネル）。 最初に、彼には名前self.regexps_notebookが与えられました。これにより、任意のクラスメソッドから作成できます。 次に、プロパティを持つwx.Notebookコンポーネントの宣言、ラップトップに収まるパネルの発表です。 ラップトップに配置されたパネルは、すべてのタブのプラットフォームになることに注意してください。 また、パネルをラップトップタブとして配置する場合、個別のサイザーは必要ありません（これは、すべての要素がサイザーにある必要があるという事実と矛盾します。つまり、これはこのルールの例外です）

  sizer2 = wx.BoxSizer( wx.VERTICAL ) self.use_param_checkbox = wx.CheckBox( self.dq_params_tab, wx.ID_ANY, u" ", wx.DefaultPosition, wx.DefaultSize, 0 ) 

2番目のサイザーの発表。 サイザーの最小サイズ。 新しいチェックボックスコンポーネントを追加します。 self.dq_params_tabパネルに追加します、つまり ノートパソコンのタブに。

  sizer2.Add( self.use_param_checkbox, 0, wx.ALL, 5 ) self.params_quality_choices = [1,2,3,4,5,6,7,8,9,10] self.params_choice_pull = wx.Choice( self.dq_params_tab, wx.ID_ANY, wx.DefaultPosition, wx.DefaultSize, self.params_quality_choices, 0 ) #   ,        wx.Choice. self.params_choice_pull.SetSelection( 0 ) #     . self.static_line = wx.StaticLine( self.dq_params_tab, wx.ID_ANY, wx.DefaultPosition, wx.DefaultSize, wx.LI_HORIZONTAL ) 

重要なポイント。 作成したチェックボックスをパネル（タブ）上にあるサイザーに追加します。追加の構造は次のとおりです。これは表示パラメーターであり、この場合、elmenetはフルサイズで表示されます。0 （これは要素の比例であり、 5 （これは要素の境界線のサイズです）。次は値を持つドロップダウンリストの宣言です。これも omeschaetsyaタブ。

  sizer2.Add( self.static_line, 0, wx.EXPAND |wx.ALL, 5 ) self.static_text = wx.StaticText( self.dq_params_tab, wx.ID_ANY, u"  ", wx.DefaultPosition, wx.DefaultSize, 0 ) sizer2.Add( self.static_text, 0, wx.ALL, 5 ) self.weights_txt = wx.TextCtrl( self.dq_params_tab, validator = WeightsValidator() ) sizer2.Add( self.weights_txt, 0, wx.ALL, 5 ) 

ここに追加オプションがあります。 wx.EXPAND-これは、サイズに応じて、追加された要素の幅が拡大されることを意味します。 テキストフィールドを追加してwx.TextCtrlを入力します 。 ここには追加の検証オプションがあります 。 これについては、別のコードで説明します。

  self.dq_params_tab.SetSizer( sizer2 ) self.dq_params_tab.Layout() sizer2.Fit( self.dq_params_tab ) #    . self.regexps_notebook.AddPage( self.dq_params_tab, u" ", False ) self.regexps_tab = wx.Panel( self.regexps_notebook, wx.ID_ANY, wx.DefaultPosition, wx.DefaultSize, wx.TAB_TRAVERSAL ) sizer3 = wx.BoxSizer( wx.VERTICAL ) 

興味深い点に来ました。 パネル（ self.dq_params_tab ）にあるサイザー（ sizer2 ）にすべての要素を追加した後、サイザーをパネルの領域全体に「拡張」し、サイザーをパネルに固定する必要があります。

  regexps_listboxChoices = [] self.regexps_listbox = wx.ListBox( self.regexps_tab, wx.ID_ANY, wx.DefaultPosition, wx.DefaultSize, regexps_listboxChoices, wx.LB_HSCROLL|wx.LB_SINGLE ) #   (wx.grid.Grid).   ,   mysql, oracle, sqlite and etc.    ,   . self.check_grid = wx.grid.Grid( self.check_sql_tab, wx.ID_ANY, wx.DefaultPosition, wx.Size(480,407), wx.HSCROLL|wx.VSCROLL ) #   ,    . # Grid self.check_grid.CreateGrid( 5, 5 ) #   . self.check_grid.EnableEditing( False ) self.check_grid.EnableGridLines( True ) self.check_grid.EnableDragGridSize( False ) self.check_grid.SetMargins( 0, 0 ) #    # Columns self.check_grid.EnableDragColMove( False ) self.check_grid.EnableDragColSize( False ) self.check_grid.SetColLabelSize( 20 ) self.check_grid.SetColLabelAlignment( wx.ALIGN_CENTRE, wx.ALIGN_CENTRE ) #  . # Rows self.check_grid.AutoSizeRows( True ) self.check_grid.EnableDragRowSize( True ) self.check_grid.SetRowLabelSize( 40 ) self.check_grid.SetRowLabelAlignment( wx.ALIGN_CENTRE, wx.ALIGN_CENTRE ) 

リストボックス（ wx.ListBox ）を追加します。 オプションwx.LB_HSCROLL | wx.LB_SINGLEは、水平スクロールの存在と、リスト内の1つのアイテムのみを選択できることについて話します。 グリッドの作成。 さらにコメントのすべてが説明されています。

行が長いため、インデントの構文は少しあいまいです。 これはライブラリの構文です。

同様の要素の構造と配置はコードにありませんが、モジュール全体の完全なコードを実行すると、次のように表示されます（完全なコードに興味がある人は書いてください）：


最初のタブ

2番目のタブ

3番目のタブ。

建物リスト管理

最も単純な要素のいくつかを調べた後、さらに複雑なものに進みます。

コントロールシートは普遍的な要素であり、さまざまなアプリケーションで頻繁に見られます。

次に、ランダムデータのコントロールシートを作成するためのコードを分析します。

 class main_stat(listmix.ColumnSorterMixin): def __init__( self, rows, columns ): data = [] self.columns = columns self.rows = rows self.list = wx.ListCtrl(self.main.panelMainStat, 0, style=wx.LC_REPORT | wx.BORDER_NONE | wx.LC_EDIT_LABELS | wx.LC_SORT_ASCENDING | wx.LC_SINGLE_SEL) 

クラスを引数として宣言し、 listmix 'コンポーネントを渡し、列のデータをソートします。 次は、葉の制御の初期化で、すべての最も秘密が起こります。
列（ columns ）と行（ rows ）の名前を渡します 。 行を含むリストの長さは、列の名前を含むリストの長さと等しくなければなりません。 listcontrol self.listを呼び出して、プロパティを割り当てます。
プロパティに関して： wx.LC_REPORTスタイル-最上部の列名の形のリーフコントロール、表のような列の下のすべてのデータ、類似性の一種。 したがって、残りのスタイルは英語からの翻訳に基づいて理解できます。

  for col, text in enumerate(self.columns): self.list.InsertColumn(col, text) for item in rows: info = '%s:(%s)' % (col, item) data.append(info) index = self.list.InsertStringItem(sys.maxint, item[0]) for col, text in enumerate(item[1:]): self.list.SetStringItem(index, col+1, text) 

次に、少しunningなデータ生成アルゴリズム。 これはwxとは関係ないので、詳しくは説明しません。 しかし、ポイントは
コントロールシートのデータは次のようになっている必要があります。
rows = {1 :( "data0"、 "data0.1"、 "data0.2"）、2 :( "data1"、 "data1.0"、 "data1.1"、 "data1.2"）、... }
上記のアルゴリズムは、この形式にランダムデータをもたらします。

  self.list.SetSize((900, 200)) self.list.SetColumnWidth(0, 120) self.list.Bind(wx.EVT_LIST_COL_CLICK, self.OnColClick, self.list) self.list.Bind(wx.EVT_COMMAND_RIGHT_CLICK, self.OnRightClick) self.list.Bind(wx.EVT_LIST_ITEM_SELECTED, self.OnItemSelected) self.itemDataMap = data listmix.ColumnSorterMixin.__init__(self, 3) 

コントロールシートのサイズ、列のサイズ、イベントバインドを設定します（これについては後で説明します）。 以下は、実際に動作するコードではありません。
self.itemDataMapは、上記のように、データが並べ替えられずにリストコントロールに直ちに入力される時点で、指定されたデータと等しくなければなりません。

  def getColumnText(self, index, col): item = self.list.GetItem(index, col) return item.GetText() def OnRightClick(self, event): index = self.list.GetFirstSelected() print index def OnColClick(self, event): print ("OnColClick: %d\n" % event.GetColumn()) event.Skip() def OnItemSelected(self, event): self.currentItem = event.m_itemIndex self.data = (self.getColumnText(self.currentItem, 1), self.getColumnText(self.currentItem, 2), self.getColumnText(self.currentItem, 3), self.getColumnText(self.currentItem, 4))( True ) 

データのある行を右クリックすると、この行のシリアル番号が表示されます。 OnColClickメソッドは、列のシリアル番号を提供します。 そして、データのある行を選択するとき、変数の中にいます
self.dataリストには、選択したデータが書き込まれます（ここでは、 getColumnTextメソッドを使用して、各列からデータを取得します）。


構築されたリーフコントロールの例。

メニュー

それでは、アプリケーションの不可欠な部分であるメニューに移りましょう。

  self.menubar = wx.MenuBar( 0 ) self.BD = wx.Menu() self.m_menuItem1 = wx.MenuItem( self.BD, 1, u"  ", u'    ', wx.ITEM_NORMAL ) self.BD.AppendItem(self.m_menuItem1, ) self.m_menuItem2 = wx.MenuItem( self.BD, 2, u" \tCtrl+T", u'       ', wx.ITEM_NORMAL ) self.BD.AppendItem( self.m_menuItem2 ) self.m_menuItem3 = wx.MenuItem( self.BD, 3, u"  \tCtrl+Q", u'       ', wx.ITEM_NORMAL ) self.BD.AppendItem( self.m_menuItem3 ) 

メニューバー広告。 メニューバーは、ドロップダウンリストのあるすべてのメニュー項目が配置されるストリップです。 self.BD = wx.Menu（） -メニュー項目を作成してから追加します
self.BDのメニュー項目。 さらに詳しく分析しましょう。

 self.m_menuItem1 = wx.MenuItem( self.BD, 1, u"  ", u'    ', wx.ITEM_NORMAL ) 

wx.MenuItem （ メニューにメニュー項目、ID、名前\ホットキー、ステータスバーに表示されるヘルプテキスト（ある場合）、メニュー項目の種類を追加します ）
名前の後に、 \ t （タブ文字）の後にホットキーが続きます。クリックすると、アクティブな場合にメニュー項目が呼び出されます。 このイベントを追加で処理する必要はありません。
メニュー項目のタイプは異なる場合があります。
wx.ITEM_RADIO-ラジオボタンのビデオ内のアイテム、 wx.ITEM_CHECK-チェックボックスの形式、
次に、同じ方法でいくつかのメニュー項目を追加します。

  self.statusbar = self.CreateStatusBar( 1, wx.ST_SIZEGRIP, wx.ID_ANY ) self.BD.Enable(2, False) self.statusbar.SetStatusText(u'  ,       ,        .') 

ステータス行の作成。 そして、メニュー項目の1つを非アクティブとして表示します。 True引数は、それをアクティブにします。 また、クラスの初期化直後にテキストをステータスバーに追加します。


そして、ここにメニューがあります。

イベント駆動型環境

あらゆる要素、あらゆるフォームがユーザーの影響を受けます。 wxPythonライブラリーを使用すると、ユーザーだけでなくプログラムも含めて、絶対にあらゆるユーザーアクションを記述できます。
イベントを宣言するためのルールから始めましょう。 ボタンがあります：

 self.ok_btn = wx.Button( self.m_panel5, wx.ID_ANY, u"OK", wx.DefaultPosition, wx.DefaultSize, 0 ) 

そして、ボタンを押してプログラムに2 + 2を追加します。

 self.ok_btn.Bind( wx.EVT_BUTTON, self.OnOk ) #     # self.Bind( wx.EVT_BUTTON, self.OnOk, self.ok_btn ) def OnOk(self, event): a = 2+2 print a 

OnOkメソッドは、ボタンをクリックするだけで機能します。 実際、これがイベントの全体的なポイントです。 違いは、wx.EVT_BUTTON（処理中のイベント内）と、このイベントをハングさせる要素（この場合、self.ok_btnボタン）のみです。

 # 1 self.Bind(wx.EVT_MENU, self.About, id=10) # 2 self.Bind( wx.EVT_IDLE, self.OnInit ) 

イベント番号1は対応するメニュー項目を押すとトリガーされ、フォームがアイドル状態（ユーザーが非アクティブ）の場合はイベント番号2が表示されます。

バリデーター

予期されるエラーから保護するために、ユーザーはテキストフィールドを検証する必要があります。 これを行うために、wxはバリデーター -自己記述チェックを提供します。 ビルトインチェックがないため、各バリデータを記述する必要があります。

以下に説明付きの例を示します。

 class Numbers(wx.PyValidator): def __init__(self): wx.PyValidator.__init__(self) self.Bind(wx.EVT_CHAR, self.OnChar) def Clone(self): return Numbers() def Validate(self, win): tc = self.GetWindow() val = tc.GetValue() for x in val: if x not in string.digits: return False return True def OnChar(self, event): key = event.GetKeyCode() try: # 8    backspace if chr(key) in string.digits or chr(key) == '.' or key == 8: event.Skip() else: return False except ValueError, info: print chr(key) print info return 

引数を持つクラスを作成し、このクラスがバリデータであることを示すwx.PyValidatorを渡します。
OnCharメソッドはself.Bindイベント（wx.EVT_CHAR、self.OnChar）によって記述され、キーボードから文字が入力されたときに実行されます。 key = event.GetKeyCode（）コマンドを使用して、押すたびにコードをキャッチし、組み込みのchr（）関数が、押されたキーの通常の表現にコードシンボルを変換します。 string.digitsには0から9までの数字のリストが含まれ、文字列クラスにはキーボードから入力されるほとんどすべての文字が16進数まで含まれています （残念ながらASCII文字もありますが、ロシア語は私が理解している限り、入力しません）

検証方法
tc = self.GetWindow（）は、テキストフィールドが配置されているウィンドウを定義し、入力された値を検証してから検証サイクルを行います。 このバリデーターは、数字、ピリオド、バックスペース以外の単一のキーをユーザーが押すことを許可しません。 バックスペースといえば、wxはすべてのキー、たとえばwx.WXK_Numpad0を記述しますが、バックスペースはありません。F1からNumlockまですべてがあるため、キー値を追跡する必要がありました。

バリデータを記述した後、テキストフィールドを定義し、それに対応するバリデータをポイントする必要があります。

 self.ip_ctrl = wx.TextCtrl( self.m_panel5, wx.ID_ANY, wx.EmptyString, wx.DefaultPosition, wx.Size( 190,-1 ), 0, Numbers() ) 

それだけです。 記事は非常にボリュームがあり、少し厄介であることが判明しました。 これは、たとえばwx.ListCtrlにバインドできるすべてのプロパティとイベントの説明を開始すると、記事はこれ以上のものになるためです。 記事が気に入って続行するのが理にかなっている場合は、次の記事を書き始め、ライブラリの他の要素と機能、たとえばwx.auiを明らかにします-これはタブ付きの高度なノートブックで、展開する場所があります。

ご清聴ありがとうございました。

追加：
コード
クラス正規表現（wx.Frame）：

def __init __（self、main、schema、table、connection）：

wx.Frame .__ init__（self、parent = None、id = wx.ID_ANY、...）

superを使用してより適切に書き換えることができます。

クラス正規表現（wx.Frame）：

def __init __（self、main、schema、table、connection）：

super（正規表現、自己）.__ init__（親=なし、id = wx.ID_ANY、...）

によって