Differenze tra le versioni di "GridBox"

Da Gambas-it.org - Wikipedia.
 
m (Ha protetto "GridBox" [edit=autoconfirmed:move=autoconfirmed])
 
(27 versioni intermedie di 6 utenti non mostrate)
Riga 1: Riga 1:
 +
= Introduzione =
  
−
*[[Introduzione]]
+
Una GridBox è un componente non ufficiale ma molto valido per chi lavora spesso con i database. Questo componente, tutto made in Gambas-it.org grazie all'ottimo lavoro dell'utente Milio, permette di creare semplicemente una griglia collegata a un database, con pochissime righe di codice, e già pronta con comandi quali: salvataggio, inserimento, eliminazione, modifica.
 +
 
 +
Una caratteristica interessante di questo componente è la possibilità di mantenere l'integrità dei dati, con l'aiuto di oggetti quali TextBox, ComboBox, CheckBox, ValueBox, ecc, per una corretta modifica/inserimento di record nel DataBase.
 +
Altre caratteristiche sono la formattazione dei dati, mantenendo l'integrità del loro valore, formattazioni condizionate in stile foglio di calcolo, colonne di tipo Formula per facilitare calcoli su i vari record, e altro ancora.
 +
 
 +
== Le Classi esportabili ==
 +
 
 +
In questo componente abbiamo i seguenti oggetti che si possono utilizzare:
 +
*GridBox
 +
*Grid
 +
*Conditional
 +
*Cell
 +
 
 +
== Simboli dell'oggetto GridBox ==
 +
 
 +
==== Proprietà ====
 +
 
 +
===== AlwaysEditable =====
 +
Property AlwaysEditable As Boolean
 +
 
 +
Imposta la griglia in modo che le celle siano sempre editabili.
 +
Usando il Tab o le frecce, il focus verrà spostato solo sulle celle che hanno la proprietà ReadOnly impostata a False.
 +
 
 +
===== AutoDataType =====
 +
Property AutoDataType As Boolean
 +
 
 +
Imposta in automatico la proprietà DataType delle colonne di tipo Field in base al tipo di dato passatogli dal metodo LoadData.
 +
 
 +
===== AutoNew =====
 +
Property AutoNew As Boolean
 +
 
 +
Questa proprietà, legata alla proprietà AlwaysEditable, fa in modo che, spostandosi dall'ultima cella editabile dell'ultima riga della griglia, crei in automatico una nuova riga per l'inserimento di un nuovo record.
 +
 
 +
===== Busy =====
 +
Property Busy As Boolean
 +
 
 +
Questa proprietà serve a impostare la griglia in una fase di attesa. Ritorna utile quando la query da caricare è molto pesante.
 +
 
 +
Un esempio di utilizzo potrebbe essere questo:
 +
Public Sub Caricodati()
 +
 
 +
  With Me.GridBox1
 +
    .Busy = True
 +
    .LoadData(<Query>)
 +
    .Busy = False
 +
  End With
 +
 +
End
 +
 
 +
===== Color =====
 +
Property Read Color As Color (Virtual class)
 +
 
 +
===== ColorRowAlternating =====
 +
Property ColorRowAlternating As Boolean
 +
 
 +
Colora le righe di due colori alternati per facilitare la lettura dei dati.
 +
 
 +
===== Column =====
 +
Property Column As Integer
 +
 
 +
Ritorna il numero di colonna che detiene il focus in quel momento. Se non ci sono colonne selezionate ritorna -1.
 +
 
 +
===== Columns =====
 +
Property Read Columns As Columns (Virtual class)
 +
 
 +
===== Connection =====
 +
Property Connection As Connection
 +
 
 +
Setta la Connection dove eseguirà le varie query passatele con il metodo LoadData. Se la proprietà DataMining è settata a True, il valore di Connection verrà ignorato.
 +
 
 +
===== DataMining =====
 +
Property DataMining As Boolean
 +
 
 +
Questa Proprietà abilita la ricerca su più DataBase, anche di diversa natura. In pratica con il metodo LoadTmpData si passano le varie query che andranno a creare le varie tabelle in un DataBase Sqlite temporaneo, in modo da poter aggregare tutti i dati provenienti da DataBase diversi in un unico DataBase. Dopodiché con il metodo LoadData si recuperano le informazioni desiderate.
 +
 
 +
===== Enabled =====
 +
Property Enabled As Boolean
 +
 
 +
Abilita o disabilita la GridBox.
 +
 
 +
===== Expand =====
 +
Property Expand As Boolean
 +
 
 +
===== FieldKey =====
 +
Property FieldKey As String[]
 +
 
 +
===== FieldReordering =====
 +
Property FieldReordering As String
 +
 
 +
===== GridOnly =====
 +
Property GridOnly As Boolean
 +
 
 +
===== Header =====
 +
Property Header As Integer
 +
 
 +
===== KeyActivity =====
 +
Property KeyActivity As Boolean
 +
 
 +
===== KeyGrid =====
 +
Property Read KeyGrid As KeyGrid (Virtual class)
 +
 
 +
===== Query =====
 +
Property Read Query As String[]
 +
 
 +
===== ReadData =====
 +
Property Read ReadData As Result
 +
 
 +
===== ReadOnly =====
 +
Property ReadOnly As Boolean
 +
 
 +
===== Row =====
 +
Property Row As Integer
 +
 
 +
===== RowSelected =====
 +
Property RowSelected As Integer[]
 +
 
 +
===== Rows =====
 +
Property Read Rows As Rows (Virtual class)
 +
 
 +
 
 +
===== Table =====
 +
Property Read Table As Table
 +
 
 +
===== TableName =====
 +
Property TableName As String
 +
 
 +
 
 +
===== TmpConnection =====
 +
Property Read TmpConnection As Connection
 +
 
 +
 
 +
===== UpdateReording =====
 +
Property UpdateReording As Boolean
 +
 
 +
===== Proprietà native dell'oggetto GridView =====
 +
Action - Background - Border - Children - ClientH - ClientHeight - ClientW - ClientWidth - ClientX - ClientY - Cursor - Design - Drop - Font - Foreground - H - Handle - HasFocus - Height - Hovered - Id - Ignore - Left - Mouse - Name - Next - Parent - PopupMenu - Previous - ScreenX - ScreenY - ScrollBar - ScrollX - ScrollY - Tag - Tooltip - Top - Tracking - Visible - W - Width - Window - X - Y
 +
 
 +
==== Metodi ====
 +
==== Eventi ====
 +
 
 +
== Link utili ==
 
*[[Installazione]]
 
*[[Installazione]]
 
*[[Guida a Gridbox]]
 
*[[Guida a Gridbox]]

Versione attuale delle 01:09, 28 ott 2011

Introduzione

Una GridBox è un componente non ufficiale ma molto valido per chi lavora spesso con i database. Questo componente, tutto made in Gambas-it.org grazie all'ottimo lavoro dell'utente Milio, permette di creare semplicemente una griglia collegata a un database, con pochissime righe di codice, e già pronta con comandi quali: salvataggio, inserimento, eliminazione, modifica.

Una caratteristica interessante di questo componente è la possibilità di mantenere l'integrità dei dati, con l'aiuto di oggetti quali TextBox, ComboBox, CheckBox, ValueBox, ecc, per una corretta modifica/inserimento di record nel DataBase. Altre caratteristiche sono la formattazione dei dati, mantenendo l'integrità del loro valore, formattazioni condizionate in stile foglio di calcolo, colonne di tipo Formula per facilitare calcoli su i vari record, e altro ancora.

Le Classi esportabili

In questo componente abbiamo i seguenti oggetti che si possono utilizzare:

  • GridBox
  • Grid
  • Conditional
  • Cell

Simboli dell'oggetto GridBox

Proprietà

AlwaysEditable
Property AlwaysEditable As Boolean

Imposta la griglia in modo che le celle siano sempre editabili. Usando il Tab o le frecce, il focus verrà spostato solo sulle celle che hanno la proprietà ReadOnly impostata a False.

AutoDataType
Property AutoDataType As Boolean

Imposta in automatico la proprietà DataType delle colonne di tipo Field in base al tipo di dato passatogli dal metodo LoadData.

AutoNew
Property AutoNew As Boolean

Questa proprietà, legata alla proprietà AlwaysEditable, fa in modo che, spostandosi dall'ultima cella editabile dell'ultima riga della griglia, crei in automatico una nuova riga per l'inserimento di un nuovo record.

Busy
Property Busy As Boolean

Questa proprietà serve a impostare la griglia in una fase di attesa. Ritorna utile quando la query da caricare è molto pesante.

Un esempio di utilizzo potrebbe essere questo: 

Public Sub Caricodati()
  
  With Me.GridBox1
    .Busy = True
    .LoadData(<Query>)
    .Busy = False
  End With

End
Color
Property Read Color As Color (Virtual class)
ColorRowAlternating
Property ColorRowAlternating As Boolean

Colora le righe di due colori alternati per facilitare la lettura dei dati.

Column
Property Column As Integer

Ritorna il numero di colonna che detiene il focus in quel momento. Se non ci sono colonne selezionate ritorna -1.

Columns
Property Read Columns As Columns (Virtual class)
Connection
Property Connection As Connection

Setta la Connection dove eseguirà le varie query passatele con il metodo LoadData. Se la proprietà DataMining è settata a True, il valore di Connection verrà ignorato.

DataMining
Property DataMining As Boolean

Questa Proprietà abilita la ricerca su più DataBase, anche di diversa natura. In pratica con il metodo LoadTmpData si passano le varie query che andranno a creare le varie tabelle in un DataBase Sqlite temporaneo, in modo da poter aggregare tutti i dati provenienti da DataBase diversi in un unico DataBase. Dopodiché con il metodo LoadData si recuperano le informazioni desiderate.

Enabled
Property Enabled As Boolean

Abilita o disabilita la GridBox.

Expand
Property Expand As Boolean
FieldKey
Property FieldKey As String[]
FieldReordering
Property FieldReordering As String
GridOnly
Property GridOnly As Boolean
Header
Property Header As Integer
KeyActivity
Property KeyActivity As Boolean
KeyGrid
Property Read KeyGrid As KeyGrid (Virtual class)
Query
Property Read Query As String[]
ReadData
Property Read ReadData As Result
ReadOnly
Property ReadOnly As Boolean
Row
Property Row As Integer
RowSelected
Property RowSelected As Integer[]
Rows
Property Read Rows As Rows (Virtual class)


Table
Property Read Table As Table
TableName
Property TableName As String


TmpConnection
Property Read TmpConnection As Connection


UpdateReording
Property UpdateReording As Boolean
Proprietà native dell'oggetto GridView

Action - Background - Border - Children - ClientH - ClientHeight - ClientW - ClientWidth - ClientX - ClientY - Cursor - Design - Drop - Font - Foreground - H - Handle - HasFocus - Height - Hovered - Id - Ignore - Left - Mouse - Name - Next - Parent - PopupMenu - Previous - ScreenX - ScreenY - ScrollBar - ScrollX - ScrollY - Tag - Tooltip - Top - Tracking - Visible - W - Width - Window - X - Y

Metodi

Eventi

Link utili

Estratto da "https://www.gambas-it.org/wiki/index.php?title=GridBox&oldid=3518"