Elementi di controllo delle finestre di dialogo in dettaglio
Template:EN/Documentation/BASICGuideTOC/v2
Apache OpenOffice 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 |
|---|---|---|---|
|
|
|
|
Contents
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, Apache OpenOffice è avviato automaticamente con un nuovo gruppo di elementi di controllo attivabile indipendentemente dal primo gruppo di elementi di controllo.
 |
Diversamente che in VBA, in Apache OpenOffice Basic non è possibile inserire i pulsanti di scelta in un gruppo di elementi di controllo. Il raggruppamento degli elementi di controllo è utilizzato in Apache OpenOffice 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
Caselle di riepilogo
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
|
L'opzione di VBA per l'emissione delle voci di elenco con un valore numerico addizionale (ItemData) non esiste in Apache OpenOffice 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). |
