LameGrid

Le framework fournit déjà un composant de grille puissant qui, s'il est orienté base de données, peut parfaitement être utilisé pour présenter et manipuler des données internes. Toutefois l'affichage rapide de quelques données avec un mimimun de présentation ( couleurs, police ) n'est pas simple et demande un investissement en temps non négligeable.

En Win32, Microsoft fournissait l'activeX Flexgrid qui permettait de satisfaire à la plupart des demandes de manière assez intuitive (un coup d'œil à la doc suffisait). Il est toujours possible d'utiliser cet activeX dans vos programmes, mais on perd du coup l'intérêt du .net.

LameGrid a pour ambition de combler ce « vide » et venir en remplacement de la FlexGrid.

Le cahier des charges principal de LameGrid est la simplicité d'utilisation, un maximum de choses paramétrables au niveau de l'IDE, des propriétés et méthodes simples. Le but étant que le contrôle soit aussi simple d'utilisation qu'une ListBox ou autre composant de base.

Propriétés réglables depuis l'IDE et modifiables dynamiquement depuis le code :

Propriétés uniquement modifiables dynamiquement depuis le code :

Méthodes de la grille :

Événements de la grille :

Par défaut, LameGrid considère chaque cellule en type String. Cette méthode a l'avantage d'être simple d'emploi et tout à fait satisfaisante dans la plupart des cas. Néanmoins pouvoir spécifier un type à l'ensemble d'une colonne présente plusieurs avantages :

- maîtriser la cohérence des données saisies par l'utilisateur ;
- effectuer un tri conforme (pour les dates en particulier) ;
- rapidité du remplissage pour les types autres que String avec la nouvelle propriété DirectValue (voir plus bas) ;
- réduction de l'occupation mémoire (pour les types numériques notamment).

Pour affecter un type à une colonne, j'ai ajouté la propriété ValueType à la propriété Col.

Grille.Col(0).ValueType = LameGrid.ColValueType.Date

Grille.get_Col(1).ValueType = LameGrid.ColValueType.Numeric;

Une fois la colonne affectée à un type vous avez deux solutions pour accéder au contenu d'une cellule :

- la propriété Text comme précédemment : la valeur String sera transformée dans le type adéquat ;
- la propriété DirectValue : dans ce cas on manipule directement la valeur dans le type de la colonne de destination.

Grille(i, 0).DirectValue = Date.Now

Grille[i, 1].DirectValue = Convert.ToDouble(i);

Un des intérêts de LameGrid est la facilité avec laquelle on manipule l'apparence d'une cellule (couleur, police, alignement …).

Grille[i, c].BackColor = Color.FromArgb(255, 0, 0);
Grille[i, c].ForeColor = Color.FromArgb(0, 0, 255 );
Grille[i, c].Font = new Font("Arial", 10, FontStyle.Bold);
Grille[i, c].StringFormat = Grille.get_CellFormatType(StringAlignment.Center, StringAlignment.Center);

Toutefois, traiter plusieurs cellules de manière identique, oblige à répéter pour chaque cellule le code de formatage.

J'ai ajouté la notion de style pour deux raisons :

1) Changer l'apparence d'une cellule en une opération

Dim Style As LameGrid.Grid.CellStyle
    
For i As Integer = 1 To Grille.RowsCount - 1
    For c As Integer = 0 To 2
        Rvb = (i And 1) * 255
        Style = New LameGrid.Grid.CellStyle
        Style.BackColor = Color.FromArgb(Rvb, 0, 0)
        Style.ForeColor = Color.FromArgb(0, 0, 255 - Rvb)
        Style.Font = New Font("Arial", 10, FontStyle.Bold)
        Style.StringFormat = Grille.CellFormatType(StringAlignment.Center, StringAlignment.Center)
        Grille(i, c).SetStyle(Style)
    Next
Next

   Le look de la cellule est modifié en un coup.

2) Partager un style entre plusieurs cellules

Dim Style1 As New LameGrid.Grid.CellStyle

Style1.BackColor = Color.FromArgb(0, 0, 0)
Style1.ForeColor = Color.FromArgb(0, 0, 255)
Style1.Font = New Font("Arial", 10, FontStyle.Bold)
Style1.StringFormat = Grille.CellFormatType(StringAlignment.Center, StringAlignment.Center)

For i As Integer = 1 To Grille.RowsCount - 1
    For c As Integer = 0 To 2
        Grille(i, c).SetStyle(Style1)
    Next
Next

Dans ce cas un seul style est utilisé pour un ensemble de cellules :

- gain de vitesse important ;
- gain en mémoire très important (les x cellules vont pointer sur le même style partagé) ;
- la modification du style affecte automatiquement l'ensemble des cellules le partageant.

J'ai ajouté la possibilité d'afficher une image dans une cellule. Cette opération se fait grâce à la propriété image d'un style.

Style1.Image = Image.FromFile("d:/temp/Recette.gif");

L'alignement de l'image se fait avec la propriété ImageAlignment.

Style1.ImageAlignment = LameGrid.ImageAlignmentType.Left

Le contrôle est achevé par rapport à mes objectifs et besoins initiaux. Je ne pense pas le faire évoluer en dehors de la correction de bug.

Je suis ouvert à toutes propositions et critiques constructives :

LameGrid est distribué en Freeware. Vous pouvez donc l'utiliser à votre guise pour vos programmes, j'essaierai d'être réactif pour la correction des bugs éventuels.

Si vous trouvez ce contrôle utile et si le mécénat vous tente, vous pouvez m'envoyer un chèque cadeau de chez Amazon.fr ou LDLC du montant qu'il vous plaira.

Je tiens à remercier Gelati qui m'a fait le gros du débogage du contrôle sous Delphi 2005. Je remercie également Morpheus et l'équipe de Developpez.com qui m'ont gentiment proposé de m'héberger, ainsi que Ditch pour les corrections.