使用者 Guide for the Office Scripting 枠組み
Contents
Pre-requisites
Before you 任命する／導入する the Scripting 枠組み, be aware of the に引き続いて:
This is an 早期に Developer 解放（する） of the Office Scripting 枠組み 供給するd for 使用者s and developers of OpenOffice.org to try out and 供給する feedback. 未来 解放（する）s of the 枠組み may change.
This 解放（する） of the Scripting 枠組み runs only on OpenOffice.org 644 and above.
The Scripting 枠組み is 現在／一般に 利用できる in English only.
Binding Office Scripts
The 死刑執行 of Office scripts can be bound to menu and 重要な items and also to 使用／適用 or 文書 events. These bindings can be defined 経由で a 始める，決める of 割り当てる dialogs which can be started from the 道具s/Scripting 追加する-on's menu
割り当てるing scripts to Menu and 重要な items
The dialog shown below is the 割り当てる Script to Menu dialog. This dialog is 類似の in design and 機能（する）／行事 to the 割り当てる Script to 重要な dialog and the 指示／教授／教育s below should be seen to 適用する also to the 割り当てる Script to 重要な dialog.
場所
The 場所 combo box will be 居住させるd with “使用者”,”株” or “文書” the default value will be “使用者” which will 陳列する，発揮する all scripts (with the selected language type) in the “使用者” area.
Language
The language combox is 居住させるd with the 名簿（に載せる）／表（にあげる） of supported languages. The default language is 始める，決める to java.
Script ListBox
Only necessary （警察などへの）密告，告訴（状） will be 陳列する，発揮するd, logicalname will always be 陳列する，発揮するd, if the “詳細（に述べる）d 見解（をとる）” check box is selected the scripts will be 陳列する，発揮するd as follows “logicalname [functionname]”
New
This button will not be selectable unless a script from the script ListBox and a menu 指名する is entered in the new menu text box (opposite New button), clicking [New] creates a binding between two.
削除する
This button will not be selectable unless a sub menu with a script binding is selected, clicking [削除する] 除去するs the binding.
承認する
Clicking [承認する] commits all of the changes the 使用者 has made
取り消す
配置する／処分する／したい気持ちにさせるs the dialog without committing any changes.
Help
Will 陳列する，発揮する a dialog 述べるing how to use each of the “割り当てる Script” dialogs.
公式文書，認める: Unlike StarBasic it will not be possible to 体制／機構 a 重要な binding that 適用するs for the whole Office 控訴 – 重要な bindings can only be 体制／機構 for an 使用／適用 or a 文書 of that 使用／適用 type.
割り当てるing scripts to events
Event ListBox
The ListBox will be 居住させるd with the 名簿（に載せる）／表（にあげる） all event types, if a script has already been 割り当てるd to an event the 存在するing binding is 陳列する，発揮するd as follows
Event [ script URI ]
example:
Start 使用／適用 [script://Highlighter.BeanShell?language=BeanShell&機能（する）／行事=highlighter.bsh&場所=使用者]
無線で通信する Buttons
By default the “文書” 無線で通信する button is selected, if selected the event binding is for this 文書 only. If “All 使用／適用s” is selected then the event binding is for all 文書s of all 使用／適用 types ( writer, calc etc. )
割り当てる
This button will not be selectable unless a script from the script ListBox and event from the event ListBox are 最高潮の場面d (selected), clicking [割り当てる] creates a binding between two.
削除する
This button will not be selectable unless an event with a script binding from the event ListBox is selected, clicking [削除する] 除去するs the binding.
承認する
Clicking [承認する] commits all of the changes the 使用者 has made
取り消す
配置する／処分する／したい気持ちにさせるs the dialog without committing any changes.
Help
Will 陳列する，発揮する a dialog 述べるing how to use each of the “割り当てる Script” dialogs.
Other Scripting-追加する'ons Menu Items
Two other menu items are 利用できる under the 道具s/Scripting 追加する-on's submenu:
Interactive BeanShell Scripting - This pops up a window in which the 使用者 can 実験 with 令状ing and 遂行する／発効させるing BeanShell code against the 現在の 文書. See 令状ing Scripts in BeanShell and Java for more （警察などへの）密告，告訴（状） on using this window.
Refresh All Scripts - This is used to refresh the script 名簿（に載せる）／表（にあげる）s that appear in the 割り当てる dialogs after new scripts have been （軍隊を）展開する，配備するd into your OpenOffice.org 取り付け・設備 or 文書s.
Running the example Office Scripts
There are two examples scripts 供給（する）d with the Scripting 枠組み, 最高潮の場面 and MemoryUsage. 最高潮の場面 is an 使用／適用 level script for Writer that 許すs the 使用者 to search for a word or phrase. It will 最高潮の場面 all instances in red and give a count of the number of instances.
The second example, MemoryUsage, is a script 蓄える／店d in a Calc spreadsheet that checks the 現在の memory usage in the Java 事実上の Machine and updates 独房s in the spreadsheet with the usage values. The spreadsheet also 含む／封じ込めるs a graph which will update when the 独房 values are changed.
The examples are 利用できる for both Java and BeanShell in the language directories created under <Office 取り付け・設備>/使用者/Scripts by the installer.
Running the 最高潮の場面 example
To run this example you first need to create a menu item from which you can 遂行する／発効させる the script.
Start OpenOffice.org and open an 存在するing Writer 文書 or create a new one.
Select the menu item 道具s/Scripting 追加する-on's/割り当てる Scripts To Menu...
In the "割り当てる Scripts To Menu" dialog that pops up do the に引き続いて:
Select 場所 and language
始める，決める the 場所 to 使用者 and the language to Java in the 減少（する） 負かす／撃墜する 名簿（に載せる）／表（にあげる）s.
Select script
Select the script HighlightText.showForm from the 名簿（に載せる）／表（にあげる）.
Choose the menu to 挿入する the script menu after
Select the 最高の，を越す level menu and submenu under which you want to place your new menu item.
割り当てる script to new menu
In the New Menu text field enter the label you want for your menu item (eg. 最高潮の場面)
Click New Script Menu to create the new script menu item.
Finally click on the 承認する button to save your new script menu item.
Your new menu item will now be 利用できる and clicking on it will invoke the script.
You should see a 最高潮の場面 Text dialog appear which you can use to 最高潮の場面 さまざまな text strings you are looking for in the 文書.
Running the MemoryUsage example
The Java 見解／翻訳／版 of the MemoryUsage example is already （軍隊を）展開する，配備するd inside an Office 文書, ExampleSpreadSheet.sxc. To run the Java example, just open:
<Office 取り付け・設備>/使用者/Scripts/java/ExampleSpreadSheet.sxc.
You can then 遂行する／発効させる the MemoryUsage script by 圧力（をかける）ing CTRL+転換+M with the ExampleSpreadSheet.sxc window 焦点（を合わせる）d. You should see the memory usage values 存在 updated, and the graph should change to 反映する the new values.
てこ入れ／借入資本ing StarBasic 安全
As part of the 早期に Developer 解放（する）
v0.2 of the Scripting 枠組み, we have 試みる／企てるd to mimic the
安全 settings for StarBasic. The settings 許す the 使用者 to
支配（する）／統制する the 死刑執行 of 大型のs 現在の in OpenOffice.org 文書s.
設立する in the 道具s->選択s dialog under
OpenOffice.org->安全, these settings 許す the 使用者
to 明示する the 条件s under which it is permissable to 遂行する／発効させる
文書 based StarBasic 大型のs. The settings in this dialog now
適用する to both StarBasic 大型のs and Scripting 枠組み scripts.
A
十分な description of how these settings work can be 設立する by clicking
the "Help" button in the dialog, and then clicking
"OpenOffice.org", and "安全" in the left-手渡す
pane of the Help dialog. The possible シナリオs associated with the
安全 settings are summarised in the （米）棚上げする／（英）提議する below.
|
"Run 大型の" |
"確認する in the 事例／患者 of other 文書 sources" |
"Show 警告 before Running" |
文書 path in "Path 名簿（に載せる）／表（にあげる）" |
Behaviour |
|---|---|---|---|---|
|
Never |
N/A |
N/A |
N/A |
大型のs never run. No 警告 陳列する，発揮するd. |
|
によれば path 名簿（に載せる）／表（にあげる） |
No |
No |
No |
大型のs never run. No 警告 陳列する，発揮するd. |
|
によれば path 名簿（に載せる）／表（にあげる） |
No |
No |
Yes |
大型のs run. No 警告 陳列する，発揮するd. |
|
によれば path 名簿（に載せる）／表（にあげる） |
No |
Yes |
No |
大型のs never run. No 警告 陳列する，発揮するd. |
|
によれば path 名簿（に載せる）／表（にあげる） |
No |
Yes |
Yes |
警告 陳列する，発揮するd on 文書 負担. If "Run" button clicked 大型のs will run, さもなければ they will not. |
|
によれば path 名簿（に載せる）／表（にあげる） |
Yes |
No |
No |
警告 with checkbox to 追加する path to path 名簿（に載せる）／表（にあげる） is 陳列する，発揮するd on 文書 負担. If "Run" button clicked 大型のs will run, さもなければ they will not. 関わりなく which button is clicked, if checkbox is ticked 文書 path is 追加するd to "Path 名簿（に載せる）／表（にあげる）". |
|
によれば path 名簿（に載せる）／表（にあげる） |
Yes |
No |
Yes |
大型のs run. No 警告 陳列する，発揮するd. |
|
によれば path 名簿（に載せる）／表（にあげる） |
Yes |
Yes |
No |
警告 with checkbox to 追加する path to path 名簿（に載せる）／表（にあげる） is 陳列する，発揮するd on 文書 負担. If "Run" button clicked 大型のs will run, さもなければ they will not. 関わりなく which button is clicked, if checkbox is ticked 文書 path is 追加するd to "Path 名簿（に載せる）／表（にあげる）". |
|
によれば path 名簿（に載せる）／表（にあげる） |
Yes |
Yes |
Yes |
警告 陳列する，発揮するd on 文書 負担. If "Run" button clicked 大型のs will run, さもなければ they will not. |
|
Always |
N/A |
No |
N/A |
大型のs run. No 警告 陳列する，発揮するd. |
|
Always |
N/A |
Yes |
N/A |
警告 陳列する，発揮するd on 文書 負担. If "Run" button clicked 大型のs will run, さもなければ they will not. |
Different behaviour in the Scripting 枠組み
The Script 安全 has one 重要な difference in behaviour to
the StarBasic 安全. In the Scripting 枠組み the 安全
警告 dialogs are 陳列する，発揮するd only upon the first script invocation
on a 文書 含む／封じ込めるing scripts, unlike StarBasic where the dialogs
are 陳列する，発揮するd on 負担ing a 文書 含む／封じ込めるing 大型のs.
If the
settings are "Always", and "Show 警告 Before
Running", when 負担ing a 文書 含む／封じ込めるing 大型のs the
StarBasic dialog 陳列する，発揮する is incorrect (the dialog 陳列する，発揮するd is more
appropriate to the "（許可，名誉などを）与えるing To Path 名簿（に載せる）／表（にあげる）" setting). This
has been logged as 問題／発行する
11822, the 直す／買収する，八百長をする for which is not in the OpenOffice.org 1.1 beta
解放（する）. Under the Scripting 枠組み the 訂正する dialog is
陳列する，発揮するd.
最高の，を越す
Troubleshooting
See the 解放（する） 公式文書，認めるs page.
Last 修正するd: Tue 損なう 12 11:40:28 GMT 2003
