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

From Apache OpenOffice Wiki
Jump to: navigation, search
(New page: {{DISPLAYTITLE: メッセージボックスとインプットボックス ({{OOo}} 実行時ライブラリ) }} {{EN/Documentation/BASICGuideTOC/v2 ...)
 
 
Line 1: Line 1:
{{DISPLAYTITLE:
+
{{DISPLAYTITLE:Finestre di messaggio e caselle di immissione ({{OOo}} libreria runtime)}}
                    メッセージボックスとインプットボックス ({{OOo}} 実行時ライブラリ)
+
                    }}
+
 
{{EN/Documentation/BASICGuideTOC/v2
 
{{EN/Documentation/BASICGuideTOC/v2
 
|ShowPrevNext=block
 
|ShowPrevNext=block
Line 10: Line 8:
 
}}
 
}}
 
   
 
   
{{OOo}} Basic には、ユーザーへの入出力用に、<tt>MsgBox</tt> および <tt>InputBox</tt> 関数が用意されています。
+
{{OOo}} Basic fornisce le funzioni <tt>MsgBox</tt> e <tt>InputBox</tt> per le comunicazioni base
 +
degli utenti.
  
== メッセージの出力 ==
+
== Visualizzazione dei messaggi ==
<tt>MsgBox</tt> を使うと、簡単なメッセージ\'95\'5c示用のダイアログを\'95\'5c示できるだけでなく、その中に 1つまたは複数の\'83\'7bタンを配置できます。最も簡単なバリアントでは、<tt>MsgBox</tt> に含まれるのはテキストと OK ボタンだけです。
+
<tt>MsgBox</tt> visualizza una semplice casella di informazioni, che può avere uno o più pulsanti. Nella sua variante più semplice <tt>MsgBox</tt> contiene solo del testo e un pulsante OK.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 19: Line 18:
 
</source>
 
</source>
  
メッセージ\'83\'7bックスの\'95\'5c示形態は、パラメータ指定により変更できます。ここでは、\'83\'7bタンの種類、標準\'83\'7bタン、追加\'95\'5c示するアイコンをパラメータ指定により設定できます。\'83\'7bタンの指定は、以下の数値を通じて行います。
+
L'aspetto della casella di informazioni può essere modificato utilizzando un parametro. Questo parametro consente di aggiungere ulteriori pulsanti, definire il pulsante preassegnato e inserire un simbolo di informazione. I valori per la selezione dei pulsanti sono i seguenti:
  
* <tt>0</tt> - OK \'83\'7bタンのみを\'95\'5c示します。
+
* <tt>0</tt> - Pulsante OK
* <tt>1</tt> - OK およびキャンセルの各\'83\'7bタンを\'95\'5c示します。
+
* <tt>1</tt> - Pulsanti OK e Annulla
* <tt>2</tt> - 中止、やり直し、および取消しボタンの各ボタンを表示します。
+
* <tt>2</tt> - Pulsanti Interrompi, Riprova e Ignora
* <tt>3</tt> - はい、いいえ、キャンセルの各\'83\'7bタンを\'95\'5c示します。
+
* <tt>3</tt> - Pulsanti Sì, No e Annulla
* <tt>4</tt> - はい、いいえの各\'83\'7bタンを\'95\'5c示します。
+
* <tt>4</tt> - Pulsanti Sì e No
* <tt>5</tt> - やり直しおよびキャンセルの各\'83\'7bタンを\'95\'5c示します。
+
* <tt>5</tt> - Pulsanti Riprova e Annulla
  
なお、\'95\'5c示\'83\'7bタンの指定用パラメータ値に以下の値を加えることで、いずれか 1 つの\'83\'7bタンを標準\'83\'7bタンに設定できます。たとえば、はい、いいえ、キャンセルの各ボタンを表示させ (指定値 3)、キャンセルを標準ボタンに設定する (指定値 512) には、両者の値を加えた 3 + 512 = 515 を指定します。
+
Per impostare un pulsante come predefinito, aggiungere uno dei valori seguenti al valore del parametro dell'elenco di selezione pulsanti. Ad esempio, per creare i pulsanti Sì, No e Annulla (valore 3) con Annulla come valore predefinito (valore 512), il valore del parametro sarà 3 + 512 = 515.
  
* <tt>0</tt> - 1 番目の\'83\'7bタンを標準\'83\'7bタンに設定します。
+
* <tt>0</tt> - Il primo pulsante è il valore predefinito
* <tt>256</tt> - 2 番目の\'83\'7bタンを標準\'83\'7bタンに設定します。
+
* <tt>256</tt> - Il secondo pulsante è il valore predefinito
* <tt>512</tt> - 3 番目の\'83\'7bタンを標準\'83\'7bタンに設定します。
+
* <tt>512</tt> - Il terzo pulsante è il valore predefinito
  
また、以下の値をパラメータ値に加えることで、該当するアイコンを追加\'95\'5c示できます。
+
Infine, sono disponibili i seguenti simboli di informazione, visualizzabili mediante l'inserimento dei valori di parametro pertinenti:
  
* <tt>16</tt> -ストップ記号のアイコンを\'95\'5c示します。
+
* <tt>16</tt> - Simbolo di stop
* <tt>32</tt> - ▼疑問符アイコンを\'95\'5c示します。
+
* <tt>32</tt> - Punto interrogativo
* <tt>48</tt> - ▼感嘆符アイコンを\'95\'5c示します。
+
* <tt>48</tt> - Punto esclamativo
* <tt>64</tt> - ヒント記号のアイコンを\'95\'5c示します。
+
* <tt>64</tt> - Simbolo di suggerimento
  
この場合は、はいといいえの\'83\'7bタンを表示させて (指定値 4)、2 番目のボタン (いいえ) を標準ボタンに設定し (指定値 256)、疑問符アイコンを表示させる (指定値 32) ので、パラメータ値として 4 + 256 + 32 = 292 を指定します。
+
La chiamata seguente visualizza una casella di informazioni con i pulsanti Sì e No (valore 4), in cui il secondo pulsante (No) è impostato come valore predefinito (valore 256) e inserisce anche
 +
un punto interrogativo (valore 32), 4+256+32=292.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 47: Line 47:
 
</source>
 
</source>
  
メッセージ\'83\'7bックスに複数の\'83\'7bタンを\'95\'5c示した場合、通常は、どの\'83\'7bタンをユーザーが押したかを確認する処理が必要となります。このような処理には、以下の戻り値を利用します。
+
Se una casella di informazioni contiene diversi pulsanti, dovrete ricercare un valore restituito per determinare quale pulsante è stato premuto. In questo caso sono disponibili i valori seguenti:
  
* <tt>1</tt> - OK
+
* <tt>1</tt> - OK  
* <tt>2</tt> - Cancel
+
* <tt>2</tt> - Annulla
* <tt>3</tt> - 終了
+
* <tt>3</tt> - Termina
* <tt>4</tt> - やり直し
+
* <tt>4</tt> - Riprova
* <tt>5</tt> - 無視する記号・文字
+
* <tt>5</tt> - Ignora
* <tt>6</tt> - はい
+
* <tt>6</tt> -
* <tt>7</tt> - いいえ
+
* <tt>7</tt> - No
  
たとえば先のサンプルコードの場合、戻り値の判定は以下のようにして行えます。
+
Nell'esempio precedente, il controllo dei valori restituiti potrebbe avere la forma seguente:
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 67: Line 67:
 
</source>
 
</source>
  
<tt>MsgBox</tt> では、メッセージとして表示するテキストおよび表示ボタンの指定用パラメータの他に、第 3 のパラメータとしてメッセージボックスのタイトルを設定できます。
+
Oltre al testo informativo e al parametro per organizzare la casella informativa, <tt>MsgBox</tt> ammette anche un terzo parametro, che definisce il testo per il titolo della casella:
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 73: Line 73:
 
</source>
 
</source>
  
このメッセージボックスのタイトル指定を省略した場合、「soffice」が標準タイトルとして使用されます。
+
Qualora non venga specificato un titolo, l'opzione predefinita è "soffice".
  
== インプット\'83\'7bックスと簡単な文字列入力 ==
+
== Casella di immissione delle ricerche di stringhe
 +
semplici ==
  
ユーザーからの簡単な文字列入力を受け付けるには、<tt>InputBox 関数を使用します。</tt>このような処理に関しては、ダイアログを\'8d\'5c築するよりも、この関数を利用する方が簡単です。<tt>InputBox</tt> 関数には、以下の 3 つのパラメータを指定します。
+
La funzione <tt>InputBox</tt> consente all'utente di eseguire ricerche nelle stringhe semplici. Costituisce pertanto una semplice alternativa alla configurazione di finestre di dialogo. <tt>InputBox</tt> accetta tre parametri standard:
  
* 説明用のテキスト
+
* Un testo informativo.
* インプットボックスのタイトル
+
* Un titolo della casella.
* 入力フィールドに表示しておく標準値
+
* Un valore predefinito da inserire nell'area di digitazione.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 87: Line 88:
 
</source>
 
</source>
  
<tt>InputBox</tt> 関数の戻り値には、ユーザーの入力した文字列が返されます。
+
Come valore restituito <tt>InputBox</tt> fornisce la stringa immessa dall'utente.
  
 
{{PDL1}}
 
{{PDL1}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Message and Input Boxes (Runtime Library)}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Message and Input Boxes (Runtime Library)}}

Latest revision as of 18:20, 25 June 2009

Template:EN/Documentation/BASICGuideTOC/v2

Apache OpenOffice Basic fornisce le funzioni MsgBox e InputBox per le comunicazioni base degli utenti.

Visualizzazione dei messaggi

MsgBox visualizza una semplice casella di informazioni, che può avere uno o più pulsanti. Nella sua variante più semplice MsgBox contiene solo del testo e un pulsante OK.

MsgBox "This is a piece of information!"

L'aspetto della casella di informazioni può essere modificato utilizzando un parametro. Questo parametro consente di aggiungere ulteriori pulsanti, definire il pulsante preassegnato e inserire un simbolo di informazione. I valori per la selezione dei pulsanti sono i seguenti:

  • 0 - Pulsante OK
  • 1 - Pulsanti OK e Annulla
  • 2 - Pulsanti Interrompi, Riprova e Ignora
  • 3 - Pulsanti Sì, No e Annulla
  • 4 - Pulsanti Sì e No
  • 5 - Pulsanti Riprova e Annulla

Per impostare un pulsante come predefinito, aggiungere uno dei valori seguenti al valore del parametro dell'elenco di selezione pulsanti. Ad esempio, per creare i pulsanti Sì, No e Annulla (valore 3) con Annulla come valore predefinito (valore 512), il valore del parametro sarà 3 + 512 = 515.

  • 0 - Il primo pulsante è il valore predefinito
  • 256 - Il secondo pulsante è il valore predefinito
  • 512 - Il terzo pulsante è il valore predefinito

Infine, sono disponibili i seguenti simboli di informazione, visualizzabili mediante l'inserimento dei valori di parametro pertinenti:

  • 16 - Simbolo di stop
  • 32 - Punto interrogativo
  • 48 - Punto esclamativo
  • 64 - Simbolo di suggerimento

La chiamata seguente visualizza una casella di informazioni con i pulsanti Sì e No (valore 4), in cui il secondo pulsante (No) è impostato come valore predefinito (valore 256) e inserisce anche un punto interrogativo (valore 32), 4+256+32=292.

MsgBox "Do you want to continue?",  292

Se una casella di informazioni contiene diversi pulsanti, dovrete ricercare un valore restituito per determinare quale pulsante è stato premuto. In questo caso sono disponibili i valori seguenti:

  • 1 - OK
  • 2 - Annulla
  • 3 - Termina
  • 4 - Riprova
  • 5 - Ignora
  • 6 - Sì
  • 7 - No

Nell'esempio precedente, il controllo dei valori restituiti potrebbe avere la forma seguente:

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

Oltre al testo informativo e al parametro per organizzare la casella informativa, MsgBox ammette anche un terzo parametro, che definisce il testo per il titolo della casella:

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

Qualora non venga specificato un titolo, l'opzione predefinita è "soffice".

== Casella di immissione delle ricerche di stringhe semplici ==

La funzione InputBox consente all'utente di eseguire ricerche nelle stringhe semplici. Costituisce pertanto una semplice alternativa alla configurazione di finestre di dialogo. InputBox accetta tre parametri standard:

  • Un testo informativo.
  • Un titolo della casella.
  • Un valore predefinito da inserire nell'area di digitazione.
InputVal = InputBox("Please enter value:", "Test", "default value")

Come valore restituito InputBox fornisce la stringa immessa dall'utente.

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