System.Classes.TReader.OnSetName
Delphi
property OnSetName: TSetNameEvent read FOnSetName write FOnSetName;
C++
__property TSetNameEvent OnSetName = {read=FOnSetName, write=FOnSetName};
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
event | public | System.Classes.pas System.Classes.hpp |
System.Classes | TReader |
Beschreibung
Wird ausgelöst, bevor das Reader-Objekt die Eigenschaft Name derjenigen Komponente setzt, die aus einem Stream gelesen wird.
OnSetName wird intern von der IDE verwendet, um das mehrfache Vorkommen von Komponenten- und Formularnamen abzufangen. Die Eigenschaft kann außerdem in einer Ereignisbehandlungsroutine verwendet werden, um spezielle Schritte auszuführen, bevor die Eigenschaft Name einer gerade erzeugten Komponente gesetzt und deren Eigenschaften aus dem Stream gelesen werden.
Der Parameter Name wird der Ereignisbehandlungsroutine für OnSetName per Referenz übergeben, sodass die Ereignisbehandlungsroutine den Namen ändern kann, bevor sie ihn der Komponente zuweist. OnSetName ist beispielsweise hilfreich, wenn alle Komponentennamen in einem Formular gefiltert werden sollen und dazu ein Teil des Strings geändert oder hinzugefügt wird.
OnSetName ist eine Ereignisbehandlungsroutine des Typs TSetNameEvent.