Elementi di controllo delle finestre di dialogo in dettaglio

From Apache OpenOffice Wiki
Jump to: navigation, search


OpenOffice.org Basic riconosce una serie di elementi di controllo che si possono suddividere nei seguenti gruppi:

Campi di immissione Pulsanti Caselle di selezione Altri elementi di controllo
  • Campi di testo
  • Campi per la data
  • Campi per l'ora
  • Campi numerici
  • Campi di valuta
  • Campi che adottano qualsiasi formato
  • Pulsanti standard
  • Caselle di controllo
  • Pulsanti di scelta
  • Caselle di riepilogo
  • Caselle combinate
  • Barre di scorrimento (orizzontali e verticali)
  • Campi di gruppi
  • Barre di avanzamento
  • Linee di divisione (orizzontali e verticali)
  • Immagini
  • Campi di selezione file

Pulsanti

Un pulsante esegue un'azione quando si fa clic su di esso.

Lo scenario più semplice è quello dell'attivazione di un evento When Initiating alla pressione del pulsante da parte dell'utente. È inoltre possibile collegare un'altra azione al pulsante per aprire una finestra di dialogo utilizzando la proprietà PushButtonType. Quando si fa clic su un pulsante per il quale questa proprietà è stata impostata sul valore 0, la finestra di dialogo rimarrà invariata. Se si fa clic su un pulsante per il quale questa proprietà è stata impostata sul valore 1, la finestra di dialogo viene chiusa e il metodo Execute della finestra di dialogo restituisce il valore 1 (la sequenza è stata terminata correttamente). Se il valore di PushButtonType è 2, la finestra di dialogo viene chiusa e il metodo Execute della finestra di dialogo restituisce 0 (finestra di dialogo chiusa).

Di seguito sono riportate tutte le proprietà disponibili tramite il modello del pulsante:

Model.BackgroundColor (long)
Colore dello sfondo
Model.DefaultButton (Boolean)
Il pulsante è utilizzato come valore predefinito e risponde al tasto Invio se non è attivato.
Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.Label (String)
Etichetta visualizzata sul pulsante
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.HelpText (String)
Testo della guida in linea che viene visualizzato quando si porta il puntatore del mouse sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente
PushButtonType (short)
Azione collegata al pulsante (0: nessuna azione, 1: OK, 2: Annulla)

Pulsanti di scelta

Questi pulsanti sono generalmente utilizzati in gruppi e permettono di selezionare un'opzione da una serie. Quando si seleziona un'opzione, tutte le altre opzioni del gruppo vengono disattivate. Ciò garantisce che in ogni momento sia impostato un solo pulsante di scelta.

L'elemento di controllo di un pulsante di scelta fornisce due proprietà:

State (Boolean)
Attiva il pulsante
Label (String)
Etichetta visualizzata sul pulsante

Potete utilizzare le seguenti proprietà del modello dei pulsanti di scelta:

Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.Label (String)
Etichetta visualizzata sull'elemento di controllo
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.State (Short)
Se questa proprietà è uguale a 1, l'opzione è attivata, altrimenti è disattivata
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.HelpText (String)
Testo della guida in linea che viene visualizzato quando il puntatore del mouse si trova sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Per combinare diversi pulsanti di scelta in un gruppo, occorre posizionarli uno dopo l'altro nella sequenza di attivazione senza spazi (proprietà Model.TabIndex, descritta come sequenza nel Dialog Editor). Se la sequenza di attivazione viene interrotta da un altro elemento di controllo, OpenOffice.org è avviato automaticamente con un nuovo gruppo di elementi di controllo attivabile indipendentemente dal primo gruppo di elementi di controllo.

Documentation note.png Diversamente che in VBA, in OpenOffice.org Basic non è possibile inserire i pulsanti di scelta in un gruppo di elementi di controllo. Il raggruppamento degli elementi di controllo è utilizzato in OpenOffice.org Basic solo per garantire una suddivisione visiva rappresentata da una cornice intorno agli elementi di controllo.

Caselle di controllo

Le caselle di controllo vengono utilizzate per registrare un valore Sì o No e, a seconda della modalità, possono adottare due o tre stati. Oltre agli stati Sì e No, una casella di controllo può disporre di uno stato intermedio se lo stato Sì o No corrispondente ha più di un significato o non è chiaro.

Le caselle di controllo forniscono le proprietà seguenti:

State (Short)
Stato della casella di controllo (0: no, 1: sì, 2: stato intermedio)
Label (String)
Etichetta dell'elemento di controllo
enableTriState (Boolean)
Oltre agli stati attivati e disattivati, potete utilizzare anche lo stato intermedio

L'oggetto modello di una casella di controllo fornisce le seguenti proprietà:

Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.Label (String)
Etichetta dell'elemento di controllo
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.State (Short)
Stato della casella di controllo (0: no, 1: sì, 2: stato intermedio)
Model.Tabstop (Boolean)
Consente di selezionare l'elemento di controllo con il tasto Tab
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.HelpText (String)
Testo della guida in linea che viene visualizzato quando si posiziona il puntatore del mouse sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Campi di testo

I campi di testo consentono agli utenti di inserire numeri e testo. Il servizio com.sun.star.awt.UnoControlEdit. costituisce la base per i campi di testo.

Un campo di testo può contenere una o più righe e può essere modificato o bloccato per le immissioni degli utenti. I campi di testo possono essere utilizzati anche come campi numerici e di valuta speciali nonché per attività speciali. Poiché questi elementi di controllo sono basati sul servizio UnoControlEdit Uno, la loro gestione controllata da programma è analoga.

I campi di testo forniscono le proprietà seguenti:

Text (String)
Testo corrente
SelectedText (String)
Testo attualmente evidenziato
Selection (Struct)
Evidenziazione in sola lettura dei dettagli (struttura conforme a com.sun.star.awt.Selection, con le proprietà Min e Max per specificare l'inizio e la fine dell'evidenziazione)
MaxTextLen (short)
Numero massimo di caratteri che si possono inserire nel campo
Editable (Boolean)
True attiva l'opzione per l'inserimento del testo, False blocca l'opzione di inserimento (la proprietà non può essere richiamata direttamente, ma solo tramite IsEditable)
IsEditable (Boolean)
Il contenuto dell'elemento di controllo può essere modificato in sola lettura.

Inoltre, sono fornite le seguenti proprietà tramite l'oggetto del modello associato:

Model.Align (short)
Orientamento del testo (0: allineato a sinistra, 1: centrato, 2: allineato a destra)
Model.BackgroundColor (long)
Colore di sfondo dell'elemento di controllo
Model.Border (short)
Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
Model.EchoChar (String)
Carattere eco per i campi delle password
Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.HardLineBreaks (Boolean)
Interruzioni di riga automatiche inserite in modo permanente nel testo dell'elemento di controllo
Model.HScroll (Boolean)
Il testo ha una barra di scorrimento orizzontale
Model.MaxTextLen (Short)
Lunghezza massima del testo, dove 0 corrisponde a nessun limite di lunghezza
Model.MultiLine (Boolean)
Consente alla voce di occupare diverse righe
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.ReadOnly (Boolean)
Il contenuto dell'elemento di controllo è in sola lettura
Model.Tabstop (Boolean)
Consente di raggiungere l'elemento di controllo con il tasto Tab
Model.Text (String)
Testo associato all'elemento di controllo
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.VScroll (Boolean)
Il testo ha una barra di scorrimento verticale
Model.HelpText (String)
Testo della guida in linea che viene visualizzato quando il puntatore del mouse si trova sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Le caselle di riepilogo (servizio com.sun.star.awt.UnoControlListBox) supportano le seguenti proprietà:

ItemCount (Short)
Numero di elementi, sola lettura
SelectedItem (String)
Testo della voce evidenziata, sola lettura
SelectedItems (Array Of Strings)
Campo di dati con voci evidenziate, sola lettura
SelectItemPos (Short)
Numero della voce attualmente evidenziata, sola lettura
SelectItemsPos (Array of Short)
Campo di dati con il numero di voci evidenziate (per gli elenchi che supportano la selezione multipla), sola lettura
MultipleMode (Boolean)
True attiva l'opzione per la selezione di più elementi, False blocca la selezione multipla (la proprietà non può essere richiamata direttamente, ma solo tramiteIsMultipleMode)
IsMultipleMode (Boolean)
Consente la selezione multipla all'interno degli elenchi, sola lettura

Le caselle di riepilogo forniscono i metodi seguenti:

addItem (Item, Pos)
Inserisce la stringa specificata in Item nell'elenco, nella posizione Pos
addItems (ItemArray, Pos)
Inserisce le voci elencate nel campo dati ItemArray della stringa nell'elenco nella posizione Pos
removeItems (Pos, Count)
Rimuove le voci Count della posizione Pos
selectItem (Item, SelectMode)
Attiva o disattiva l'evidenziazione dell'elemento specificato nella stringaItem in base alla variabile booleana SelectMode
makeVisible (Pos)
Scorre il campo in modo che risulti visibile la voce specificata con Pos

L'oggetto modello delle caselle di riepilogo fornisce le seguenti proprietà:

Model.BackgroundColor (long)
Colore di sfondo dell'elemento di controllo
Model.Border (short)
Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.LineCount (Short)
Numero di righe nell'elemento di controllo
Model.MultiSelection (Boolean)
Consente la selezione multipla delle voci
Model.SelectedItems (Array of Strings)
Elenco delle voci evidenziate
Model.StringItemList (Array of Strings)
Elenco di tutte le voci
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.ReadOnly (Boolean)
Il contenuto dell'elemento di controllo è in sola lettura
Model.Tabstop (Boolean)
Consente di selezionare l'elemento di controllo con il tasto Tab
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.HelpText (String)
Visualizza automaticamente il testo della guida in linea quando il puntatore del mouse è posizionato sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente
Documentation note.png L'opzione di VBA per l'emissione delle voci di elenco con un valore numerico addizionale (ItemData) non esiste in OpenOffice.org Basic. Per gestire un valore numerico (ad esempio un ID di database) oltre al testo in linguaggio naturale, occorre creare un campo di dati ausiliario di gestione parallela alla casella di riepilogo.
Content on this page is licensed under the Public Documentation License (PDL).
Personal tools