Finestre di messaggio e caselle di immissione (libreria runtime di OpenOffice.org)

From Apache OpenOffice Wiki
Jump to: navigation, search

OpenOffice.org 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