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.

 dbPopupMenu

 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;

 Canvas

 TCanvas

 Une classe qui permet de peindre 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 (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).

 Color

 TColor

 La couleur d'arrière-plan du composant. Plus de'infos.

 Columns

 TNxColumns

 Permet d'accéder aux propriétés et méthodes supplémentaires des colonnes. Plus d'infos.

 Columns[i]

 TNxCustomColumn

 Permet d'accéder aux propriétés de la 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 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.

 Font

 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

 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

 La propriété renvoie l'index de la dernière ligne ajoutée. Uniquement pour la lecture.

 Name

 String

 Le nom du composant..

 Options

 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.

 Row[i]

 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.

 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.

 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.