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

@@ Riga 17: / Riga 17: @@
 ==== Proprietà ====
-===== Action =====
- Property Action As String
 ===== AlwaysEditable =====
@@ Riga 28: / Riga 26: @@
 ===== 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
-===== Background =====
+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.
- Property Background As Integer
-===== Border =====
- Property Border As Integer
 ===== Busy =====
   Property Busy As Boolean
-===== Children =====
+Questa proprietà serve a impostare la griglia in una fase di attesa. Ritorna utile quando la query da caricare è molto pesante.
- Property Read Children As .ContainerChildren
-===== ClientH =====
- Property Read ClientH As Integer
-===== ClientHeight =====
- Property Read ClientHeight As Integer
-===== ClientW =====
- Property Read ClientW As Integer
-===== ClientWidth =====
- Property Read ClientWidth As Integer
-===== ClientX =====
+Un esempio di utilizzo potrebbe essere questo:
-  Property Read ClientX As Integer
+  Public Sub Caricodati()
-===== ClientY =====
+   With Me.GridBox1
-  Property Read ClientY As Integer
+     .Busy = True
+     .LoadData(<Query>)
+     .Busy = False
+   End With
+  End
 ===== Color =====
@@ Riga 67: / Riga 55: @@
 ===== 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 =====
@@ Riga 77: / Riga 69: @@
   Property Connection As Connection
-===== Cursor =====
+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.
- Property Cursor As Cursor
 ===== DataMining =====
   Property DataMining As Boolean
-===== Design =====
+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.
- Property Design As Boolean
-===== Drop =====
- Property Drop As Boolean
 ===== Enabled =====
   Property Enabled As Boolean
+Abilita o disabilita la GridBox.
 ===== Expand =====
@@ Riga 100: / Riga 89: @@
 ===== FieldReordering =====
   Property FieldReordering As String
-===== Font =====
- Property Font As Font
-===== Foreground =====
- Property Foreground As Integer
 ===== GridOnly =====
   Property GridOnly As Boolean
-===== H =====
- Property H As Integer
-===== Handle =====
- Property Read Handle As Integer
-===== HasFocus =====
- Property Read HasFocus As Boolean
 ===== Header =====
   Property Header As Integer
-===== Height =====
- Property Height As Integer
-===== Hovered =====
- Property Read Hovered As Boolean
-===== Id =====
- Property Read Id As Integer
-===== Ignore =====
- Property Ignore As Boolean
 ===== KeyActivity =====
@@ Riga 139: / Riga 101: @@
 ===== KeyGrid =====
   Property Read KeyGrid As KeyGrid (Virtual class)
-===== Left =====
- Property Left As Integer
-===== Mouse =====
- Property Mouse As Integer
-===== Name =====
- Property Name As String
-===== Next =====
- Property Next As Control
-===== Parent =====
- Property Read Parent As Container
-===== PicCheck =====
- Property PicCheck As Picture
-===== PicUncheck =====
- Property PicUncheck As Picture
-===== PopupMenu =====
- Property PopupMenu As String
-===== Previous =====
- Property Previous As Control
 ===== Query =====
@@ Riga 185: / Riga 120: @@
   Property Read Rows As Rows (Virtual class)
-===== ScreenX =====
- Property Read ScreenX As Integer
-===== ScreenY =====
- Property Read ScreenY As Integer
-===== ScrollBar =====
- Property ScrollBar As Integer
-===== ScrollX =====
- Property ScrollX As Integer
-===== ScrollY =====
- Property ScrollY As Integer
 ===== Table =====
@@ Riga 206: / Riga 127: @@
   Property TableName As String
-===== Tag =====
- Property Tag As Variant
 ===== TmpConnection =====
   Property Read TmpConnection As Connection
-===== Tooltip =====
- Property Tooltip As String
-===== Top =====
- Property Top As Integer
-===== Tracking =====
- Property Tracking As Boolean
 ===== UpdateReording =====
   Property UpdateReording As Boolean
-===== Visible =====
+===== Proprietà native dell'oggetto GridView =====
- Property Visible As Boolean
+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
-===== W =====
- Property W As Integer
-===== Width =====
- Property Width As Integer
-===== Window =====
- Property Read Window As Window
-===== X =====
- Property X As Integer
-===== Y =====
- Property Y As Integer
 ==== Metodi ====

Differenze tra le versioni di "GridBox"