Finestre di messaggio e caselle di immissione (libreria runtime di Apache OpenOffice)

From Apache OpenOffice Wiki
Jump to: navigation, search

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