マクロを実行する方法

Toolbar

マクロは、ツール・バーに追加することができます。ツール・バーを変更する方法の詳細については、Chapter 4（メニューとツール・バー）を参照してください。

Menu item

Customizeダイアログを開く、そして、メニュー・タブを選択するために、Tools > Customizeを使用します。あなたは、既存のメニューを変更することができます。あるいは、マクロを呼び出す新しいメニューを作成します。メニューを変更する方法の詳細については、Chapter 4（メニューとツール・バー）を参照してください。

Keyboard shortcuts

Customizeダイアログを開く、そして、Keyboardタブを選択するために、Tools > Customizeを使用します。キーボード・ショートカットを割り当てることについては、Appendix A（キーボード・ショートカット）で説明されています。

Event

OpenOffice.orgでは、何かが生じるとき、私たちは、イベントが発生したと言います。例えば、文書が開かれた、キーが押さた、あるいは、マウスが移動した。OpenOffice.orgは、マクロを呼び出すために、イベントを発生させることができます。;マクロは、続いて、イベント・ハンドラを呼び出します。イベント・ハンドラを完全に網羅することは、この文書の範囲をかなり越えていますが、少しの知識で、多くのことを達成することができます。

あなたが、イベント・ハンドラを設定するときは、注意してください。例えば、あなたが、キーが押されるたびに、毎回、呼び出されますが、あなたが、ミスをして、イベントが、適切に処理されない、イベント・ハンドラを記述することを想定します。1つの起こりうる結果は、あなたのイベント・ハンドラが、すべてのキー入力を利用するため、OpenOffice.orgを強制終了する必要があります。

Customizeダイアログを開く、そして、Keyboardタブを選択するために、Tools > Customizeを使用します。キーボード・ショートカットを割り当てることについては、Appendix A（キーボード・ショートカット）で説明されています。

マクロを、アプリケーション・レベルのイベントに割り当てます。

一般的な使い方は、特定のマクロを呼び出すために、Open Documentイベントを割り当てることです。マクロは、続いて、文書のために、特定の設定タスクを実行します。目的のイベントを選択し、Macro Selectorダイアログを開くために、Macroボタンをクリックします。

マクロを、「ドキュメントを開く」イベントに割り当てます。

マクロをイベントに割り当てるために、目的のマクロを選択し、OKをクリックします。イベントがマクロに割り当てられたEventsタブを表示します。ドキュメントを開くとき、PrintHelloマクロが、実行されます。

文書内の多くのオブジェクトは、イベントが、発生するとき、マクロを呼び出すように設定することができます。最も一般的な使い方は、文書にボタンのようなコントロールを追加することです。画像をダブルクリックしても、あなたが、マクロをイベントに割り当てることができる、Macrosタブのダイアログを開きます。

原文「Extensions」

拡張は、パッケージです。それは、新しい機能を追加するために、OpenOffice.orgにインストールすることができます。拡張機能は、ほぼすべてのプログラミング言語で記述できます。そして、単純、あるいは、洗練されている場合があります。拡張は、型にグループ化することができます。：

• Calc Add-Inは、Calcのための新しい機能を提供します。通常の組み込み関数のように動作する、新しい関数が含まれています。
• 新しいコンポーネントと機能は、通常、新しいメニューやツール・バーのような、いくつかの水準のUIの統合が含まれています。
• Calcで、直接使用されるデータ・パイロット
• 新しいチャートの種類を持つChart Add-In
• スペルチェッカーのような言語コンポーネント
• ドキュメントのテンプレートと画像

それぞれの拡張は、別の場所で見つかりますが、以下に、extensionリポジトリーがあります。：http://extensions.services.openoffice.org/.

原文「Writing macros without the recorder」

このChapterで取り扱われる例は、マクロ・レコーダーとディスパッチャを使用して作成されます。また、あなたは、OpenOffice.orgで構成されるオブジェクトに直接アクセスするマクロを記述することができます。言い換えると、あなたは、文書を直接操作することができます。

OOoの内部のオブジェクトを、直接操作することは、高等なトピックです。それは、このChapterの範囲を越えています。単純な例ですが、これがどのように動作するかを示しています。

LISTING 4：現在のドキュメントにテキストの"Hello"を添付します。

  Sub AppendHello
    Dim oDoc
    Dim sTextService$
    Dim oCurs
 
    REM ThisComponent refers to the currently active document.
    oDoc = ThisComponent
 
    REM Verify that this is a text document  
    sTextService = "com.sun.star.text.TextDocument"
    If NOT oDoc.supportsService(sTextService) Then
      MsgBox "This macro only works with a text document"
      Exit Sub
    End If
 
    REM Get the view cursor from the current controller.
    oCurs = oDoc.currentController.getViewCursor()
 
    REM Move the cursor to the end of the document
    oCurs.gotoEnd(False)
 
    REM Insert text "Hello" at the end of the document
    oCurs.Text.insertString(oCurs, "Hello", False)  
  End Sub

原文「Finding more information」

マクロの作成に関するヘルプを提供する数多くのリソースが、利用できます。OOoヘルプ・ページを開くために、Help > OpenOffice.org Helpを使用します。OOoヘルプ・システムの左上角には、どのヘルプ設定が表示されるか決定するドロップダウンリストが含まれています。Basicのためのヘルプを調べるために、ドロップダウンは、OpenOffice.org BasicについてHelpを表示する必要があります。

オンライン・リソース

出版された資料