Difference between revisions of "IT/Documentation/BASIC Guide/Control Element Forms"
(One intermediate revision by one other user not shown) | |||
Line 140: | Line 140: | ||
;<tt>BackgroundColor (long)</tt>:Colore di sfondo dell'elemento di controllo | ;<tt>BackgroundColor (long)</tt>:Colore di sfondo dell'elemento di controllo | ||
;<tt>Border (short)</tt>:Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice) | ;<tt>Border (short)</tt>:Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice) | ||
− | ;<tt>FontDescriptor (struct)</tt>:Struttura che specifica i dettagli del carattere utilizzato (in | + | ;<tt>FontDescriptor (struct)</tt>:Struttura che specifica i dettagli del carattere utilizzato (in conformità alla struttura <idl>com.sun.star.awt.FontDescriptor</idl>) |
− | conformità alla struttura <idl>com.sun.star.awt.FontDescriptor</idl>) | + | |
;<tt>LineCount (Short)</tt>:Numero di righe nell'elemento di controllo | ;<tt>LineCount (Short)</tt>:Numero di righe nell'elemento di controllo | ||
;<tt>MultiSelection (Boolean)</tt>:Consente la selezione multipla delle voci | ;<tt>MultiSelection (Boolean)</tt>:Consente la selezione multipla delle voci | ||
Line 159: | Line 158: | ||
;<tt>HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente | ;<tt>HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente | ||
− | {{ | + | {{Note|Attraverso la proprietà <tt>ValueItemList</tt>, i formulari con caselle di riepilogo forniscono una controparte alla proprietà <tt>ItemData</tt> di VBA attraverso la quale gestire informazioni aggiuntive per le singole voci dell'elenco.}} |
Inoltre, tramite l'oggetto vista della casella di | Inoltre, tramite l'oggetto vista della casella di | ||
Line 168: | Line 167: | ||
;<tt>removeItems (Pos, Count)</tt>:Rimuove le voci <tt>Count</tt> dalla posizione <tt>Pos</tt> | ;<tt>removeItems (Pos, Count)</tt>:Rimuove le voci <tt>Count</tt> dalla posizione <tt>Pos</tt> | ||
;<tt>selectItem (Item, SelectMode)</tt>:Attiva o disattiva l'evidenziazione dell'elemento specificato nella stringa <tt>Item</tt> in base alla variabile <tt>SelectMode</tt> | ;<tt>selectItem (Item, SelectMode)</tt>:Attiva o disattiva l'evidenziazione dell'elemento specificato nella stringa <tt>Item</tt> in base alla variabile <tt>SelectMode</tt> | ||
− | ;<tt>makeVisible (Pos)</tt>:Scorre il campo in modo che la voce specificata con <tt>Pos</tt> sia | + | ;<tt>makeVisible (Pos)</tt>:Scorre il campo in modo che la voce specificata con <tt>Pos</tt> sia visibile |
− | visibile | + | |
{{PDL1}} | {{PDL1}} | ||
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Control Element Forms}} | {{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Control Element Forms}} |
Latest revision as of 07:10, 7 July 2018
- Uso dei formulari
- Elementi di controllo dei formulari
- Formulari basati su database
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.
Contents
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. Apache OpenOffice combina gli elementi di controllo raggruppati in una matrice, in modo che i singoli pulsanti di un programma in Apache OpenOffice 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
Caselle di riepilogo
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
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). |