System.Classes.TReader.OnSetName
Delphi
property OnSetName: TSetNameEvent read FOnSetName write FOnSetName;
C++
__property TSetNameEvent OnSetName = {read=FOnSetName, write=FOnSetName};
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
event | public | System.Classes.pas System.Classes.hpp |
System.Classes | TReader |
Description
Se produit avant que l'objet lecteur n'affecte à la propriété Name d'un composant la valeur lue dans le flux.
OnSetName est utilisé de manière interne par l'environnement de développement intégré (EDI) pour traiter les noms de composant ou de fiche dupliqués. Il permet également d'écrire un gestionnaire d'événements pour effectuer des opérations particulières juste avant qu'une valeur ne soit affectée à la propriété Name d'un composant venant d'être créé et dont les propriétés vont être lues dans le flux.
Le paramètre Name du gestionnaire d'événements OnSetName passé par référence, le gestionnaire peut donc modifier le nom avant que le lecteur ne l'affecte au composant. Par exemple, OnSetName permet de filtrer tous les noms de composant d'une fiche, afin d'ajouter ou de retirer une partie de la chaîne.
OnSetName est un gestionnaire d'événements du type TSetNameEvent.