Difference between revisions of "JA/Documentation/BASIC Guide/Events"
(New page: {{JA/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=Documentation/BASIC Guide/Properties |NextPage=Documentation/BASIC Guide/Control Elements |dial=block ...) |
|||
Line 8: | Line 8: | ||
{{DISPLAYTITLE:イベント}} | {{DISPLAYTITLE:イベント}} | ||
− | {{OOo}} のダイアログとフォームは、イベント指向型のプログラミングモデルを基に構築されているため、各コントロール要素に対しては'''イベントハンドラ''' | + | {{OOo}} のダイアログとフォームは、イベント指向型のプログラミングモデルを基に構築されているため、各コントロール要素に対しては'''イベントハンドラ'''を指定できます。イベントハンドラは、特定のアクションが発生すると、定義済みの手順を実行します。イベントハンドラを利用して、ドキュメントの編集やデータベースのオープンをはじめ、他のコントロール要素へのアクセスもできます。 |
− | {{OOo}} | + | {{OOo}} のコントロール要素は、様々な状況で発生する各種のイベントに対応しています。これらのイベントは、4 つのグループに分かれます。 |
− | * '''''' | + | * '''マウス制御''': マウスの動作に関係するイベント (たとえば単なるマウスポインタの移動や、画面上の特定部分のクリックなど) |
− | * '''''' | + | * '''キーボード制御''': キーボードのキーストロークで発生するイベント |
* '''フォーカス変更''': コントロール要素が有効化または無効化されている場合に、{{OOo}} が実行するイベント。 | * '''フォーカス変更''': コントロール要素が有効化または無効化されている場合に、{{OOo}} が実行するイベント。 | ||
* '''コントロール要素固有のイベント''': 特定のコントロール要素のみに発生するイベント。 | * '''コントロール要素固有のイベント''': 特定のコントロール要素のみに発生するイベント。 | ||
− | イベントを利用した処理を行う場合は、{{OOo}} | + | イベントを利用した処理を行う場合は、{{OOo}} の開発環境で関連するダイアログを構築して、必要なコントロール要素やドキュメント (イベントをフォームに適用する場合) を用意しておく必要があります。 |
[[Image:documentation_basicguide_dlg_03.gif|none|thumb|500px|OpenOffice.org Basic の開発環境]] | [[Image:documentation_basicguide_dlg_03.gif|none|thumb|500px|OpenOffice.org Basic の開発環境]] | ||
− | + | 上の図は {{OOo}} Basic の開発環境を示したもので、このダイアログウィンドウには 2 つのリストボックスが配置されています。2 つのリストボックスの間に配置されたボタンを使って、リスト内の各項目を相互に移動できます。 | |
− | + | このレイアウトを画面に表示させる場合は、イベントハンドラからの呼び出し用の手続きを {{OOo}} Basic のコード内に作成するようにしてください。このような手続きは、任意のモジュール内に記述できますが、使用するモジュールは 2 つまでにすることが推奨されます。またプログラムコードの可読性を高める観点からも、これらの手続き名には、その機能を簡潔に示す名前をつけておくべきです。マクロから汎用プログラムの手続きに直接ジャンプさせると、プログラムコードが不明瞭になる可能性があります。バグ修正も含めたプログラムコード全体の管理性を高めておくには、たとえそれがターゲットとなる手続きを呼び出すだけの処理であっても、イベントハンドル用のエントリポイントとして利用する手続きを 1 つ別途作成するようにしてください。 | |
− | + | 次のサンプルコードは、ダイアログ上に配置された左側のリストボックス内の項目の 1 つを、右側のリストボックスへ移動します。 | |
<source lang="oobas"> | <source lang="oobas"> | ||
Line 49: | Line 49: | ||
[[Image:documentation_basicguide_dlg_02.gif|none|thumb|400px|Assign Macro ダイアログ]] | [[Image:documentation_basicguide_dlg_02.gif|none|thumb|400px|Assign Macro ダイアログ]] | ||
− | このダイアログには、{{OOo}} Basic | + | このダイアログには、{{OOo}} Basic に記述したすべての手続きが表示されます。該当するイベントに手続きを割り当てるには、手続きを選択して、'''割り当て'''ボタンをクリックします。 |
− | == | + | ==パラメータ== |
− | + | 特定のイベントの発生だけでは、どのような処理を行うかの判定ができない場合もあります。そのようなケースでは、何らかの追加情報が必要となります。たとえばマウスクリックに関する処理では、どの位置でマウスボタンが押されたかの情報が必要になることもあります。 | |
− | {{OOo}} Basic | + | {{OOo}} Basic では、次に示すように、オブジェクトパラメータを使用して、イベントについての詳細情報を手続きに渡すことができます。 |
<source lang="oobas"> | <source lang="oobas"> | ||
Line 65: | Line 65: | ||
<tt>Event</tt> オブジェクトの構造と属性は、手続き呼び出しを発生させるイベントタイプにより異なります。 | <tt>Event</tt> オブジェクトの構造と属性は、手続き呼び出しを発生させるイベントタイプにより異なります。 | ||
− | + | いずれのイベントタイプにせよ、すべてのオブジェクトは、関連するコントロール要素およびモデルへのアクセスを提供します。コントロール要素には、<tt>Event.Source</tt> および <tt>Event.Source.Model</tt> を使用したそのモデルでアクセスできます。 | |
− | + | これらの属性は、イベントハンドラ内で特定のイベントをトリガーする際に使用します。 | |
− | == | + | ==マウスイベント== |
− | {{OOo}} Basic | + | {{OOo}} Basic では次のマウスイベントを利用できます。 |
;<tt>Mouse moved</tt>:ユーザーによるマウスポインタの移動。 | ;<tt>Mouse moved</tt>:ユーザーによるマウスポインタの移動。 | ||
Line 79: | Line 79: | ||
;<tt>Mouse outside</tt>:ユーザーによるマウスポインタの現在のウィンドウ外への移動。 | ;<tt>Mouse outside</tt>:ユーザーによるマウスポインタの現在のウィンドウ外への移動。 | ||
− | これらのイベントを扱うためのイベントオブジェクトは <idl>com.sun.star.awt.MouseEvent</idl> | + | これらのイベントを扱うためのイベントオブジェクトは <idl>com.sun.star.awt.MouseEvent</idl> 構造体として定義されており、次の情報を取り扱うことができます。 |
;<tt>Buttons (short)</tt>:押されたボタン ( <idl>com.sun.star.awt.MouseButton</idl> に定められた 1 つ以上の定数)。 | ;<tt>Buttons (short)</tt>:押されたボタン ( <idl>com.sun.star.awt.MouseButton</idl> に定められた 1 つ以上の定数)。 | ||
;<tt>X (long)</tt>:ピクセル単位で指定した、コントロール要素の左上隅を原点とするマウスポインタの X 座標。 | ;<tt>X (long)</tt>:ピクセル単位で指定した、コントロール要素の左上隅を原点とするマウスポインタの X 座標。 | ||
;<tt>Y (long)</tt>:ピクセル単位で指定した、コントロール要素の左上隅を原点とするマウスポインタの Y 座標。 | ;<tt>Y (long)</tt>:ピクセル単位で指定した、コントロール要素の左上隅を原点とするマウスポインタの Y 座標。 | ||
− | ;<tt>ClickCount (long)</tt>:マウスイベントに関係したクリック数 ( | + | ;<tt>ClickCount (long)</tt>:マウスイベントに関係したクリック数 (ダブルクリックは、{{OOo}} が十分高速に反応できる場合、1 つのイベントを開始するだけなので、<tt>ClickCount</tt> によるカウントも 1 となる)。 |
− | <idl>com.sun.star.awt.MouseButton</idl> | + | <idl>com.sun.star.awt.MouseButton</idl> に定義されているマウスボタン関連の定数は、次のものです。 |
;<tt>LEFT</tt>:マウスの左ボタン。 | ;<tt>LEFT</tt>:マウスの左ボタン。 | ||
Line 92: | Line 92: | ||
;<tt>MIDDLE</tt>:中央マウスボタン。 | ;<tt>MIDDLE</tt>:中央マウスボタン。 | ||
− | + | 次のサンプルコードでは、マウスボタンのクリック位置と押されたボタンを表示します。 | |
<source lang="oobas"> | <source lang="oobas"> | ||
Line 121: | Line 121: | ||
{{Documentation/Note|VBA に用意されている <tt>Click</tt> および <tt>Doubleclick</tt> イベントは {{OOo}} Basic では利用できません。{{OOo}} Basic では <tt>MouseUp</tt> イベントの代わりに <tt>click</tt> イベントを使用し、<tt>Doubleclick</tt> イベントについてはアプリケーションロジックの変更で対処します。}} | {{Documentation/Note|VBA に用意されている <tt>Click</tt> および <tt>Doubleclick</tt> イベントは {{OOo}} Basic では利用できません。{{OOo}} Basic では <tt>MouseUp</tt> イベントの代わりに <tt>click</tt> イベントを使用し、<tt>Doubleclick</tt> イベントについてはアプリケーションロジックの変更で対処します。}} | ||
− | == | + | ==キーボードイベント== |
− | {{OOo}} Basic | + | {{OOo}} Basic では次のキーボードイベントを利用できます。 |
;<tt>Key pressed</tt>:ユーザーによるキーの押し下げ。 | ;<tt>Key pressed</tt>:ユーザーによるキーの押し下げ。 | ||
;<tt>Key released</tt>:ユーザーによるキーの解放。 | ;<tt>Key released</tt>:ユーザーによるキーの解放。 | ||
− | + | どちらのイベントも、論理的 なキーアクションに対するもので、物理的 なキーアクションに直接対応するものではありません。つまり、1 つの文字の入力に複数キーのコンビネーションが必要な場合 (たとえば欧文のアクセント記号など)、これに対して {{OOo}} Basic が発生させるイベントは 1 つだけです。 | |
− | + | また Shift キー や Alt キーなどの修飾キーを単独で押しても、それだけでは独立したイベントは発生しません。 | |
− | {{OOo}} Basic | + | {{OOo}} Basic は、押されたキーに関する情報を、イベントオブジェクトによりイベントハンドル用手続きに渡します。この場合は、次の属性を利用できます。 |
;<tt>KeyCode (short)</tt>:押されたキーのコード (<idl>com.sun.star.awt.Key</idl> に定められたデフォルト値)。 | ;<tt>KeyCode (short)</tt>:押されたキーのコード (<idl>com.sun.star.awt.Key</idl> に定められたデフォルト値)。 | ||
;<tt>KeyChar (String)</tt>:入力された文字 (修飾キーによる効果も含めた結果)。 | ;<tt>KeyChar (String)</tt>:入力された文字 (修飾キーによる効果も含めた結果)。 | ||
− | + | 次のサンプルコードでは、<tt>KeyCode</tt> 属性を利用して、Enter キーや Tab キーなどの制御用キーのうち何が押されたかを判定します。これらの制御用キーが押されていた場合は、該当するキーの名前を表示し、それ以外の場合は、入力された文字を表示します。 | |
<source lang="oobas"> | <source lang="oobas"> | ||
Line 171: | Line 171: | ||
キーボード処理に使用するその他の定数については、『API Reference』の <idl>com.sun.star.awt.Key</idl> グループの定数値を参照してください。 | キーボード処理に使用するその他の定数については、『API Reference』の <idl>com.sun.star.awt.Key</idl> グループの定数値を参照してください。 | ||
− | == | + | ==フォーカスイベント== |
− | + | フォーカスイベントは、コントロール要素へのフォーカス移動を判定するためのものです。たとえばユーザーが特定のコントロール要素での処理を終えたかを判定してから、ダイアログ上にある他のコントロール要素を更新するような場合、このイベントが利用できます。以下に、利用できるフォーカスイベントを示します。 | |
;<tt>When receiving focus</tt>:要素がフォーカスを受け取ったとき。 | ;<tt>When receiving focus</tt>:要素がフォーカスを受け取ったとき。 | ||
;<tt>When losing focus</tt>:要素がフォーカスを失ったとき。 | ;<tt>When losing focus</tt>:要素がフォーカスを失ったとき。 | ||
− | フォーカスイベント関係の <tt>Event</tt> | + | フォーカスイベント関係の <tt>Event</tt> オブジェクトは、次のように構成されています。 |
;<tt>FocusFlags (short)</tt>:フォーカスが変わります (<idl>com.sun.star.awt.FocusChangeReason</idl> に定められたデフォルト値)。 | ;<tt>FocusFlags (short)</tt>:フォーカスが変わります (<idl>com.sun.star.awt.FocusChangeReason</idl> に定められたデフォルト値)。 | ||
Line 184: | Line 184: | ||
;<tt>Temporary (Boolean)</tt>:一時的に失われたフォーカス。 | ;<tt>Temporary (Boolean)</tt>:一時的に失われたフォーカス。 | ||
− | == | + | ==コントロール要素の固有イベント== |
− | + | これまで説明したイベントは、すべてのコントロール要素でサポートされていますが、その他にも特定のコントロール要素についてのみ定義された固有なイベントが存在します。これらのうち特に重要なものは次のイベントです。 | |
;<tt>When Item Changed</tt>:コントロール要素の値の変更。 | ;<tt>When Item Changed</tt>:コントロール要素の値の変更。 | ||
Line 193: | Line 193: | ||
;<tt>When initiating</tt>:コントロール要素を動作させるアクションの実行 (ボタンの押し下げなど)。 | ;<tt>When initiating</tt>:コントロール要素を動作させるアクションの実行 (ボタンの押し下げなど)。 | ||
− | イベントを処理する場合、作動時のイベント<tt>When initiating</tt>などは、単にコントロール要素をクリックするだけで発生することがあるため、その扱いには注意が必要です (たとえばラジオボタンのクリック) | + | イベントを処理する場合、作動時のイベント <tt>When initiating</tt> などは、単にコントロール要素をクリックするだけで発生することがあるため、その扱いには注意が必要です (たとえばラジオボタンのクリック)。このような場合、コントロール要素のステータスが実際に変更されたかについてはチェックされません。このような「ブラインドイベント」による混乱を避けるには、変更前のコントロール要素の値を広域変数に保存しておき、イベント実行時にそうした値に変化があったかを確認するという手法が使えます。 |
<tt>Item Status Changed</tt> イベントには、次の属性を使用できます。 | <tt>Item Status Changed</tt> イベントには、次の属性を使用できます。 |
Revision as of 22:10, 27 November 2008
Apache OpenOffice のダイアログとフォームは、イベント指向型のプログラミングモデルを基に構築されているため、各コントロール要素に対してはイベントハンドラを指定できます。イベントハンドラは、特定のアクションが発生すると、定義済みの手順を実行します。イベントハンドラを利用して、ドキュメントの編集やデータベースのオープンをはじめ、他のコントロール要素へのアクセスもできます。
Apache OpenOffice のコントロール要素は、様々な状況で発生する各種のイベントに対応しています。これらのイベントは、4 つのグループに分かれます。
- マウス制御: マウスの動作に関係するイベント (たとえば単なるマウスポインタの移動や、画面上の特定部分のクリックなど)
- キーボード制御: キーボードのキーストロークで発生するイベント
- フォーカス変更: コントロール要素が有効化または無効化されている場合に、Apache OpenOffice が実行するイベント。
- コントロール要素固有のイベント: 特定のコントロール要素のみに発生するイベント。
イベントを利用した処理を行う場合は、Apache OpenOffice の開発環境で関連するダイアログを構築して、必要なコントロール要素やドキュメント (イベントをフォームに適用する場合) を用意しておく必要があります。
上の図は Apache OpenOffice Basic の開発環境を示したもので、このダイアログウィンドウには 2 つのリストボックスが配置されています。2 つのリストボックスの間に配置されたボタンを使って、リスト内の各項目を相互に移動できます。
このレイアウトを画面に表示させる場合は、イベントハンドラからの呼び出し用の手続きを Apache OpenOffice Basic のコード内に作成するようにしてください。このような手続きは、任意のモジュール内に記述できますが、使用するモジュールは 2 つまでにすることが推奨されます。またプログラムコードの可読性を高める観点からも、これらの手続き名には、その機能を簡潔に示す名前をつけておくべきです。マクロから汎用プログラムの手続きに直接ジャンプさせると、プログラムコードが不明瞭になる可能性があります。バグ修正も含めたプログラムコード全体の管理性を高めておくには、たとえそれがターゲットとなる手続きを呼び出すだけの処理であっても、イベントハンドル用のエントリポイントとして利用する手続きを 1 つ別途作成するようにしてください。
次のサンプルコードは、ダイアログ上に配置された左側のリストボックス内の項目の 1 つを、右側のリストボックスへ移動します。
Sub cmdSelect_Initiated Dim objList As Object lstEntries = Dlg.getControl("lstEntries") lstSelection = Dlg.getControl("lstSelection") If lstEntries.SelectedItem > 0 Then lstSelection.AddItem(lstEntries.SelectedItem, 0) lstEntries.removeItems(lstEntries.SelectItemPos, 1) Else Beep End If End Sub
この手続きを Apache OpenOffice Basic で記述したら、ダイアログエディタの属性ウィンドウを表示して、該当するイベントへの割り当てを行います。
このダイアログには、Apache OpenOffice Basic に記述したすべての手続きが表示されます。該当するイベントに手続きを割り当てるには、手続きを選択して、割り当てボタンをクリックします。
パラメータ
特定のイベントの発生だけでは、どのような処理を行うかの判定ができない場合もあります。そのようなケースでは、何らかの追加情報が必要となります。たとえばマウスクリックに関する処理では、どの位置でマウスボタンが押されたかの情報が必要になることもあります。
Apache OpenOffice Basic では、次に示すように、オブジェクトパラメータを使用して、イベントについての詳細情報を手続きに渡すことができます。
Sub ProcessEvent(Event As Object) End Sub
Event オブジェクトの構造と属性は、手続き呼び出しを発生させるイベントタイプにより異なります。
いずれのイベントタイプにせよ、すべてのオブジェクトは、関連するコントロール要素およびモデルへのアクセスを提供します。コントロール要素には、Event.Source および Event.Source.Model を使用したそのモデルでアクセスできます。
これらの属性は、イベントハンドラ内で特定のイベントをトリガーする際に使用します。
マウスイベント
Apache OpenOffice Basic では次のマウスイベントを利用できます。
- Mouse moved
- ユーザーによるマウスポインタの移動。
- Mouse moved while key pressed
- ユーザーによるキーを押しながらのマウスによるドラッグ。
- Mouse button pressed
- ユーザーによるマウスボタンの押し下げ。
- Mouse button released
- ユーザーによるマウスボタンの解放。
- Mouse outside
- ユーザーによるマウスポインタの現在のウィンドウ外への移動。
これらのイベントを扱うためのイベントオブジェクトは com.sun.star.awt.MouseEvent 構造体として定義されており、次の情報を取り扱うことができます。
- Buttons (short)
- 押されたボタン ( com.sun.star.awt.MouseButton に定められた 1 つ以上の定数)。
- X (long)
- ピクセル単位で指定した、コントロール要素の左上隅を原点とするマウスポインタの X 座標。
- Y (long)
- ピクセル単位で指定した、コントロール要素の左上隅を原点とするマウスポインタの Y 座標。
- ClickCount (long)
- マウスイベントに関係したクリック数 (ダブルクリックは、Apache OpenOffice が十分高速に反応できる場合、1 つのイベントを開始するだけなので、ClickCount によるカウントも 1 となる)。
com.sun.star.awt.MouseButton に定義されているマウスボタン関連の定数は、次のものです。
- LEFT
- マウスの左ボタン。
- RIGHT
- マウスの右ボタン。
- MIDDLE
- 中央マウスボタン。
次のサンプルコードでは、マウスボタンのクリック位置と押されたボタンを表示します。
Sub MouseUp(Event As Object) Dim Msg As String Msg = "Keys: " If Event.Buttons AND com.sun.star.awt.MouseButton.LEFT Then Msg = Msg & "LEFT " End If If Event.Buttons AND com.sun.star.awt.MouseButton.RIGHT Then Msg = Msg & "RIGHT " End If If Event.Buttons AND com.sun.star.awt.MouseButton.MIDDLE Then Msg = Msg & "MIDDLE " End If Msg = Msg & Chr(13) & "Position: " Msg = Msg & Event.X & "/" & Event.Y MsgBox Msg End Sub
キーボードイベント
Apache OpenOffice Basic では次のキーボードイベントを利用できます。
- Key pressed
- ユーザーによるキーの押し下げ。
- Key released
- ユーザーによるキーの解放。
どちらのイベントも、論理的 なキーアクションに対するもので、物理的 なキーアクションに直接対応するものではありません。つまり、1 つの文字の入力に複数キーのコンビネーションが必要な場合 (たとえば欧文のアクセント記号など)、これに対して Apache OpenOffice Basic が発生させるイベントは 1 つだけです。
また Shift キー や Alt キーなどの修飾キーを単独で押しても、それだけでは独立したイベントは発生しません。
Apache OpenOffice Basic は、押されたキーに関する情報を、イベントオブジェクトによりイベントハンドル用手続きに渡します。この場合は、次の属性を利用できます。
- KeyCode (short)
- 押されたキーのコード (com.sun.star.awt.Key に定められたデフォルト値)。
- KeyChar (String)
- 入力された文字 (修飾キーによる効果も含めた結果)。
次のサンプルコードでは、KeyCode 属性を利用して、Enter キーや Tab キーなどの制御用キーのうち何が押されたかを判定します。これらの制御用キーが押されていた場合は、該当するキーの名前を表示し、それ以外の場合は、入力された文字を表示します。
Sub KeyPressed(Event As Object) Dim Msg As String Select Case Event.KeyCode Case com.sun.star.awt.Key.RETURN Msg = "Return pressed" Case com.sun.star.awt.Key.TAB Msg = "Tab pressed" Case com.sun.star.awt.Key.DELETE Msg = "Delete pressed" Case com.sun.star.awt.Key.ESCAPE Msg = "Escape pressed" Case com.sun.star.awt.Key.DOWN Msg = "Down pressed" Case com.sun.star.awt.Key.UP Msg = "Up pressed" Case com.sun.star.awt.Key.LEFT Msg = "Left pressed" Case com.sun.star.awt.Key.RIGHT Msg = "Right pressed" Case Else Msg = "Character " & Event.KeyChar & " entered" End Select MsgBox Msg End Sub
キーボード処理に使用するその他の定数については、『API Reference』の com.sun.star.awt.Key グループの定数値を参照してください。
フォーカスイベント
フォーカスイベントは、コントロール要素へのフォーカス移動を判定するためのものです。たとえばユーザーが特定のコントロール要素での処理を終えたかを判定してから、ダイアログ上にある他のコントロール要素を更新するような場合、このイベントが利用できます。以下に、利用できるフォーカスイベントを示します。
- When receiving focus
- 要素がフォーカスを受け取ったとき。
- When losing focus
- 要素がフォーカスを失ったとき。
フォーカスイベント関係の Event オブジェクトは、次のように構成されています。
- FocusFlags (short)
- フォーカスが変わります (com.sun.star.awt.FocusChangeReason に定められたデフォルト値)。
- NextFocus (Object)
- フォーカスを受け取るオブジェクト (When losing focus イベントのみ)。
- Temporary (Boolean)
- 一時的に失われたフォーカス。
コントロール要素の固有イベント
これまで説明したイベントは、すべてのコントロール要素でサポートされていますが、その他にも特定のコントロール要素についてのみ定義された固有なイベントが存在します。これらのうち特に重要なものは次のイベントです。
- When Item Changed
- コントロール要素の値の変更。
- Item Status Changed
- コントロール要素の変更のステータス。
- Text modified
- コントロール要素の変更のテキスト。
- When initiating
- コントロール要素を動作させるアクションの実行 (ボタンの押し下げなど)。
イベントを処理する場合、作動時のイベント When initiating などは、単にコントロール要素をクリックするだけで発生することがあるため、その扱いには注意が必要です (たとえばラジオボタンのクリック)。このような場合、コントロール要素のステータスが実際に変更されたかについてはチェックされません。このような「ブラインドイベント」による混乱を避けるには、変更前のコントロール要素の値を広域変数に保存しておき、イベント実行時にそうした値に変化があったかを確認するという手法が使えます。
Item Status Changed イベントには、次の属性を使用できます。
- Selected (long)
- 現在選択されているエントリ。
- Highlighted (long)
- 強調表示されているエントリ。
- ItemId (long)
- エントリの ID。
Content on this page is licensed under the Public Documentation License (PDL). |