Chapter 11, Getting Started with Macros ノート¶

Introduction ¶

LibreOffice におけるマクロの意義は MS Office と同じようだ。

マクロを作成する最も簡単な方法は、オープンソースの LibreOffice Basic スクリプト言語を使用して LibreOffice の UI で一連の操作を記録することだ。これらのマクロは、組み込みの LibreOffice Basic Integrated Development Environment (IDE) を使用して、記録後に編集および拡張することが可能だ。

LibreOffice で最も強力なマクロは、スクリプト言語：

LibreOffice Basic
Python
JavaScript
BeanShell

のいずれかを使用して作成する。この章では既定のマクロスクリプト言語である LibreOffice Basic を中心にマクロ機能の概要を説明する。残りのスクリプト言語については、入門的な例をいくつか含むのみ。

Your first macros ¶

Adding a macro ¶

ここでは、本やインターネットで見つけた既存のマクロを使用することを想定している。マクロを手に入れたら、そのマクロを含むライブラリーとモジュールを作成する。その構成については Macro organization を見ろ。

Sub HelloMacro
    Print "Hello"
End Sub

マクロを含むライブラリーを作成する手順：

LibreOffice アプリケーションを何か開く。
Menu バー Tools‣Macros‣Organize Macros‣Basic… を選択する。
Organizer ボタンを押す。Basic Macro Organizer ダイアログボックスで Libraries タブを開く。
Location を既定の場所である My Macros & Dialogs に設定する。
New… ボタンを押す New Library ダイアログボックスが開く。
ライブラリー名を記入して OK ボタンを押す。ここでは TestLibrary とする。
Basic Macro Organizer ダイアログボックスに戻ったら Modules タブを開く。
Module 一覧で My Macros を展開し、ライブラリー TestLibrary を選択する。 Module1 というモジュールがすでに存在し、マクロを含めることができる。必要であれば New… ボタンを押して、ライブラリーに別のモジュールを作成可能。
Module1 選択し、Edit ボタンを押して IDE を開く。これを使ってマクロの作成、編集、実行、デバッグを行う。
新しいモジュールが作成されると、コメントと Main という空のマクロが含まれている。
新しいマクロを Sub Main の前か End Sub の後に追加する。

Tip

Main サブルーチンを削ってもかまわない。
（随意）マクロが期待どおりに記述されているかどうかを確認するには、 Macro ツールバー Compile 図像をクリックする。
Object Catalog ウィンドウの TestLibrary‣Module 1 で HelloMacro サブルーチンをダブルクリックし、
- Macro ツールバー Run 図像をクリックするか、
- F5 を押して、
モジュール内の HelloMacro サブルーチンを実行する。
OK ボタンを押して結果を閉じる。
モジュール内の任意のマクロを選択して実行するには、
- Standard ツールバー Select Macro 図像をクリックするか、
- Tools‣Organize Macros‣Basic… に進む。
マクロを選択し、Run ボタンを押す。

Recording a macro ¶

LibreOffice でマクロを記録するとき、実際にはプログラミング言語を使用して、特定の作業を実行するために必要な手順を記録する。たとえば、文書に同じ情報を繰り返し入力する必要がある場合、その都度手でコピー＆ペーストしなくても、自動的に情報を入力するマクロを作成すればいい。

Note

Writer の場合は AutoText 機能の使用も検討しろ。

Options ダイアログボックス LibreOffice‣Advanced ページを開き、Enable macro recording (may be limited) をオンにしてマクロ記録を動作するようにする。

マクロの記録を開始するには、Tools‣Macros‣Record Macro を選択する。マクロ記録中であることを示す小さなダイアログボックスが現れる。
マクロ実行時になったら入力したいテキストを文書に入力する
ミニダイアログの Stop Recording を押す。これにより BASIC Macros ダイアログボックスが開く。
My Macros を開く。
My Macros‣Standard
Standard ライブラリーを選択し、マクロを保存する既存のモジュールを選択する。
Macro Name を入力する。この説明では EntryMyName とする。
Save ボタンを押してマクロを保存し、BASIC Macros ダイアログボックスを閉じる。

上記のすべての手順を実行すると、選択したモジュール内に EnterMyName というマクロが作成される。

Running a macro ¶

Tools‣Macros‣Run Macro… でマクロ選択ダイアログを開く。
例えば、新しく作成したマクロ EnterMyName を選択し、Run ボタンを押す。
または、Tools‣Macros‣Organize Macros‣Basic… で BASIC Macros ダイアログボックスを開き、マクロを選択して Run ボタンを押す。

Viewing and editing macros ¶

作成したマクロを表示、編集するには：

Tools‣Macros‣Organize Macros‣Basic… で BASIC Macros ダイアログボックスを開く。
新しいマクロ EnterMyName を選択し Edit ボタンを押す。IDE が開き、マクロコードが表示される。

Commenting with REM¶

Basic マクロコードのコメントは REM や単引用符から始まり行末で終わる。

Defining subroutines with SUB¶

個々のマクロはサブルーチンに格納される。サブルーチンはキーワード SUB で始まり、終わりは END SUB で示される。

引数を取るサブルーチンを書くことができる。これはサブルーチンをゼロから作成する場合にのみ可能だ。LibreOffice に記録されたマクロは引数を受け付けない。
サブルーチンのもう一つの種類は関数と呼ばれるもので、これは処理の結果として値を返すサブルーチンだ。関数は先頭に FUNCTION というキーワードをつけて定義する。LibreOffice に記録されたマクロはサブルーチンのみを定義する。

Defining variables using DIM¶

変数を定義するときは DIM キーワードを使用する。

EnterMyName マクロでは、変数 document と dispatcher は object 型として定義されている。その他の一般的な変数型には文字列、整数、日付がある。配列型の変数は一つの変数に値を複数格納することができる。配列は通常ゼロから始まる。

Explaining macro code¶

割愛。ここに何かを綴るよりは本書を直接当たるほうがいい。

Creating a macro ¶

マクロを作成する場合、記録する前に次を思うことが重要だ：

作業を単純なコマンドセットとして書けるか。
マクロの最終コマンドで、カーソルが次のコマンドに対応できる状態になるようにステップを配置できるか。あるいは、使用者が対象文書のテキストやデータ入力に戻れるようにできるか。

A more complex example of a macro ¶

ある一般的なマクロ作業は、Web サイトからデータの行と列をコピーし、テキスト文書で表として整形することだ。通常、このマクロは次のように動作する：

Web サイトからデータをクリップボードにコピーする。
おかしな書式や書体を避けるため、書式なしのテキストとして Writer 文書に貼り付ける。
Table‣Convert‣Text to Table… を使えるように、列間にタブを入れてテキストを再整形する。

上記の二つの問いを念頭に置いて、テキストを検査し、整形するマクロを記録できることを確認する。コピーされたデータの例として、Web 上のどこかにある FontWeight 定数を説明するテキストを考える。この例の最初の列は定数名を示し、それぞれの後には空白とタブが続き、各行の末尾には二つの空白がある。

実際には間にタブ文字があったり行末に空白文字があったりする¶

DONTKNOW       The font weight is not specified/known.
THIN           specifies a 50% font weight.
ULTRALIGHT     specifies a 60% font weight.
LIGHT          specifies a 75% font weight.
SEMILIGHT      specifies a 90% font weight.
NORMAL         specifies a normal font weight.
SEMIBOLD       specifies a 110% font weight.
BOLD           specifies a 150% font weight.
ULTRABOLD      specifies a 175% font weight.
BLACK          specifies a 200% font weight.

この例では、表の一列目に書体の太さの数値を、二列目に定数名を、三列目にテキストの説明を記録する。この作業はある行を除けば簡単に達成する。以下は、カーソルがテキスト THIN から始まる行の先頭にあると仮定して、キーストロークを使用してこのマクロを記録する手順だ。

マクロ記録が作動する状態であることを確認する。
Tools‣Macros‣Record Macro 選択。マクロ記録開始。
キーボードのみで先ほどのテキストを編集する。細かい記述は割愛。
マクロの記録を停止し、マクロを保存する。Recording a macro を見ろ。

マクロを実際に記録するよりも、これらの手順を読んで書く方がはるかに時間がかかる。

このマクロを実行するには、記録されたステップを適用したい行の先頭にカーソルを置く。次に Tools‣Macros‣Run Macro… を選択し、CopyNumToCol1 マクロを選択して Run ボタンを押す。

読者ノート

生成されたコードをよく観察すると、キーバインドに対応するコマンドがそのまま記述されていることがわかる。Ctrl + → を押す、ではなく、GoToNextWord を実行する、のような表現だ。

上記の手順は、マクロ作成時に想定した書式に一行目が従っている場合にのみ正しく機能することに注意。このマクロを DONTKNOW や NORMAL の行で実行すると、これらの行は書式が異なるので、結果は期待どおりにはならない。

Running a macro quickly ¶

Tools‣Macros‣Run Macro… でマクロを繰り返し実行するのは不便なので、キーバインドを割り当てて、マクロを素速く起動する。CopyNumToCol1 マクロに Ctrl + K を割り当てる手順：

Tools‣Customize… を選択して Customize ダイアログボックスを開く。
Keyboard タブを開く。
下側を適当に選択して CopyNumToCol1 マクロを選択する。
上側からキーバインド Ctrl + K を選択して CopyNumToCol1 マクロに割り当てるのに Assign ボタンを押す。

Limitations of the macro recorder ¶

Macro Recorder には記録できない動作がある。この制限がどこから生じるのかを見ていく。

Understanding the dispatch framework ¶

例えば Menu バー File‣Save 選択やキーバインド Ctrl + S や Standard ツールバー Save 図像クリックは、それらが「ファイルを保存するコマンド」を何かに発送する。コマンドが処理可能な何かにまで到着すると、ファイル保存が実際に実行される。

発送コマンドはテキストであり、例えば .uno:GoToStartOfLine のようなものだ。

How the macro recorder uses the dispatch framework ¶

Macro Recorder は発送フレームワークが生成するコマンドしか登録しないが、そのようなコマンドがすべて完了するというわけでもない。たとえば、物体を入れると次のようなコードが生成される：

dispatcher.executeDispatch(document, ".uno:InsertObject", "", 0, Array())

どのような物体を作成するかを指定することは不可能だ。物体をファイルから入れる場合、どのファイルを入れるかを指定できない。マクロの記録中に Options ダイアログボックスを使用して設定項目を開いて変更した場合、生成されたマクロは設定の変更を記録しない（コメントアウトされたコード片が生じる）。

ダイアログボックスを何か開くとコマンドは生成するが、ダイアログボックス内で行われた作業は通常記録されない。Macro Recorder が何を捉えることができるかは、試してみるまでわからない（例えば、検索ダイアログボックスからの動作は適切に捉えられる）。

Other options ¶

Macro Recorder を使っても解決できない問題があるときに、LibreOffice 物体を使用して実際のコードを記述する。LibreOffice 物体を学ぶのはたいへんだ。

Macro organization ¶

LibreOffice では「マクロ ⊂ モジュール ⊂ ライブラリー ⊂ コンテナー」という構造をとる。モジュールは通常、使用者との対話や計算などの機能を分割する。個々のマクロはサブルーチンや関数だ。

Tools‣Macros‣Organize Macros‣Basic… を選択し、BASIC Macros ダイアログボックスを開く。利用可能なコンテナーはすべて Macro From 一覧に表示され、文書はそれぞれライブラリーを複数含むことができるコンテナーだ。アプリケーション自体が二つのコンテナーとして機能する。一つは LibreOffice とともに配布されるマクロ用のコンテナーで LibreOffice Macros と呼ばれ、もう一つは個人用マクロ用のコンテナーで My Macros と呼ばれる。

LibreOffice Macros はアプリケーション実行時コードと一緒に保存され、基本、編集不可だ。LibreOffice Macros コンテナーには独自のマクロを保存してはいけない。

マクロが単一の文書にしか適用されない場合を除き、マクロは My Macros コンテナーに格納される。My Macros コンテナーは使用者領域またはホームディレクトリーに保存される。

利用者ノート

Windows ならば APPDATA とか USERPROFILE だ。

マクロが文書に含まれている場合、記録されたマクロはその文書上で動作しようとする。というのも、その動作には主に ThisComponent を使用しているからだ。

すべてのコンテナーは Standard という名前のライブラリーを含む。Standard ライブラリーを使用する代わりに、意味のある名前を持つ独自のライブラリーを作成するのが良い。Standard とは異なり、独自のライブラリーを他のコンテナーにインポートすることが可能だ。

Caution

LibreOffice では、ライブラリーをコンテナーにインポートすることは可能だが、 Standard という名前のライブラリーを上書きすることはできない。そのため、 Standard ライブラリーにマクロを保存すると、そのマクロを別のコンテナーにインポートできなくなる。

モジュールにも意味のある名前をなるべくつけろ。

My Macros という名前のコンテナーに保存されたマクロはすべての文書で使用可能だ。文書にマクロを保存するのは、文書が共有され、マクロを文書に含めたい場合に便利だ。

Standard ライブラリーと Template ライブラリーは自動的にロードされるが、その他のライブラリーマクロは、それらを含むライブラリーがロードされるまで使用可能にならない。ロードされたライブラリーはロードされていないそれとは表示が異なる。ライブラリーとそれに含まれるモジュールをロードするには、ライブラリーをダブルクリックする。

Where are macros stored?¶

LibreOffice は、使用者固有のデータをホームディレクトリー内のフォルダーに保存する。設定データの保存場所を確認するには、Options ダイアログボックス LibreOffice‣Paths ページを開く。Basic で記述された使用者マクロは LibreOffice/4/user/basic に保存される。

Exporting macros ¶

マクロライブラリーをエクスポートして、再利用したり他の人と共有したりしたい場合は LibreOffice Basic Macro Organizer を用いる。

Tools‣Macros‣Organize Macros‣Basic… を選択し、Organizer ボタンを押す。
Libraries タブをクリックし、エクスポートしたいライブラリーを選択する。
Export… ボタンを押し、Export as BASIC Library を選択する。
ライブラリーの保存先を選択し、保存 (S) ボタンを押す。

ライブラリーがエクスポートされると、LibreOffice はライブラリーに関連するすべてのファイルを含むフォルダーを作成する。

読者ノート

拡張子 .xlb, .xba を持つファイルがある。

Importing macros ¶

Basic Macro Organizer ダイアログボックスではマクロライブラリーを文書にインポートしたり、ライブラリー、モジュール、ダイアログボックスの作成、削除、名前の変更が行える。

Libraries タブで使用するコンテナーを選択し、Import… ボタンを押してマクロライブラリーをインポートする。
インポートするライブラリーのあるフォルダーに移動する。dialog.xlb と script.xlb のどちらかを選択できる。どちらのファイルを選択しても、マクロをインポートできる。文書に含まれるライブラリーをインポートするには文書ファイルを選択する。
ファイルを選択し、開く (O) ボタンを押して続行し、Import Libraries ダイアログボックスを開く。
ライブラリーをインポートするための選択肢を選択する。
OK ボタンを押すと選択したマクロライブラリーがインポートされる。

Downloading macros to import ¶

LibreOffice 社会が作成したマクロをインターネット上で見つけることができる。マクロには、文書に含まれているもの、通常のファイルとしてインポートする必要があるもの、テキストとして公開されていて Basic IDE にコピー＆ペーストする必要があるものがあります。マクロをライブラリーに追加する方法については Adding a macro を、 Basic IDE を使用してマクロを編集する方法については Viewing and editing macros をそれぞれ見ろ。

How to run a macro ¶

マクロを Tools‣Macros‣Run Macro… で実行するのは、マクロを頻繁に使用する場合は効率的ではない。マクロにキーバインドを割り当てることもできるが、ツールバー図像、メニュー項目、イベント、文書埋め込みボタンにマクロを接続することも可能だ。どの方法を採用するかを決めるのに、次のような質問をするのもよい：

マクロは一つの文書だけで利用できるようにすべきか、それともすべての文書で利用できるようにしたいか？
マクロは Calc 文書など特定の文書型用か？
マクロの使用頻度は？

その答えによって、マクロの保存場所と実行形態が決まる。例えば、めったに使わないマクロをツールバーに追加することはないだろう。選択肢を決めるのに、次の判断基準表を検討するといい（興味深いのでそのまま引用する）：

Where to store a macro¶
格納場所	全ソフト	特定ソフト	文書専用
ツールバー	No	Yes	Yes
メニュー	No	Yes	Yes
キーバインド	Yes	Yes	No
イベント	Yes	No	Yes

Events ¶

LibreOffice では、たとえば、文書を開く、変更された状態が変化する、マウスカーソルを移動するなどはすべてイベントだ。イベントを引き金としてマクロを実行し得る。マクロはイベントハンドラーと呼ばれる。

Caution

イベントハンドラーを設定する際には注意が必要だ。たとえば、文書が変更されるたびに呼び出されるイベントハンドラーを書くときに、そのイベントが正しく処理されないと、問題が発生し得る。その結果、イベントハンドラーが LibreOffice を強制終了させる可能性がある。

Customize ダイアログボックスを開き Events タブを選択する。このダイアログボックスのイベントはアプリケーション全体と特定の文書に関連するものだ。
Save in ドロップダウンで、LibreOffice または特定の文書を選択し、イベントを保存する。
一般的な使用方法は、特定のマクロを呼び出すために文書を開くイベントを割り当てるものだ。マクロは文書の特定の準備作業を実行する。必要なイベントを選択し、 Macro… ボタンを押して Macro Selector ダイアログボックスを開く。
必要なマクロを選択し、OK ボタンを押してマクロをイベントに割り当てる。イベントがマクロに割り当てられたことが Events タブに表示される。

文書内の多くの物体はイベント発生時にマクロを呼び出すように設定できる。最も一般的な使い方は、ボタンなどのコントロールを文書に追加することだ。図版をダブルクリックしても、Macros タブのあるダイアログボックスが開き、イベントにマクロを割り当てることが可能だ。

Using extensions ¶

拡張とは、LibreOffice にインストールして新しい機能を追加するコードのことだ。拡張はほとんどのプログラミング言語で記述でき、単純なものから洗練されたものまである。拡張は次のような型に分類される：

Calc アドイン。Calc に新しい機能を搭載するもので、通常の組み込み関数のように動作する新しい関数を含む。
新しい部品と機能。通常、新しいメニューやツールバーなど、ある程度の UI 統合を含む。
新しい統計図表型の図表アドイン。
綴字検査などの言語部品。
文書雛形と画像。

個々の拡張はいろいろな場所にあるが、現在、拡張の保管庫と文書は <https://extensions.libreoffice.org/> と <https://libreplanet.org/wiki/Group:OpenOfficeExtensions/List> にそれぞれある。拡張の入手とインストールの詳細については Chapter 13, Customizing LibreOffice ノートを見ろ。

Writing macros without the recorder ¶

LibreOffice を構成する物体に直接入出するコードでマクロを書くことも可能だ。つまり、より高度なプログラミング論理を用いて、文書を直接操作するマクロを作成することが可能だ。

LibreOffice の内部物体を直接操作することは、この章を超える高度な論題だ。それでも、これがどのように機能するかを簡単な例で説明する。

An example of a macro in code for Writer ¶

Writer 文書の末尾に文字列 Hello を追加するマクロを、記録なしで作成した簡単なコードをライブラリーに追加する手順：

Tools‣Macros‣Organize Macros‣Basic… を選択。
My Macros でマクロを作成したいライブラリーに移動する。ここでは TestLibrary とする。
ライブラリーですでに利用可能なモジュールの一つを選択する。新しいモジュールを作成したい場合は、Organizer ボタンを押し、新しいモジュールを追加する。
モジュールを選択した状態で Edit ボタンを押す。Basic IDE ウィンドウが開き、選択したモジュールに実装されているマクロのコードが表示される。
コードをモジュールに入力する。

利用者ノート

Basic コードの編集は IDE はもちろん、Visual Studio Code でさえ快適に行うことは期待できない。たとえば自動字下げ機能がすぐに見つけられない。

An example of a macro in code for Calc ¶

LibreOffice Calc の機能を拡張する強力な方法の一つは、繰り返し作業を自動化するマクロを作成することだ。単純な升目処理や書式設定から高度なデータ操作まで、さまざまな作業を実行するマクロを記述できる。

本書のコード例は升目範囲を分析して、すべての値が 0 から 100 の間かどうかを判断する。50 から 100 までは薄緑色で、0 から 50 までは薄赤色で升目をマークする。範囲外の値が見つかった場合は、警告を表示し薄い灰色でマークする。

マクロをライブラリーに追加手順は前節と同様。このマクロを実行するには、まず新しい Calc シートを作成し、升目範囲に数値を追加する。

The ScriptForge library ¶

ScriptForge ライブラリーは一連のサービスで構成されており、各サービスは特定の主題に関連するメソッドやプロパティーを与える。たとえば、Dialog サービスではスクリプトモジュールで利用可能なダイアログボックスに入出でき、Database サービスでは Base 文書でSQL コマンドを実行できる。

既存の Calc 文書を開き、NewSheet という名前の新しいシートを作成して、升目 A1 に文字列 Hello を入れるマクロを ScriptForge ライブラリーを使用して Basic で記述したコードだ。

ScriptForge ライブラリーを使うマクロ例¶

Sub CreateSheetExample
    GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
    Dim ui as Object, myDoc as Object
    ui = CreateScriptService("UI")

    Set myDoc = ui.OpenDocument("/home/user/Documents/myfile.ods")
    myDoc.InsertSheet("NewSheet")
    myDoc.SetValue("NewSheet.A1", "Hello")
    myDoc.Activate("NewSheet")
    myDoc.Save()
    myDoc.CloseDocument()
End Sub

読者ノート

試すときにはファイルパスを既存のものに変える必要がある。保存メソッドか閉じるメソッドをコメントアウトしておくとよい。

UNO Object Inspector ¶

LibreOffice にはアプリケーションのほぼすべての側面を自動化するために使用できる広範な API がある。LibreOffice で使用される部品モデルは UNO として知られている。

スクリプト言語の LibreOffice マクロは UNO API を使用する。XSCRIPTCONTEXT インターフェイスを LibreOffice Basic, Python, JavaScript, BeanShell のマクロスクリプトに与え、文書に対して動作を実行するために必要なさまざまなインターフェイスへの入出手段を設けている。

読者ノート

XSCRIPTCONTEXT とは？

UNO Object Inspector はマクロ開発者が物体を検査し、物体への入出方法を学習し、マクロで使用するのに役立つ。この機能は Writer, Calc, Impress, Drawで利用できる。この機能を有効にするには Menu バー Tool‣Development Tool を選択する。

ウィンドウ左側には DOM 補助装置があり、文書内の物体すべてを探索できる。物体を選択すると、それに関する情報がウィンドウの右側に表示される：

Interfaces: 実装されているインターフェイスすべての名前
Services: 物体が支援する工作すべての名前
Properties: 物体で利用可能な性質すべての名前と型
Methods: 物体が呼び出すことができるメソッドすべての名前、引数、戻り値の型

DOM 補助装置を使って物体を検査する代わりに Current Selection を切り替えることで、文書内で現在選択されている物体を直接検査することもある。

例えば、Writer 文書で選択テキストの背景色を変更したいとする。テキストの一部を選択し、UNO Object Inspector を開いて Current Selection を切り替え、目的の効果に一致する性質を探して物体の性質を調べることができる（この例では CharBackColor を見つけたい）。

この性質を使用して、選択テキストの背景色を変更するマクロを書くことができる。

Overview of Python, BeanShell, and JavaScript macros ¶

LibreOffice では、馴染みのある言語で書かれたマクロを支援している。Python, BeanShell, JavaScript だ。

マクロは、スクリプト言語すべてで同じように構成されている。LibreOffice Macros コンテナーには LibreOffice のインストール時に用意されているマクロがすべて格納される。

My Macros コンテナーには LibreOffice 文書で使用できるようにしたマクロが格納される。各文書には他の文書では使用できないマクロを含めることもできる。

記録機能を使用する場合、マクロは LibreOffice Basic で作成される。その他のスクリプト言語を使用するには、自分でコードを記述する必要がある。

Tools‣Macros‣Run Macro… を使用してマクロの実行を選択すると、Macro Selector ダイアログボックスが現れる。ここで利用可能な言語で書かれたマクロを選択して実行できる。

Tools–>Macro–>Edit Macros.. を使用してマクロを編集すると LibreOffice Basic IDE が起動する。このウィンドウでは利用可能な LibreOffice Basic マクロを選択して編集できるが、他の言語のマクロは選択できない。

Tip

<https://api.libreoffice.org/> を見ろ。

Python macros ¶

Tools‣Macros‣Organize Macros‣Python… を選択する。

Python Macros ダイアログボックスが現れる。Python スクリプトを編集およびデバッグする機能は、現在のところ LibreOffice の標準 UI に統合されていない。任意の Python エディターを使用してスクリプトを作成し、これらのファイルを適切なフォルダーに配置するのだ。Where are macros stored? を見ろ。

Tip

APSO 拡張機能を使うと Python スクリプトの編集や整理が簡単になる：<https://gitlab.com/jmzambon/apso> を見ろ。

LibreOffice での Python スクリプトの詳細については、 <https://wiki.documentfoundation.org/Macros/Python_Basics> を見ろ。

BeanShell macros ¶

割愛。

JavaScript macros ¶

Tools‣Macros‣Organize Macros‣JavaScript… を選択する。

JavaScript Macros ダイアログボックスの Edit ボタンを押すと Rhino JavaScript Debugger に出入りできる。この道具の詳しい使い方は <https://developer.mozilla.org/en-US/docs/Mozilla/Projects/Rhino/Debugger> で見つかる。

読者ノート

リンクが死んでいて話にならない。

Finding more information ¶

F1 を押して LibreOffice ヘルプページを開く。LibreOffice ヘルプシステムの左上にあるヘルプセットを表示するドロップダウンリストから Basic を選択する。

利用者ノート

ヘルプが出ない。

OpenOffice.org Macros Explained: LibreOffice Basic でも通用する。669 ページの大著。
<https://www.packtpub.com/openoffice-ooobasic-calc-automation/book>: 表計算なら。

Chapter 11, Getting Started with Macros ノート¶

Introduction ¶

Your first macros ¶

Adding a macro ¶

Recording a macro ¶

Running a macro ¶

Viewing and editing macros ¶

Commenting with REM¶

Defining subroutines with SUB¶

Defining variables using DIM¶

Explaining macro code¶

Creating a macro ¶

A more complex example of a macro ¶

Running a macro quickly ¶

Limitations of the macro recorder ¶

Understanding the dispatch framework ¶

How the macro recorder uses the dispatch framework ¶

Other options ¶

Macro organization ¶

Where are macros stored?¶

Exporting macros ¶

Importing macros ¶

Downloading macros to import ¶

How to run a macro ¶

Toolbars, menu items, and keyboard shortcuts ¶

Events ¶

Using extensions ¶

Writing macros without the recorder ¶

An example of a macro in code for Writer ¶

An example of a macro in code for Calc ¶

The ScriptForge library ¶

UNO Object Inspector ¶

Overview of Python, BeanShell, and JavaScript macros ¶

Python macros ¶

BeanShell macros ¶

JavaScript macros ¶

Finding more information ¶

Included material ¶

Online resources ¶

Printed and ebook materials ¶