=====================================
:program:`LibreOffice` におけるマクロ
=====================================


概要
-----------------

1. マクロの説明
   :program:`LibreOffice` におけるマクロとは何かを説明する。また、それに関連する他のワードについても説明する。
   また、マクロそのものの使用方法についても記述する。
   
2. マクロのコード、実行例
   実際の作成したマクロを示し、マクロが計算問題においてどのような役割を果たすのかを記述する。それを利用して問題を回答する。


用語集
-------

オフィスBasic :
  プログラミング言語である。 ``OpenOffice.orgBasic`` と、 ``LibreOfficeBasic`` をまとめた物。
  ``オフィスBasic言語`` 、 ``ランタイム・ライブラリ`` 、 ``オフィスAPI`` 、 ``ダイアログエディタ`` の４つの要素から構成されている。

オフィスBasic言語 :
  言語の基本的な要素（例えば、変数宣言、ループ、関数など）を定義する。

ランタイム・ライブラリ
  数、文字列、日付時刻値、ファイルを操作するための関数のような、オフィスBasicそのものには含まれないが記述が必須である要素。
  
オフィスAPI :
  オフィスドキュメントにアクセスして、ドキュメントを作成、保存、編集、印刷できるようにする物。
  
ダイアログエディタ :
  独自のダイアログウィンドウを作成して、コントロールと呼ばれる部品とイベント処理機構を追加するためのもの。


サブルーチン :
  名前をつけた実行可能な一連のコード。for文などと違い、値を返すことがない。

1. マクロとは何か
------------------

   マクロ:
        オフィスBasicで記述するプログラムのことである。
        :program:`Office` の :program:`Writer` や :program:`Calc` などのメニューでも、 ``[ツール]メニュー`` の表記は ``[マクロ]`` である。
    
   今回は、マクロとプログラムを同じ意味の言葉として使用する。
  
 

2. マクロの起動方法
--------------------

    1. マクロはダイアログボックスの :menuselection:`[ツール] --> [マクロ] --> [マクロの管理] --> [LibreOfficeBasic]` から管理、編集、使用する事ができる。
       岐阜大内では基本的には、 ``[マクロの実行]`` は使用できない。
       ``[マクロの管理]`` を実行すると、下のような画面になる。
    
    
    
        .. image:: kidou.png
            :scale: 70%
        
    2. マクロの記録先を指定し、ドキュメントの中にマクロを保存する。今回の保存先は ``[bibun.ods]`` である。


    3. ``[新規作成]ボタン`` をクリックすると、 ``[新しいモジュール]ダイアログボックス`` が表示される。


        .. image:: sinki.png
            :scale: 70%
        
    4. ``[新しいモジュール]ダイアログボックス`` の ``[OK]`` ボタンをクリックし、マクロの編集ダイアログボックスを表示する。

        .. image:: zengamen.png
            :scale: 70%
        

        ここにコードを書き込む事によって、マクロを使用できるようになる。
    
.. warning:: 岐阜大学内でのマクロの実行に関して

    岐阜大学内であればマクロのセキュリティレベルを下げても :menuselection:`[ツール] --> [マクロ] --> [マクロの実行]` から
    マクロを実行することができない。