Elementi di controllo dei formulari in dettaglio

From Apache OpenOffice Wiki
Jump to: navigation, search


Gli elementi di controllo disponibili nei formulari sono simili a quelli disponibili nelle finestre di dialogo. Gli elementi a disposizione variano da semplici campi di testo a elenchi, caselle combinate e diversi pulsanti.

Di seguito viene fornito un elenco delle proprietà principali degli elementi di controllo dei formulari. Tutte le proprietà formano parte degli oggetti modello associati.

Oltre agli elementi di controllo standard, per i formulari è disponibile anche un elemento di controllo delle tabelle, che permette di incorporare tabelle di database. Questo argomento è descritto nel capitolo Formulari basati su database.

Pulsanti

L'oggetto modello di un pulsante di formulario fornisce le seguenti proprietà:

BackgroundColor (long)
Colore dello sfondo
DefaultButton (Boolean)
Il pulsante funge da valore predefinito; in questo caso, risponde anche al pulsante di immissione se non è attivato
Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Tag (String)
Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
TargetURL (String)
URL di destinazione per i pulsanti di tipo URL
TargetFrame (String)
Nome della finestra (o cornice) in cui aprire TargetURL all'attivazione del pulsante (per i pulsanti di tipo URL)
Label (String)
Etichetta del pulsante
TextColor (Long)
Colore del testo dell'elemento di controllo
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo.
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente
ButtonType (Enum)
Azione collegata al pulsante (valore predefinito di com.sun.star.form.FormButtonType)

Tramite la proprietà ButtonType è possibile definire un'azione che viene eseguita automaticamente alla pressione del pulsante. Il gruppo di costanti associato com.sun.star.form.FormButtonType fornisce i seguenti valori:

PUSH
Pulsante standard
SUBMIT
Fine dell'immissione del formulario (di particolare rilevanza per i formulari HTML)
RESET
Ripristina tutti i valori del formulario sui valori originali
URL
Chiamata dell'URL definito in TargetURL (è aperto nella finestra specificata tramite TargetFrame)

I tipi di pulsanti OK e Annulla disponibili nelle finestre di dialogo non sono supportati nei formulari.

Pulsanti di scelta

Tramite l'oggetto del modello di un pulsante di scelta sono disponibili le proprietà seguenti:

Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Tag (String)
Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
Label (String)
Etichetta del pulsante
Printable (Boolean)
L'elemento di controllo può essere stampato
State (Short)
Se la proprietà è uguale a 1, l'opzione è attivata, altrimenti è disattivata
RefValue (String)
Stringa per il salvataggio di informazioni aggiuntive, ad esempio per la gestione degli ID dei record di dati
TextColor (Long)
Colore del testo dell'elemento di controllo
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Il meccanismo di raggruppamento dei pulsanti di scelta opera una distinzione tra gli elementi di controllo delle finestre di dialogo e dei formulari. Mentre gli elementi di controllo visualizzati uno dopo l'altro nelle finestre di dialogo vengono combinati automaticamente per formare un gruppo, il raggruppamento nei formulari avviene in base ai nomi. Per procedere in tal senso, tutti i pulsanti di scelta di un gruppo devono contenere lo stesso nome. OpenOffice.org combina gli elementi di controllo raggruppati in una matrice, in modo che i singoli pulsanti di un programma in OpenOffice.org Basic si possano raggiungere secondo le modalità utilizzate in precedenza.

L'esempio seguente mostra come determinare il modello di un gruppo di elementi di controllo.

Dim Doc As Object
Dim Forms As Object
Dim Form As Object
Dim Ctl As Object
Dim I as Integer
 
Doc = StarDesktop.CurrentComponent
Forms = Doc.Drawpage.Forms
 
For I = 0 To Forms.Count - 1
  Form = Forms.GetbyIndex(I)
  If Form.HasByName("MyOptions") Then
    Ctl = Form. GetGroupbyName("MyOptions")
    Exit Function
  End If
Next I

Il codice corrisponde all'esempio precedente per la determinazione di un modello di elemento di controllo semplice. Esegue una ricerca in tutti i formulari del documento di testo corrente in un ciclo e utilizza il metodo HasByName per controllare se il formulario corrispondente contiene un elemento con il nome MyOptions ricercato. Se l'elemento viene individuato, l'accesso alla matrice del modello viene eseguito tramite il metodo GetGroupByName anziché tramite il metodo GetByName, utilizzato per determinare i modelli semplici.

Caselle di controllo

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

Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Tag (String)
Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
Label (String)
Etichetta del pulsante
Printable (Boolean)
L'elemento di controllo può essere stampato
State (Short)
Se la proprietà è uguale a 1, l'opzione è attivata, altrimenti è disattivata
RefValue (String)
Stringa per il salvataggio di informazioni aggiuntive, ad esempio per la gestione degli ID dei record di dati
TextColor (Long)
Colore del testo dell'elemento di controllo
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Campi di testo

L'oggetto modello di un campo di testo fornisce le seguenti proprietà:

Align (short)
Orientamento del testo (0: allineato a sinistra, 1: centrato, 2: allineato a destra)
BackgroundColor (long)
Colore di sfondo dell'elemento di controllo
Border (short)
Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
EchoChar (String)
Carattere eco per i campi delle password
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
HardLineBreaks (Boolean)
Interruzioni di riga automatiche inserite in modo permanente nel testo dell'elemento di controllo
HScroll (Boolean)
Il testo presenta una barra di scorrimento orizzontale
MaxTextLen (Short)
Lunghezza massima del testo; se è pari a 0, non sono presenti limiti
MultiLine (Boolean)
Consente voci su più righe
Printable (Boolean)
L'elemento di controllo può essere stampato
ReadOnly (Boolean)
Il contenuto dell'elemento di controllo è di sola lettura.
Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Text (String)
Testo dell'elemento di controllo
TextColor (Long)
Colore del testo dell'elemento di controllo
VScroll (Boolean)
Il testo presenta una barra di scorrimento verticale
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

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

BackgroundColor (long)
Colore di sfondo dell'elemento di controllo
Border (short)
Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
FontDescriptor (struct)
Struttura che specifica i dettagli del carattere utilizzato (in conformità alla struttura com.sun.star.awt.FontDescriptor)
LineCount (Short)
Numero di righe nell'elemento di controllo
MultiSelection (Boolean)
Consente la selezione multipla delle voci
SelectedItems (Array of Strings)
Elenco delle voci evidenziate
StringItemList (Array of Strings)
Elenco di tutte le voci
ValueItemList (Array of Variant)
Elenco contenente informazioni aggiuntive per ogni voce, ad esempio per la gestione degli ID dei record di dati
Printable (Boolean)
L'elemento di controllo può essere stampato
ReadOnly (Boolean)
Il contenuto dell'elemento di controllo è di sola lettura.
Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Tag (String)
Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
TextColor (Long)
Colore del testo dell'elemento di controllo
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente
Documentation note.png Attraverso la proprietà ValueItemList, i formulari con caselle di riepilogo forniscono una controparte alla proprietà ItemData di VBA attraverso la quale gestire informazioni aggiuntive per le singole voci dell'elenco.

Inoltre, tramite l'oggetto vista della casella di riepilogo sono disponibili 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 all'interno dell'elenco, nella posizione Pos
removeItems (Pos, Count)
Rimuove le voci Count dalla posizione Pos
selectItem (Item, SelectMode)
Attiva o disattiva l'evidenziazione dell'elemento specificato nella stringa Item in base alla variabile SelectMode
makeVisible (Pos)
Scorre il campo in modo che la voce specificata con Pos sia visibile
Content on this page is licensed under the Public Documentation License (PDL).
Personal tools