TableGrid

Description

Le composant est utilisé pour extraire les enregistrements de la base de données sous forme de tableau.

Class: TdbStringGridEx

Propriétés

Propriété	Type	Description
dbCustomOrderBy	String	Permet de spécifier le tri. Par exemple, vous pouvez spécifier le tri sur deux champs de la table en même temps, exemple : nomtable.nom_champ1, nomtable.nom_champ2 ou nomtable.nom_champ1 ASC, nomtable.nom_champ2 DESC
dbFilter	String	Permet de définir un filtre supplémentaire qui sera utilisé pour remplir le composant avec les données de la base de données. Exemple : tablename.fieldname = 1
dbGeneralTable	String	Contient le nom de la table de la base de données principale ; c'est à partir de cette table que vous obtenez l'identifiant (id de champ de base de données) de l'enregistrement sélectionné à l'aide de la propriété dbItemID ou sqlValue. La propriété peut également contenir une clé externe, par exemple, lorsqu'un composant est utilisé pour une recherche.
dbGetSqlStatement	String	La propriété permet d'obtenir la dernière requête SQL utilisée pour remplir le composant avec les données de la base de données.
dbIncremSearch	String	Permet de spécifier le nom du bouton sur le formulaire courant avec l'action "Rechercher" ou "Requête SQL", qui sera automatiquement enfoncée lorsque l'utilisateur change la valeur du composant. La propriété est nécessaire pour implémenter la recherche instantanée.
dbItemID	Integer	L'identifiant de l'enregistrement sélectionné dans le composant. L'identifiant correspond au champ id dans la base de données.
dbLimit	Integer	Permet de définir le nombre maximum d'enregistrements qui seront remplis dans un composant. Plus d'infos.
dbListFieldsNames	String	Contient les noms des en-tête pour les colonnes séparées par des virgules.
dbOffSet	Integer	Permet de définir un décalage lors de la récupération des enregistrements de la base de données. Plus d'infos.
dbParentTable	String	Contient le nom de la table de la base de données parent lorsque le composant affiche les enregistrements enfants (option : Afficher les enregistrements enfants).
dbParentTableId	Integer	Contient l'identifiant (champ id) de l'enregistrement parent dans la table parent (dbParentTable) lorsque le composant affiche les enregistrements enfants (option: Afficher les enregistrements enfants).
dbPopupMenu	TPopupMenu	Donne accès au menu contextuel du composant. Plus d'infos.
dbSortAsc	Boolean	Si True, les enregistrements seront triés par ordre croissant, sinon par ordre décroissant. La valeur de la propriété sera ignorée si un tri différent est spécifié dans la propriété dbCustomOrderBy.
dbSortField	String	Le champ de base de données par lequel les enregistrements du composant seront triés. La valeur de la propriété sera ignorée si un tri différent est spécifié dans la propriété dbCustomOrderBy.
dbSQL	String	Contient une requête SQL si le composant a été rempli avec des données à l'aide du bouton avec l'action "Requête SQL". Permet également de définir votre propre requête SQL qui sera exécutée lors de l'appel de la méthode dbSQLExecute. Plus d'infos.
sqlValue	String	Renvoie l'ID de l'enregistrement sélectionné dans le composant à utiliser dans les requêtes SQL. En cas de valeur vide, il renvoie une chaîne NULL Exemple :: SQLExecute ('INSERT INTO tablename (fieldname) VALUES ('+Form1.TableGrid1.sqlValue+')');
AllowCreate	Boolean	Permet de créer de nouveaux enregistrements directement dans le composant.
AllowCreateEmpty	Boolean	Permet de créer de nouveaux enregistrements vides.
AllowEdit	Boolean	Permet d'éditer les enregistrements directement dans le composant.
AllowDelete	Boolean	Permet de supprimer des enregistrements directement dans le composant.
SecondClickEdit	Boolean	Détermine si vous devez ou non double-cliquer sur une cellule pour modifier un enregistrement.
BorderStyle	TBorderStyle	Détermine si le composant a une bordure. Valeurs disponibles : bsSingle, bsNone
CanFocus	Boolean	Vérifie si le composant peut obtenir le focus, ce qui est généralement nécessaire avant d'utiliser la méthode SetFocus. Si un composant a la propriété Visible = False ou Enabled = False, ou si le composant est situé sur un composant parent avec ces propriétés, l'utilisation de la méthode SetFocus provoquera une erreur. Exemple : if Form1.TableGrid1.CanFocus then Form1.TableGrid1.SetFocus;
Canvas	TCanvas	Une classe qui permet de dessiner sur un composant. Plus d'infos.
Cell[x,y]	TCell	Permet d'accéder aux propriétés supplémentaires de la cellule de composant spécifiée (colonne x, ligne y). Plus d'infos.
Cells[x,y]	String	Permet d'accéder au contenu textuel d'une cellule (x - colonne, y - ligne).
ClientWidth	Integer	La largeur de la partie cliente du composant (c'est-à-dire sans les bordures).
ClientHeight	Integer	La hauteur de la partie cliente du composant (c'est-à-dire à l'exclusion des bordures).
Color	TColor	La couleur d'arrière-plan du composant. Plus d'infos..
Columns	TNxColumns	Permet d'accéder aux propriétés et méthodes de colonne supplémentaires. Plus d'infos..
Columns[i]	TNxCustomColumn	Permet d'accéder aux propriétés d'une colonne spécifiée. Plus d'infos..
Cursor	TCursor	Spécifie l'image utilisée pour représenter le pointeur de la souris lorsqu'il passe dans la région couverte par le contrôle. Plus d'infos.
Enabled	Boolean	Contrôle si le composant répond aux événements de la souris, du clavier et du minuteur.
FixedCols	Integer	Définit le nombre de colonnes fixes qui ne bougeront pas lors du défilement horizontal.
Focused	Boolean	Détermine si le contrôle a le focus.
Font	TFont	Permet de définir le nom, la taille, la couleur et le style de la police. Plus d'infos.
HeaderSize	Integer	Obtient ou définit la taille des en-têtes de colonnes.
Hint	String	Hint (astuce) contient la chaîne de texte qui apparaît lorsque l'utilisateur déplace la souris sur le composant., Voir aussi ShowHint
HorzScrollBar	TNxScrollBar	Permet d'accéder aux propriétés et méthodes supplémentaires de la barre de défilement. Plus d'infos..
LastAddedRow	Integer	Renvoie l'index de la dernière ligne ajoutée. Lecture seule.
Name	String	Le nom du composant.
Options	TGridOptions	Paramètres supplémentaires du composant. Plus d'infos.
Parent	TWinControl	Le composant parent sur lequel ce composant est placé.
RowCount	Integer	Retourne le nombre total de lignes.
RowSize	Integer	Obtient ou définit la taille par défaut (hauteur) des lignes dans la grille.
Row[i]	TRow	Accès aux propriétés supplémentaires d'une ligne par son index. Plus d'infos.
RowVisible[i]	Boolean	Détermine la visibilité de la ligne par son index.
Selected[i]	Boolean	Retourne ou définit l'état sélectionné de la ligne spécifiée.
SelectedRow	Integer	Retourne ou définit l'index de la ligne sélectionnée.
SelectedColumn	Integer	Retourne ou définit l'index de la colonne sélectionnée
SelectedCount	Integer	Retourne le nombre de lignes sélectionnées.
ShowHint	Boolean	Ssécifie s'il faut afficher l'indicateur d'aide lorsque le pointeur de la souris se déplace sur le composant, voir aussi Hint.
SlideSize	Integer	Retourne ou définit la taille (hauteur) d'une seule diapositive. A du sens lorsque la propriété du composant GridStyles = gsSlides. En savoir plus sur le mode gsSlides.
SortedColumn	TNxCustomColumn	Référence à la colonne triée.
TabOrder	Integer	Indique la position du composant dans l'ordre de tabulation de son parent. TabOrder est l'ordre dans lequel les composants enfants sont visités lorsque l'utilisateur appuie sur la touche Tab.
TabStop	Boolean	Détermine si l'utilisateur peut accéder à un contrôle. Utilisez TabStop pour autoriser ou interdire l'accès au contrôle à l'aide de la touche Tab.
Tag	Integer	Permet d'attribuer un numéro à un composant pour vos propres besoins.
TagString	String	Permet d'attribuer une chaîne à un composant pour vos propres besoins.
VertScrollBar	TNxScrollBar	Permet d'accéder aux propriétés et méthodes supplémentaires de la barre de défilement. Plus d'infos..
Visible	Boolean	Spécifie si le composant apparaît à l'écran.v
VisibleRows	Integer	Obtient le nombre de lignes visibles.
Left	Integer	Spécifie le coordonnée horizontal du bord gauche d'un composant par rapport à son parent.
Top	Integer	Spécifie le coordonnée vertical de la partie supérieure gauche d'un composant par rapport à son parent.
Width	Integer	Spécifie la taille horizontale du composant en pixels.
Height	Integer	Spécifie la taille verticale du composant en pixels.

Méthodes

Méthode	Description
function dbIndexToID (index: Integer): integer	Permet d'obtenir l'ID d'enregistrement (ID de champ de base de données) en spécifiant le numéro de ligne.
function dbUpdate: String	Force la mise à jour de force des données du composant. En règle générale, le composant met à jour automatiquement les données si les données ont été modifiées. Il renvoie également la requête SQL qui a été utilisée pour accéder à la base de données.
function AddRow (Count: Integer = 1): Integer	Ajoute le nombre de lignes spécifié au composant. Renvoie l'index de la dernière ligne ajoutée. Les données ne sont pas ajoutées à la base de données.
procedure BeginUpdate	Appelé avant d'effectuer un grand nombre d'opérations sur un composant pour augmenter les performances. La méthode EndUpdate doit être appelée à la fin.
procedure BestFitColumns (BestFitMode: TBestFitMode = bfCells)	La méthode ajuste automatiquement la largeur des colonnes. Plus d'infos.
procedure BestFitRow (const Index: Integer)	La méthode ajuste automatiquement la hauteur de la ligne, en fonction du contenu des cellules de la ligne donnée. Plus d'infos.
procedure CalculateFooter (VisibleOnly: Boolean = False)	Calcule le pied de page du composant.
procedure ClearRows	Efface les lignes du composant.
procedure DeleteRow (Index: Integer)	Supprime une ligne spécifique. L'enregistrement de la base de données ne sera pas supprimé.
function ExportToExcel (FileName: string = ''; ExcelVisible: boolean = True; FirsRowColumns: boolean = True): Variant	Exporte les données du composant vers Excel. Renvoie également un objet OLE Excel, pour travailler avec les données ultérieurement.
function ExportToLibreCalc (FirsRowColumns: boolean = True): Boolean	Exporte les données du composant vers OpenOffice (LibreOffice).
procedure EndUpdate	Voir BeginUpdate
function GetRowAtPos (X, Y: Integer): Integer	Permet d'obtenir l'index des lignes par coordonnées.
function GetColumnAtPos (X, Y: Integer): TNxCustomColumn	Permet d'obtenir un lien vers une colonne par coordonnées.
procedure InsertRow (Pos: Integer; Count: Integer = 1)	Insère une seule ligne à la position spécifiée. Cela n'ajoutera pas d'enregistrement à la base de données.
procedure MoveRow (FromPos, ToPos: Integer)	Déplace la ligne de la position spécifiée vers une autre. Dans ce cas, aucune modification n'est apportée à la base de données.
procedure SaveToTextFile (const FileName: String; Separator: Char = ','; MultiLineSeparator: Char = '\|')	Enregistre le contenu du composant dans un fichier texte. Le codage de fichier utilisé est Unicode (UCS-2 Little Endian).
procedure SaveToHtml (FileName: String; SaveHeaders: boolean = True; AllRows: boolean = False; CreateStyleSheet: boolean = True; SaveFooter: boolean = False; SaveCaption: boolean = False)	Enregistre le contenu du composant dans un fichier HTML.
procedure LoadFromTextFile (const FileName: String; Separator: Char = ','; MultiLineSeparator: Char = '\|'; StartRow: Integer = 0)	Charge les données du fichier texte dans le composant. Les données n'entreront pas dans la base de données. L'encodage du fichier chargé doit être Unicode (UCS-2 Little Endian)
procedure ScrollToRow (index: integer)	Déplace le défilement dans le composant afin que la ligne spécifiée soit visible.
procedure SelectAll	Sélectionne toutes les lignes du composant. Pour que la méthode fonctionne, la propriété Options doit avoir les valeurs goMultiSelect et goSelectFullRow.
procedure SelectRange (FromRow, ToRow: Integer; Value: Boolean)	Sélectionne (ou désélectionne, si Valeur = False) la plage de lignes spécifiée.
procedure SetFocus	Donne le focus au composant.
procedure SwapRows (FromPos, ToPos: Integer)	Permute les positions de deux lignes.

Evènements

Evènement	Description
OnApplyEditText (Sender: TObject; ACol, ARow: Integer; var Value: String)	Se produit lorsque vous avez terminé de modifier une cellule. Vous permet de modifier la valeur saisie. Plus d'infos.
OnAfterEdit (Sender: TObject; ACol, ARow: Integer; Value: String)	Se produit lorsque la modification de la cellule est terminée avec succès. Plus d'infos.
OnAfterRowMove (Sender: TObject; FromPos, ToPos: Integer)	Se produit lorsque l'utilisateur a correctement déplacé la ligne vers une nouvelle position.
OnAfterSort (Sender: TObject; ACol: Integer)	Se produit après le tri de la colonne.
OnBeforeEdit (Sender: TObject; ACol, ARow: Integer; var Accept: Boolean)	Se produit avant que la cellule n'entre en mode d'édition. Vous permet de désactiver l'édition. Plus d'infos.
OnCellClick (Sender: TObject; ACol, ARow: Integer)	Se produit lorsque l'utilisateur clique sur une cellule. Plus d'infos.
OnCellDoubleClick (Sender: TObject; ACol, ARow: Integer)	Se produit lorsque l'utilisateur double-clique sur une cellule.
OnChange (Sender: TObject)	Se produit après que le composant a été rempli avec les données de la base de données.
OnClick (Sender: TObject)	Se produit lorsque l'utilisateur clique sur le composant.
OnColumnResize (Sender: TObject; ACol: Integer)	Se produit lorsque l'utilisateur redimensionne la colonne.
OnDoubleClick (Sender: TObject)	Se produit quand l'utilisateur double-clique sur le bouton gauche de la souris lorsque le pointeur se trouve sur le composant.
OnEditAccept (Sender: TObject; ACol, ARow: Integer; Value: String; var Accept: Boolean)	Se produit lorsque l'utilisateur a terminé de modifier une cellule, par exemple en sélectionnant une autre cellule ou en appuyant sur Entrée. Permet de rejeter la valeur saisie. Plus d'infos.
OnEnter (Sender: TObject)	Se produit lorsqu'un composant reçoit le focus.
OnExit (Sender: TObject)	Se produit lorsque le focus d'entrée se déplace d'un composant à un autre.
OnFooterClick (Sender: TObject; ACol: Integer)	Se produit lorsque l'utilisateur clique sur l'en-pied de page.
OnHeaderClick (Sender: TObject; ACol: Integer)	Se produit lorsque l'utilisateur clique sur un en-tête de colonne.
OnHeaderDoubleClick (Sender: TObject; ACol: Integer)	Se produit lorsque l'utilisateur double-clique sur un en-tête de colonne.
OnInputAccept (Sender: TObject; var Accept: Boolean)	Se produit avant l'ajout d'un nouvel enregistrement à partir de la ligne d'entrée. Permet d'annuler la création d'un nouvel enregistrement. Plus d'nfos.
OnInputSelectCell (Sender: TObject; ACol: Integer)	Se produit lorsque l'utilisateur s'est déplacé vers le champ de saisie.
OnKeyDown (Sender: TObject; var Key: Word; Shift, Alt, Ctrl: boolean)	Se produit lorsqu'un utilisateur appuie sur une touche alors que le formulaire a le focus.
OnKeyPress (Sender: TObject; var Key: Char)	Se produit lorsqu'une touche est enfoncée. Notez que cette procédure ne gère que les caractères imprimables.
OnKeyUp (Sender: TObject; var Key: Word; Shift, Alt, Ctrl: boolean)	Se produit lorsque l'utilisateur relâche une touche qui a été enfoncée.
OnLoadProgress (Sender: TObject; ACol, ARow: Integer)	Se produit lorsqu'un fichier texte est chargé dans un composant à l'aide de la méthode LoadFromTextFile
OnMouseDown (Sender: TObject; MouseLeft, MouseRight, MouseMiddle: boolean; Shift, Alt, Ctrl: boolean; X, Y: Integer)	Se produit lorsque l'utilisateur appuie sur un bouton de la souris avec le pointeur sur un composant.
OnMouseEnter (Sender: TObject)	Se produit lorsque l'utilisateur déplace la souris dans un composant.
OnMouseLeave (Sender: TObject)	Se produit lorsque l'utilisateur déplace la souris en dehors d'un composant.
OnMouseMove (Sender: TObject; Shift, Alt, Ctrl: boolean; X, Y: Integer)	Se produit lorsque l'utilisateur déplace le pointeur de la souris alors que le pointeur se trouve sur un composant.
OnMouseUp (Sender: TObject; MouseLeft, MouseRight, MouseMiddle: boolean; Shift, Alt, Ctrl: boolean; X, Y: Integer)	Se produit lorsque l'utilisateur relâche un bouton de la souris qui a été enfoncé avec le pointeur sur un composant.
OnResize (Sender: TObject)	Se produit lorsqu'un composant est redimensionné.
OnRowMove (Sender: TObject; FromPos, ToPos: Integer; var Accept: Boolean)	Se produit lorsque l'utilisateur a déplacé une ligne vers une nouvelle position. Permet d'annuler le déplacement. Plus d'infos.
OnSortColumn (Sender: TObject; ACol: Integer; Ascending: Boolean)	Se produit avant le tri de la colonne.
OnDropFiles (Sender: TObject; ArrayOfFiles: array of string; X, Y: Integer)	Se produit lorsque l'utilisateur essaie de faire glisser et déposer un fichier de l'explorateur vers un formulaire. Plus d'infos.