Difference between revisions of "JA/Documentation/Administration Guide/Using Custom Macros and Libraries"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (Robot: Automated text replacement (-{{PDL1}} +{{InterWiki Languages AdminGuide|articletitle={{PAGENAME}}}}\n{{PDL1}}))
Line 6: Line 6:
 
|NextPage=Documentation/Administration Guide/Using Package Manager
 
|NextPage=Documentation/Administration Guide/Using Package Manager
 
}}
 
}}
−
{{DISPLAYTITLE:カスタム {{OOo}} Basic マクロとライブラリの使用}}
+
{{DISPLAYTITLE:カスタム {{OOo}} Basic マクロとライブラリ}}
  
 
{{OOo}} Basic は、{{OOo}} の作業を自動化できるプログラミング言語です。
 
{{OOo}} Basic は、{{OOo}} の作業を自動化できるプログラミング言語です。
Line 21: Line 21:
 
;<tt>script.xlb</tt>:ライブラリ内のモジュール名が格納されている XML ファイル。
 
;<tt>script.xlb</tt>:ライブラリ内のモジュール名が格納されている XML ファイル。
 
;<tt>dialog.xlb</tt>:ライブラリ内のダイアログボックス名が格納されている XML ファイル。
 
;<tt>dialog.xlb</tt>:ライブラリ内のダイアログボックス名が格納されている XML ファイル。
−
;<tt>*.xba</tt>:単一の {{OOo}} Basic モジュール用の {{OOo}} ソースコードが格納されている XML ファイル。ファイル名はモジュール名に対応しています。
+
;<tt>*.xba</tt>:単一の {{OOo}} Basic モジュール用の {{OOo}} Basic ソースコードが格納されている XML ファイル。·ファイル名はモジュール名に対応しています。
 
;<tt>*.xdl</tt>:{{OOo}} Basic ダイアログボックスのダイアログ要素が格納されている XML ファイル。ファイル名はダイアログ名に対応しています。
 
;<tt>*.xdl</tt>:{{OOo}} Basic ダイアログボックスのダイアログ要素が格納されている XML ファイル。ファイル名はダイアログ名に対応しています。
 
;<tt>*.pba</tt>:パスワードで保護されている (ソースコードが暗号化されている) {{OOo}} Basic モジュール。ファイル名はモジュール名に対応しています。
 
;<tt>*.pba</tt>:パスワードで保護されている (ソースコードが暗号化されている) {{OOo}} Basic モジュール。ファイル名はモジュール名に対応しています。
Line 42: Line 42:
 
{{Documentation/Note|ライブラリがユーザーインストールの <tt> &lt;{{OOo}} installation directory&gt;/user/basic</tt> ディレクトリにある場合、<tt>xlink:href</tt> タグの値を指定する必要はありません。}}
 
{{Documentation/Note|ライブラリがユーザーインストールの <tt> &lt;{{OOo}} installation directory&gt;/user/basic</tt> ディレクトリにある場合、<tt>xlink:href</tt> タグの値を指定する必要はありません。}}
 
;<tt>xlink<nowiki>:</nowiki>type</tt>:このタグは、<tt>xlink:href</tt> タグに必要で、<tt>simple</tt> に設定する必要があります。
 
;<tt>xlink<nowiki>:</nowiki>type</tt>:このタグは、<tt>xlink:href</tt> タグに必要で、<tt>simple</tt> に設定する必要があります。
−
;<tt>library<nowiki>:</nowiki>link</tt>:デフォルト以外の場所にあるライブラリへのリンクであるかどうかを示します。{{OOo}} Basic ライブラリのデフォルトの場所は、<tt>''install-dir''/user/basic</tt> です。デフォルトの場所にあるライブラリだけを使用する場合、このタグの値を <tt>false</tt> に設定します。それ以外のライブラリを使用する場合、このタグの値を <tt>true</tt> に設定します。
+
;<tt>library<nowiki>:</nowiki>link</tt>:デフォルト以外の場所にあるライブラリへのリンクであるかどうかを指定します。{{OOo}} Basic ライブラリのデフォルトの場所は、<tt>''install-dir''/user/basic</tt> です。デフォルトの場所にあるライブラリだけを使用する場合、このタグの値を <tt>false</tt> に設定します。それ以外のライブラリを使用する場合、このタグの値を <tt>true</tt> に設定します。
 
;<tt>library<nowiki>:</nowiki>readonly</tt>:ライブラリが読み取り専用であるかどうかを指定します。読み取り専用の場合、このタグの値を <tt>true</tt> に設定します。
 
;<tt>library<nowiki>:</nowiki>readonly</tt>:ライブラリが読み取り専用であるかどうかを指定します。読み取り専用の場合、このタグの値を <tt>true</tt> に設定します。
  
−
次の XML コードは、Basic ライブラリの <tt>script.xlc</tt> 設定ファイルです。
+
次の XML コードは、<tt>script.xlc</tt> 設定ファイル (
−
{{OOo}} Basic ライブラリこのファイルと <tt>dialog.xlc</tt>  
+
{{OOo}} Basic ライブラリの) です。このファイルと <tt>dialog.xlc</tt> との違いは、
−
<tt>xlink:href</tt> タグが指すライブラリのファイルです。このファイルは <tt>script.xlb</tt> ファイルを指し、
+
ライブラリを指す <tt>xlink:href</tt> タグのみで、<tt>script.xlb</tt> では、
−
<tt>dialog.xlb</tt> ファイルを指していません。
+
<tt>dialog.xlb</tt> が dialog.xlb になります。
  
−
<source lang="xml">
+
<source language="xml">
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
 
<!DOCTYPE library:libraries PUBLIC  
 
<!DOCTYPE library:libraries PUBLIC  
Line 93: Line 93:
 
リンクには、次の構文を使用します。
 
リンクには、次の構文を使用します。
  
−
<source lang="xml">
+
<source language="xml">
 
  <library:library library:name="Library Name"
 
  <library:library library:name="Library Name"
 
  xlink:href="$(USER)/basic/Library Name/script.xlb/"
 
  xlink:href="$(USER)/basic/Library Name/script.xlb/"
Line 104: Line 104:
 
リンクには、次の構文を使用します。
 
リンクには、次の構文を使用します。
  
−
<source lang="xml">
+
<source language="xml">
 
  <library:library library:name="Library Name"
 
  <library:library library:name="Library Name"
 
  xlink:href="$(USER)/basic/Library Name/dialog.xlb/"
 
  xlink:href="$(USER)/basic/Library Name/dialog.xlb/"
Line 122: Line 122:
  
 
*Solaris および Linux プラットフォームでは、スーパーユーザーになり、ライブラリをコピーします。
 
*Solaris および Linux プラットフォームでは、スーパーユーザーになり、ライブラリをコピーします。
−
   <source lang="text">cp -r ''install-dir''/user/basic/custom library ''install-dir''/user/basic/</source>
+
   <source language="text">cp -r ''install-dir''/user/basic/custom library ''install-dir''/user/basic/</source>
 
*Windows では、管理特権を持つユーザーになり、ライブラリをコピーします。<br>
 
*Windows では、管理特権を持つユーザーになり、ライブラリをコピーします。<br>
−
ライブラリのファイル名パスは、<tt>C:\Documents and Settings\''user-id''\Application Data\''install-dir''\user\basic\custom library</tt>
+
ライブラリのファイル名パスは、<tt>C:\Documents and Settings\''user-id''\Application Data\''install-dir''\user\basic\custom library</tt> です。
 
</li>
 
</li>
 
<li>
 
<li>
Line 130: Line 130:
  
 
リンクには、次の構文を使用します。
 
リンクには、次の構文を使用します。
−
<source lang="xml">
+
<source language="xml">
 
  <library:library library:name="Library Name"
 
  <library:library library:name="Library Name"
 
  xlink:href="$(USER)/basic/Library Name/script.xlb/"
 
  xlink:href="$(USER)/basic/Library Name/script.xlb/"
Line 140: Line 140:
  
 
リンクには、次の構文を使用します。
 
リンクには、次の構文を使用します。
−
<source lang="xml">
+
<source language="xml">
 
  <library:library library:name="Library Name"
 
  <library:library library:name="Library Name"
 
  xlink:href="$(USER)/basic/Library Name/dialog.xlb/"
 
  xlink:href="$(USER)/basic/Library Name/dialog.xlb/"
Line 161: Line 161:
 
</li>
 
</li>
 
<li>
 
<li>
−
インストールマクロを作成します。
+
インストールするマクロを作成します。
 
</li>
 
</li>
 
<ol class="task" type="a">
 
<ol class="task" type="a">
−
<li>'''「ツール」&rarr;「マクロ」&rarr;「マクロの管理」&rarr;「{{OOo}} Basic」を選択します。'''「'''{{OOo}} Basic マクロ'''」ダイアログボックスが表示されます。</li>
+
<li>'''「ツール」&rarr;「マクロ」&rarr;「マクロの管理」&rarr;「{{OOo}}Basic」'''を選択します。「'''{{OOo}} Basic マクロ'''」ダイアログボックスが表示されます。</li>
 
<li>「'''マクロの記録先'''」リストで、Writer ドキュメントを選択します。</li>
 
<li>「'''マクロの記録先'''」リストで、Writer ドキュメントを選択します。</li>
−
<li>「'''マクロ名'''」ボックスで、インストールマクロから名前を入力します。</li>
+
<li>「'''マクロ名'''」ボックスで、インストールするマクロの名前を入力します。</li>
−
<li>「'''新規作成'''」ボタンをクリックします。「'''BASIC'''」IDE ウィンドウが表示されます。</li>
+
<li>「'''新規作成'''」ボタンをクリックします。「'''Basic'''」IDE ウィンドウが表示されます。</li>
 
<li>次のコードを入力します。</li>
 
<li>次のコードを入力します。</li>
  
−
<source lang="oobas">
+
<source language="oobas">
 
  Sub AddBasicLibrary
 
  Sub AddBasicLibrary
 
   Dim SourceLibraryName As String, DestLibraryName As String
 
   Dim SourceLibraryName As String, DestLibraryName As String
Line 212: Line 212:
  
 
<li><tt>SrcLibraryName</tt> と <tt>DestLibraryName</tt> 変数を、作成したライブラリ名に置き換えます。</li>
 
<li><tt>SrcLibraryName</tt> と <tt>DestLibraryName</tt> 変数を、作成したライブラリ名に置き換えます。</li>
−
<li>「'''BASIC'''」 IDE ウィンドウを閉じます。</li>
+
<li>「'''Basic'''」 IDE ウィンドウを閉じます。</li>
 
</ol>
 
</ol>
  
−
<li>ドキュメントにプッシュボタンを追加します。</li>
+
<li>ドキュメントにボタンを追加します。</li>
 
<ol class="task" type="a">
 
<ol class="task" type="a">
−
<li>「'''フォームコントロール'''」ツールバーで、''''''「'''プッシュボタン'''」アイコンをクリックします。</li>
+
<li>「フォームコントロール''''''''''''」ツールバーで、「'''ボタン'''」アイコンをクリックします。</li>
−
<li>ドキュメントで、ボタンをドラッグして追加します。</li>
+
<li>ドキュメントで、ドラッグしてボタンを追加します。</li>
 
</ol>
 
</ol>
  
−
<li>ボタンイベントにインストールマクロを割り当てます。</li>
+
<li>ボタンイベントにインストールするマクロを割り当てます。</li>
 
<ol class="task" type="a">
 
<ol class="task" type="a">
−
<li>新しいボタンを右クリックし、「'''コントロール'''」を選択します。</li>
+
<li>追加したボタンを右クリックし、「'''コントロール'''」を選択します。</li>
 
<li>「'''イベント'''」タブをクリックします。</li>
 
<li>「'''イベント'''」タブをクリックします。</li>
−
<li>ボタンイベント (「'''マウスボタンを押したとき'''」イベントなど) の隣にある省略符号「'''...'''」をクリックします。</li>
+
<li>ボタンイベント (「'''マウスボタンを押した時'''」イベントなど) の隣にある省略符号ボタン「'''...'''」をクリックします。</li>
−
<li>「'''アクションの割り当て'''」ダイアログボックスで、「'''マクロ'''」ボタンをクリックします。「'''マクロの選択'''」ダイアログボックスが表示されます。</li>
+
<li>「'''割り当てられたアクション'''」ダイアログボックスで、「'''マクロ'''」ボタンをクリックします。「'''マクロの選択'''」ダイアログボックスが表示されます。</li>
−
<li>「'''ライブラリ'''」リストで、インストールマクロが格納されているライブラリを選択します。</li>
+
<li>「'''ライブラリ'''」リストで、インストールするマクロが格納されているライブラリを選択します。</li>
−
<li>「'''マクロ名'''」リストで、インストールマクロを選択します。</li>
+
<li>「'''マクロ名'''」リストで、インストールするマクロを選択します。</li>
 
<li>「'''OK'''」をクリックします。</li>
 
<li>「'''OK'''」をクリックします。</li>
−
<li>「'''マクロの割り当て'''」ダイアログボックスで、「'''OK'''」をクリックします。</li>
+
<li>「'''割り当てられたマクロ'''」ダイアログボックスで、「'''OK'''」をクリックします。</li>
 
</ol>
 
</ol>
 
<li>ドキュメントを保存します。</li>
 
<li>ドキュメントを保存します。</li>
 
</ol>
 
</ol>
  
−
{{InterWiki Languages AdminGuide|articletitle={{PAGENAME}}}}
 
 
{{PDL1}}
 
{{PDL1}}

Revision as of 14:26, 30 October 2008


Apache OpenOffice Basic は、Apache OpenOffice の作業を自動化できるプログラミング言語です。 Apache OpenOffice Basic マクロはモジュールに格納され、そのモジュールはライブラリに格納されます。 ライブラリは、Apache OpenOffice Basic で作成したダイアログボックスのコンテナとしても機能します。 Basic ライブラリは、ユーザーがアクセスできる任意のディレクトリに格納できます。

Template:Documentation/Note

Apache OpenOffice Basic ライブラリとモジュールについて

デフォルトの Apache OpenOffice Basic ライブラリは、install-dir/share/basic ディレクトリにあります。ライブラリには次のファイルが含まれます。

script.xlb
ライブラリ内のモジュール名が格納されている XML ファイル。
dialog.xlb
ライブラリ内のダイアログボックス名が格納されている XML ファイル。
*.xba
単一の Apache OpenOffice Basic モジュール用の Apache OpenOffice Basic ソースコードが格納されている XML ファイル。·ファイル名はモジュール名に対応しています。
*.xdl
Apache OpenOffice Basic ダイアログボックスのダイアログ要素が格納されている XML ファイル。ファイル名はダイアログ名に対応しています。
*.pba
パスワードで保護されている (ソースコードが暗号化されている) Apache OpenOffice Basic モジュール。ファイル名はモジュール名に対応しています。

Apache OpenOffice Basic 設定ファイルについて

script.xlc と dialog.xlc 設定ファイルには、 Apache OpenOffice Basic ライブラリとダイアログボックスの場所が含まれています。これらのファイルは、install-dir/user/basic/ ディレクトリにあり、このディレクトリにはデフォルトの標準 Apache OpenOffice Basic ライブラリとユーザー定義ライブラリも格納されています。

Documentation caution.png

script.xlc と dialog.xlc 設定ファイルの場所は変更できません。

XML ベースの script.xlc ファイルには、 Apache OpenOffice で利用できるすべての Basic ライブラリのリストが含まれています。以下のタグが使用されます。

library:name
Apache OpenOffice Basic ライブラリ名を指定します。
xlink:href
ライブラリの script.xlb ファイルの URL を指定します。このURL は、file:/// 表記で始まる必要があります。

Template:Documentation/Note

xlink:type
このタグは、xlink:href タグに必要で、simple に設定する必要があります。
library:link
デフォルト以外の場所にあるライブラリへのリンクであるかどうかを指定します。Apache OpenOffice Basic ライブラリのデフォルトの場所は、install-dir/user/basic です。デフォルトの場所にあるライブラリだけを使用する場合、このタグの値を false に設定します。それ以外のライブラリを使用する場合、このタグの値を true に設定します。
library:readonly
ライブラリが読み取り専用であるかどうかを指定します。読み取り専用の場合、このタグの値を true に設定します。

次の XML コードは、script.xlc 設定ファイル ( Apache OpenOffice Basic ライブラリの) です。このファイルと dialog.xlc との違いは、 ライブラリを指す xlink:href タグのみで、script.xlb では、 dialog.xlb が dialog.xlb になります。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE library:libraries PUBLIC 
"-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "libraries.dtd">

<library:libraries 
xmlns:library="http://openoffice.org/2000/library" 
xmlns:xlink="http://www.w3.org/1999/xlink">

<library:library library:name="Standard" 
xlink:href="file:///.../user/basic/Standard/script.xlb/" 
xlink:type="simple" library:link="false"/>

<library:library library:name="FormWizard" 
xlink:href="file:///.../share/basic/FormWizard/script.xlb/" 
xlink:type="simple" library:link="true" library:readonly="false"/>
</library:libraries>

Apache OpenOffice Basic 設定ファイルの例

Apache OpenOffice Basic ライブラリの配布

既存の Apache OpenOffice インストール用または新規インストール専用に利用できるカスタム Apache OpenOffice Basic ライブラリを作成できます。

Template:Documentation/Note

ネットワーク上のすべてのユーザーがカスタム Apache OpenOffice Basic ライブラリを利用できるようにする

Apache OpenOffice を使用してカスタムライブラリと、そのライブラリのマクロを作成します。

  1. スーパーユーザーとして、カスタムライブラリを作成したユーザーインストールから Apache OpenOffice サーバーインストールにそのライブラリをコピーします。
    cp -r install-dir/user/basic/custom library install-dir/share/basic/ Template:Documentation/Note です。
  2. ユーザーインストールの script.xlc 設定ファイルを開き、ライブラリの script.xlb 設定ファイルへのリンクを追加します。
    リンクには、次の構文を使用します。
     <library:library library:name="Library Name"
     xlink:href="$(USER)/basic/Library Name/script.xlb/"
     xlink:type="simple" library:link="true" library:readonly="false"/>
  3. ユーザーインストールの dialog.xlc 設定ファイルを開き、ライブラリの script.xlb 設定ファイルへのリンクを追加します。
    リンクには、次の構文を使用します。
     <library:library library:name="Library Name"
     xlink:href="$(USER)/basic/Library Name/dialog.xlb/"
     xlink:type="simple" library:link="false"/>
  4. ワークステーション上で Apache OpenOffice を再起動します。

カスタム Apache OpenOffice Basic ライブラリを、単一のユーザーが利用できるようにする

  1. カスタムライブラリを作成したユーザーインストールから、ライブラリを配備するユーザーインストールにカスタムライブラリをコピーします。
    • Solaris および Linux プラットフォームでは、スーパーユーザーになり、ライブラリをコピーします。
    cp -r ''install-dir''/user/basic/custom library ''install-dir''/user/basic/
    • Windows では、管理特権を持つユーザーになり、ライブラリをコピーします。

    ライブラリのファイル名パスは、C:\Documents and Settings\user-id\Application Data\install-dir\user\basic\custom library です。

  2. ユーザーインストールの script.xlc 設定ファイルを開き、ライブラリの script.xlb 設定ファイルへのリンクを追加します。
    リンクには、次の構文を使用します。
     <library:library library:name="Library Name"
     xlink:href="$(USER)/basic/Library Name/script.xlb/"
     xlink:type="simple" library:link="true" library:readonly="false"/>
  3. ユーザーインストールの dialog.xlc 設定ファイルを開き、ライブラリの script.xlb 設定ファイルへのリンクを追加します。
    リンクには、次の構文を使用します。
     <library:library library:name="Library Name"
     xlink:href="$(USER)/basic/Library Name/dialog.xlb/"
     xlink:type="simple" library:link="false"/>
  4. Apache OpenOffice を再起動します。

マクロを使用してカスタム Apache OpenOffice Basic ライブラリをインストールする

Apache OpenOffice Basic ライブラリを Apache OpenOffice ドキュメントからインストールするマクロを作成できます。

  1. Writer で、新しいドキュメントにカスタム Apache OpenOffice Basic ライブラリを作成します。
  2. ドキュメントを保存します。
  3. インストールするマクロを作成します。
    1. 「ツール」→「マクロ」→「マクロの管理」→「Apache OpenOfficeBasic」を選択します。「Apache OpenOffice Basic マクロ」ダイアログボックスが表示されます。
    2. 「マクロの記録先」リストで、Writer ドキュメントを選択します。
    3. 「マクロ名」ボックスで、インストールするマクロの名前を入力します。
    4. 「新規作成」ボタンをクリックします。「Basic」IDE ウィンドウが表示されます。
    5. 次のコードを入力します。
    6.  Sub AddBasicLibrary
        Dim SourceLibraryName As String, DestLibraryName As String
        Dim oSrcLib As Object, oDestLib As Object, iCounter As Integer
        Dim oLib As Object, oGlobalLib As Object
        
        ' set these 2 variables to your lib name
        SrcLibraryName = "TextLib" 
        ' The name of the library that contains the modules
        DestLibraryName = "NewLib" 
        ' This library will be created and is the 
        ' destination for the modules from the source document.
        
        oLib = BasicLibraries        ' For Basic libaries
        oGlobalLib = GlobalScope.BasicLibraries
        For iLib = 1 To 2 
          If oGlobalLib.hasByName( DestLibraryName ) = False Then
            oGlobalLib.createLibrary( DestLibraryName )
          End If
          If oLib.hasByName( SrcLibraryName ) Then
            oLib.loadLibrary( SrcLibraryName )
            oSrcLib = oLib.getByName( SrcLibraryName )
            sSrcModules = oSrcLib.getElementNames()
            iCounter = lBound( sSrcModules() )
        
            while( iCounter &lt;= uBound( sSrcModules() ) )
              oDestLib = oGlobalLib.getByName(DestLibraryName)
              If oDestLib.hasByName( sSrcModules(iCounter) ) = False Then
                oDestLib.insertByName( sSrcModules(iCounter),_
                oSrcLib.getByName( sSrcModules(iCounter) ) )
              End If
              iCounter = iCounter + 1
            wend
          End If
        
          oLib = DialogLibraries   ' The same for the Dialog libraries
          oGlobalLib = GlobalScope.DialogLibraries
        Next iLib
       End Sub
    7. SrcLibraryName と DestLibraryName 変数を、作成したライブラリ名に置き換えます。
    8. 「Basic」 IDE ウィンドウを閉じます。
  4. ドキュメントにボタンを追加します。
    1. 「フォームコントロール'''''''」ツールバーで、「'ボタン」アイコンをクリックします。
    2. ドキュメントで、ドラッグしてボタンを追加します。
  5. ボタンイベントにインストールするマクロを割り当てます。
    1. 追加したボタンを右クリックし、「コントロール」を選択します。
    2. 「イベント」タブをクリックします。
    3. ボタンイベント (「マウスボタンを押した時」イベントなど) の隣にある省略符号ボタン「...」をクリックします。
    4. 「割り当てられたアクション」ダイアログボックスで、「マクロ」ボタンをクリックします。「マクロの選択」ダイアログボックスが表示されます。
    5. 「ライブラリ」リストで、インストールするマクロが格納されているライブラリを選択します。
    6. 「マクロ名」リストで、インストールするマクロを選択します。
    7. 「OK」をクリックします。
    8. 「割り当てられたマクロ」ダイアログボックスで、「OK」をクリックします。
  6. ドキュメントを保存します。
Content on this page is licensed under the Public Documentation License (PDL).



Personal tools