TreeView
Description
Ce composant est utilisé pour afficher les enregistrements de la base de données sous une forme arborescente.
Class: TdbTreeView
Propriétés
Propriété |
Type |
Description |
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. Par exemple : tablename.fieldname = 1 |
dbForeignKey |
String |
Détermine à quelle clé étrangère de la table appartient ce composant. Vous pouvez éventuellement spécifier le nom de la table. |
dbFieldParentID |
String |
Spécifie le champ qui sera utilisé pour former la structure arborescente. Le champ doit être de type "Integer". |
dbGetSqlStatement |
String |
Permet d'obtenir la dernière requête SQL qui a été 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é 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'entrée sélectionnée dans le composant. L'identifiant correspond au champ id dans la base de données. |
dbListFieldsNames |
String |
Contient les noms d'en-tête des colonnes, séparés par des virgules. |
TPopupMenu |
Permet d'accéder au menu contextuel du composant. Plus d'infos. |
|
sqlValue |
String |
Renvoie l'ID de l'enregistrement sélectionné dans le composant à utiliser dans les requêtes SQL. Si vide, retournera une chaîne NULL Exemple: SQLExecute ('INSERT INTO tablename (fieldname) VALUES (' + Form1.TableGrid1.sqlValue + ')'); |
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.TreeView1.CanFocus then Form1.TreeView1.SetFocus; |
TCanvas |
Une classe qui permet de peindre sur un composant. Plus d'infos. |
|
TCell |
Permet d'accéder aux propriétés supplémentaires de la cellule de composant spécifiée (x - colonne, y - ligne). Plus d'infos. |
|
Cells[x,y] |
String |
Permet d'accéder au contenu texte de la cellule. |
ClientWidth |
Integer |
La largeur du côté client du composant (c'est-à-dire à l'exclusion des bordures). |
ClientHeight |
Integer |
La hauteur du côté client du composant (c'est-à-dire à l'exclusion des bordures). |
TColor |
La couleur d'arrière-plan du composant. Plus de'infos. |
|
TNxColumns |
Permet d'accéder aux propriétés et méthodes supplémentaires des colonnes. Plus d'infos. |
|
TNxCustomColumn |
Permet d'accéder aux propriétés de la colonne spécifiée. Plus d'infos. |
|
TCursor |
Spécifie l'image utilisée pour représenter le pointeur de la souris lorsqu'il passe sur la région couverte par le contrôle. Plus d'infod. |
|
Enabled |
Boolean |
Contrôle si le composant répond aux événements de la souris, du clavier et du minuteur. |
Expanded [Index: Integer] |
Boolean |
La propriété détermine l'état du nœud (développé ou réduit). |
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 reçoit le focus. |
TFont |
Permet de définir le nom, la taille, la couleur et le style de la police. Plus d'info. |
|
HeaderSize |
Integer |
Hauteur des en-têtes. |
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 |
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 |
La propriété renvoie l'index de la dernière ligne ajoutée. Uniquement pour la lecture. |
Name |
String |
Le nom du composant.. |
TGridOptions |
Paramètres de composant supplémentaires. Plus d'infos. |
|
Parent |
TWinControl |
Le composant parent sur lequel se trouve ce composant. |
RowCount |
Integer |
Contient le nombre de lignes du composant. |
RowSize |
Integer |
La hauteur des lignes. |
TRow |
Accès aux propriétés supplémentaires de la chaîne par son index. Plus d'infos. |
|
RowVisible[i] |
Boolean |
Détermine la visibilité d'une ligne par son index. |
Selected[i] |
Boolean |
Sélectionne la chaîne spécifiée. |
SelectedRow |
Integer |
Définit la ligne sélectionnée. |
SelectedColumn |
Integer |
Contient l'index de la colonne sélectionnée. |
SelectedCount |
Integer |
Renvoie le nombre de lignes sélectionnées. |
ShowHint |
Boolean |
Spécifie s'il faut afficher l'indicateur d'aide lorsque le pointeur de la souris se déplace sur le composant, voir aussi Hint. |
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. |
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. |
VisibleRows |
Integer |
Renvoie 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'identifiant d'enregistrement (ID de champ DB) en spécifiant le numéro ordinal de la ligne. |
function dbUpdate: String |
Réactualise de force les données d'un composant. En règle générale, le composant met à jour les données automatiquement si les données ont changé. 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. Dans ce cas, les données ne sont pas ajoutées à la base de données. |
procedure AddChildRow (const Index: Integer; Position: TChildRowPosition) |
Ajoute une branche enfant pour la ligne spécifiée. Dans ce cas, aucune donnée n'est ajoutée à la base de données. Valeurs disponibles pour le paramètre Position: crFirst, crLast |
procedure BeginUpdate |
Appelé avant d'effectuer un grand nombre d'opérations sur un composant pour en améliorer les performances. En fin, vous devez appeler la méthode EndUpdate. |
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 sélectionne 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) |
Force le recalcul des résultats dans l'en-pied de page du composant. |
procedure ClearRows |
Efface le contenu du composant. |
procedure CollapseAll |
Réduit tous les nœuds de l'arborescence. |
procedure DeleteRecord (id: integer) |
Supprime l'entrée avec l'identificateur spécifié, avec tous ses nœuds enfants. |
procedure DeleteRow (Index: Integer) |
Supprime la ligne spécifiée. Dans ce cas, l'enregistrement n'est pas supprimé de la base de données. |
function ExportToExcel (FileName: string = ''; ExcelVisible: boolean = True; FirsRowColumns: boolean = True): Variant |
Exporte les données d'un composant vers Excel. Il renvoie également un objet OLE Excel pour un travail ultérieur avec les données. |
function ExportToLibreCalc (FirsRowColumns: boolean = True): Boolean |
Exporte les données d'un composant vers OpenOffice (LibreOffice). |
procedure EndUpdate |
Voir BeginUpdate |
procedure ExpandNode (Index: Integer) |
Développe le nœud d'arbre spécifié |
procedure ExpandAll |
Développe tous les nœuds de l'arborescence |
function GetRowAtPos (X, Y: Integer): Integer |
Permet d'obtenir l'index d'une ligne par ses coordonnées. |
function GetColumnAtPos (X, Y: Integer): TNxCustomColumn |
Permet d'obtenir un lien vers une colonne par ses oordonnées. |
function GetChildCount (const Index: Integer; Recurse: Boolean = True): Integer |
Renvoie le nombre d'enregistrements enfants pour la ligne spécifiée dans le paramètre Index. |
function GetFirstChild (const Index: Integer): Integer |
Renvoie l'index de la première ligne enfant par rapport à la ligne spécifiée dans le paramètre Index. |
function GetLastChild (const Index: Integer): Integer |
Renvoie l'index de la dernière ligne enfant par rapport à la ligne spécifiée dans le paramètre Index. |
function GetLevel (const Index: Integer): Integer |
Renvoie le niveau d'imbrication de la chaîne spécifiée. |
function GetNextSibling (const Index: Integer): Integer |
Renvoie l'index de la ligne suivante située au même niveau. S'il n'y a pas de ligne suivante au même niveau, il renvoie -1. |
function GetParent (const Index: Integer): Integer |
Renvoie l'index de la chaîne parent. |
function GetPrevSibling (const Index: Integer): Integer |
Renvoie l'index de la ligne précédente située au même niveau. S'il n'y a pas de ligne précédente au même niveau, il renvoie -1. |
function HasChildren (const Index: Integer): Boolean |
Recherche s'il existe des enregistrements enfants pour la ligne spécifiée. |
procedure InsertRow (Pos: Integer; Count: Integer = 1) |
Insère une nouvelle ligne à la position spécifiée. Dans ce cas, les données ne sont pas ajoutées à la base de données. |
procedure LoadFromTextFile (const FileName: String; Separator: Char = ','; MultiLineSeparator: Char = '|'; StartRow: Integer = 0) |
Charge les données d'un fichier texte dans un composant. Dans ce cas, les données ne tombent pas dans la base de données. L'encodage utilisé pour le fichier téléchargé doit être Unicode (UCS-2 Little Endian) |
procedure MoveRow (FromPos, ToPos: Integer) |
Déplace la ligne. Dans ce cas, aucune modification n'est apportée à la base de données. |
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 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 ScrollToRow (index: integer) |
Déplace le défilement dans le tableau afin que la ligne spécifiée soit visible. |
procedure SelectAll |
Sélectionne toutes les lignes du composant. Pour que la méthode fonctionne, les valeurs goMultiSelect et goSelectFullRow doivent être présentes dans la propriété Options. |
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 lignes. |
Evènements
Evènement |
Description |
OnAfterSort (Sender: TObject; ACol: Integer) |
Se déclenche après le tri de la colonne. |
OnCellClick (Sender: TObject; ACol, ARow: Integer) |
Se déclenche lorsque l'utilisateur clique sur une cellule. Plus d'infos. |
OnCellDoubleClick (Sender: TObject; ACol, ARow: Integer) |
Se déclenche lorsque l'utilisateur double-clique sur une cellule. |
OnChange (Sender: TObject) |
Se déclenche une fois 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 déclenche lorsque la colonne est redimensionnée. |
OnDoubleClick (Sender: TObject) |
Se produit lorsque l'utilisateur double-clique sur le bouton gauche de la souris lorsque le pointeur se trouve sur le composant. |
OnEnter (Sender: TObject) |
Se produit lorsqu'un composant reçoit le focus. |
OnExit (Sender: TObject) |
Se produit lorsque le focus se déplace d'un composant à un autre. |
OnExpand (Sender: TObject; ARow: Integer) |
Se déclenche lorsqu'un nœud est développé ou fermé. |
OnFooterClick (Sender: TObject; ACol: Integer) |
Se déclenche lorsque l'utilisateur a cliqué sur l'en-pied de la page (pied de page). |
OnHeaderClick (Sender: TObject; ACol: Integer) |
Se déclenche lorsque l'utilisateur clique sur une en-tête de colonne. |
OnHeaderDoubleClick (Sender: TObject; ACol: Integer) |
Se déclenche lorsque l'utilisateur double-clique sur une en-tête de colonne. |
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 déclenche 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 sur 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 déclenche lorsque le composant est redimensionné. |
OnRowMove (Sender: TObject; FromPos, ToPos: Integer; var Accept: Boolean) |
Se déclenche lorsque l'utilisateur a déplacé une ligne vers une nouvelle position. Permet aussi d'annuler le déplacement. Plus d'infos. |
OnSortColumn (Sender: TObject; ACol: Integer; Ascending: Boolean) |
Se déclenche avant de trier 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. |