Difference between revisions of "JA/Documentation/BASIC Guide/Message and Input Boxes (Runtime Library)"

From Apache OpenOffice Wiki
Jump to: navigation, search
Line 1: Line 1:
{{DISPLAYTITLE: メッセージボックスとインプットボックス ({{OOo}} 実行時ライブラリ) }}
+
{{DISPLAYTITLE:
 +
                    メッセージボックスとインプットボックス ({{OOo}} 実行時ライブラリ)
 +
                    }}
 
{{JA/Documentation/BASICGuideTOC/v2
 
{{JA/Documentation/BASICGuideTOC/v2
 
|ShowPrevNext=block
 
|ShowPrevNext=block
Line 11: Line 13:
  
 
== メッセージの出力 ==
 
== メッセージの出力 ==
<tt>MsgBox</tt> を使うと、簡単なメッセージ\'95\'5c示用のダイアログを\'95\'5c示できるだけでなく、その中に 1つまたは複数の\'83\'7bタンを配置できます。最も簡単なバリアントでは、<tt>MsgBox</tt> に含まれるのはテキストと OK ボタンだけです。
+
<tt>MsgBox</tt> を使うと、簡単なメッセージ表示用のダイアログを表示できるだけでなく、その中に 1つまたは複数のボタンを配置できます。最も簡単なバリアントでは、<tt>MsgBox</tt> に含まれるのはテキストと OK ボタンだけです。
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 17: Line 19:
 
</source>
 
</source>
  
メッセージ\'83\'7bックスの\'95\'5c示形態は、パラメータ指定により変更できます。ここでは、\'83\'7bタンの種類、標準\'83\'7bタン、追加\'95\'5c示するアイコンをパラメータ指定により設定できます。\'83\'7bタンの指定は、以下の数値を通じて行います。
+
メッセージボックスの表示形態は、パラメータ指定により変更できます。ここでは、ボタンの種類、標準ボタン、追加表示するアイコンをパラメータ指定により設定できます。ボタンの指定は、次の数値を通じて行います。
  
* <tt>0</tt> - OK \'83\'7bタンのみを\'95\'5c示します。
+
* <tt>0</tt> - OK ボタンのみを表示します。
* <tt>1</tt> - OK およびキャンセルの各\'83\'7bタンを\'95\'5c示します。
+
* <tt>1</tt> - OK およびキャンセルの各ボタンを表示します。
 
* <tt>2</tt> - 中止、やり直し、および取消しボタンの各ボタンを表示します。
 
* <tt>2</tt> - 中止、やり直し、および取消しボタンの各ボタンを表示します。
* <tt>3</tt> - はい、いいえ、キャンセルの各\'83\'7bタンを\'95\'5c示します。
+
* <tt>3</tt> - はい、いいえ、キャンセルの各ボタンを表示します。
* <tt>4</tt> - はい、いいえの各\'83\'7bタンを\'95\'5c示します。
+
* <tt>4</tt> - はい、いいえの各ボタンを表示します。
* <tt>5</tt> - やり直しおよびキャンセルの各\'83\'7bタンを\'95\'5c示します。
+
* <tt>5</tt> - やり直しおよびキャンセルの各ボタンを表示します。
  
なお、\'95\'5c示\'83\'7bタンの指定用パラメータ値に以下の値を加えることで、いずれか 1 つの\'83\'7bタンを標準\'83\'7bタンに設定できます。たとえば、はい、いいえ、キャンセルの各ボタンを表示させ (指定値 3)、キャンセルを標準ボタンに設定する (指定値 512) には、両者の値を加えた 3 + 512 = 515 を指定します。
+
なお、表示ボタンの指定用パラメータ値に次の値を加えることで、いずれか 1 つのボタンを標準ボタンに設定できます。たとえば、はい、いいえ、キャンセルの各ボタンを表示させ (指定値 3)、キャンセルを標準ボタンに設定する (指定値 512) には、両者の値を加えた 3 + 512 = 515 を指定します。
  
* <tt>0</tt> - 1 番目の\'83\'7bタンを標準\'83\'7bタンに設定します。
+
* <tt>0</tt> - 1 番目のボタンを標準ボタンに設定します。
* <tt>256</tt> - 2 番目の\'83\'7bタンを標準\'83\'7bタンに設定します。
+
* <tt>256</tt> - 2 番目のボタンを標準ボタンに設定します。
* <tt>512</tt> - 3 番目の\'83\'7bタンを標準\'83\'7bタンに設定します。
+
* <tt>512</tt> - 3 番目のボタンを標準ボタンに設定します。
  
また、以下の値をパラメータ値に加えることで、該当するアイコンを追加\'95\'5c示できます。
+
また、次の値をパラメータ値に加えることで、該当するアイコンを追加表示できます。
  
* <tt>16</tt> -ストップ記号のアイコンを\'95\'5c示します。
+
* <tt>16</tt> -ストップ記号のアイコンを表示します。
* <tt>32</tt> - ▼疑問符アイコンを\'95\'5c示します。
+
* <tt>32</tt> - 疑問符アイコンを表示します。
* <tt>48</tt> - ▼感嘆符アイコンを\'95\'5c示します。
+
* <tt>48</tt> - 感嘆符アイコンを表示します。
* <tt>64</tt> - ヒント記号のアイコンを\'95\'5c示します。
+
* <tt>64</tt> - ヒント記号のアイコンを表示します。
  
この場合は、はいといいえの\'83\'7bタンを表示させて (指定値 4)、2 番目のボタン (いいえ) を標準ボタンに設定し (指定値 256)、疑問符アイコンを表示させる (指定値 32) ので、パラメータ値として 4 + 256 + 32 = 292 を指定します。
+
この場合は、はいといいえのボタンを表示させて (指定値 4)、2 番目のボタン (いいえ) を標準ボタンに設定し (指定値 256)、疑問符アイコンを表示させる (指定値 32) ので、パラメータ値として 4 + 256 + 32 = 292 を指定します。
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 45: Line 47:
 
</source>
 
</source>
  
メッセージ\'83\'7bックスに複数の\'83\'7bタンを\'95\'5c示した場合、通常は、どの\'83\'7bタンをユーザーが押したかを確認する処理が必要となります。このような処理には、以下の戻り値を利用します。
+
メッセージボックスに複数のボタンを表示した場合、通常は、どのボタンをユーザーが押したかを確認する処理が必要となります。このような処理には、次の戻り値を利用します。
  
 
* <tt>1</tt> - OK
 
* <tt>1</tt> - OK
* <tt>2</tt> - Cancel
+
* <tt>2</tt> - キャンセル
 
* <tt>3</tt> - 終了
 
* <tt>3</tt> - 終了
 
* <tt>4</tt> - やり直し
 
* <tt>4</tt> - やり直し
Line 55: Line 57:
 
* <tt>7</tt> - いいえ  
 
* <tt>7</tt> - いいえ  
  
たとえば先のサンプルコードの場合、戻り値の判定は以下のようにして行えます。
+
たとえば先のサンプルコードの場合、戻り値の判定は次のようにして行えます。
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 73: Line 75:
 
このメッセージボックスのタイトル指定を省略した場合、「soffice」が標準タイトルとして使用されます。
 
このメッセージボックスのタイトル指定を省略した場合、「soffice」が標準タイトルとして使用されます。
  
== インプット\'83\'7bックスと簡単な文字列入力 ==
+
== インプットボックスと簡単な文字列入力 ==
  
ユーザーからの簡単な文字列入力を受け付けるには、<tt>InputBox 関数を使用します。</tt>このような処理に関しては、ダイアログを\'8d\'5c築するよりも、この関数を利用する方が簡単です。<tt>InputBox</tt> 関数には、以下の 3 つのパラメータを指定します。
+
ユーザーからの簡単な文字列入力を受け付けるには、<tt>InputBox</tt> 関数を使用します。このような処理に関しては、ダイアログを構築するよりも、この関数を利用する方が簡単です。<tt>InputBox</tt> 関数には、次の 3 つのパラメータを指定します。
  
 
* 説明用のテキスト
 
* 説明用のテキスト

Revision as of 22:08, 27 November 2008

doc OOo
Book.png

Apache OpenOffice Basic には、ユーザーへの入出力用に、MsgBox および InputBox 関数が用意されています。

メッセージの出力

MsgBox を使うと、簡単なメッセージ表示用のダイアログを表示できるだけでなく、その中に 1つまたは複数のボタンを配置できます。最も簡単なバリアントでは、MsgBox に含まれるのはテキストと OK ボタンだけです。

MsgBox "This is a piece of information!"

メッセージボックスの表示形態は、パラメータ指定により変更できます。ここでは、ボタンの種類、標準ボタン、追加表示するアイコンをパラメータ指定により設定できます。ボタンの指定は、次の数値を通じて行います。

  • 0 - OK ボタンのみを表示します。
  • 1 - OK およびキャンセルの各ボタンを表示します。
  • 2 - 中止、やり直し、および取消しボタンの各ボタンを表示します。
  • 3 - はい、いいえ、キャンセルの各ボタンを表示します。
  • 4 - はい、いいえの各ボタンを表示します。
  • 5 - やり直しおよびキャンセルの各ボタンを表示します。

なお、表示ボタンの指定用パラメータ値に次の値を加えることで、いずれか 1 つのボタンを標準ボタンに設定できます。たとえば、はい、いいえ、キャンセルの各ボタンを表示させ (指定値 3)、キャンセルを標準ボタンに設定する (指定値 512) には、両者の値を加えた 3 + 512 = 515 を指定します。

  • 0 - 1 番目のボタンを標準ボタンに設定します。
  • 256 - 2 番目のボタンを標準ボタンに設定します。
  • 512 - 3 番目のボタンを標準ボタンに設定します。

また、次の値をパラメータ値に加えることで、該当するアイコンを追加表示できます。

  • 16 -ストップ記号のアイコンを表示します。
  • 32 - 疑問符アイコンを表示します。
  • 48 - 感嘆符アイコンを表示します。
  • 64 - ヒント記号のアイコンを表示します。

この場合は、はいといいえのボタンを表示させて (指定値 4)、2 番目のボタン (いいえ) を標準ボタンに設定し (指定値 256)、疑問符アイコンを表示させる (指定値 32) ので、パラメータ値として 4 + 256 + 32 = 292 を指定します。

MsgBox "Do you want to continue?",  292

メッセージボックスに複数のボタンを表示した場合、通常は、どのボタンをユーザーが押したかを確認する処理が必要となります。このような処理には、次の戻り値を利用します。

  • 1 - OK
  • 2 - キャンセル
  • 3 - 終了
  • 4 - やり直し
  • 5 - 無視する記号・文字
  • 6 - はい
  • 7 - いいえ

たとえば先のサンプルコードの場合、戻り値の判定は次のようにして行えます。

If MsgBox ("Do you want to continue?",  292) = 6 Then
  ' Yes button pressed
Else
  ' No button pressed
End IF

MsgBox では、メッセージとして表示するテキストおよび表示ボタンの指定用パラメータの他に、第 3 のパラメータとしてメッセージボックスのタイトルを設定できます。

MsgBox "Do you want to continue?",  292, "Box Title"

このメッセージボックスのタイトル指定を省略した場合、「soffice」が標準タイトルとして使用されます。

インプットボックスと簡単な文字列入力

ユーザーからの簡単な文字列入力を受け付けるには、InputBox 関数を使用します。このような処理に関しては、ダイアログを構築するよりも、この関数を利用する方が簡単です。InputBox 関数には、次の 3 つのパラメータを指定します。

  • 説明用のテキスト
  • インプットボックスのタイトル
  • 入力フィールドに表示しておく標準値
InputVal = InputBox("Please enter value:", "Test", "default value")

InputBox 関数の戻り値には、ユーザーの入力した文字列が返されます。

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools