FMX.ActnList.TAction
Delphi
TAction = class(TCustomAction)
C++
class PASCALIMPLEMENTATION TAction : public TCustomAction
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | FMX.ActnList.pas FMX.ActnList.hpp |
FMX.ActnList | FMX.ActnList |
Beschreibung
TAction ist die Basisklasse für FireMonkey-Aktionsobjekte. TAction und abgeleitete Klassen implementieren Aktionen für die Verwendung mit Steuerelementen, Menüeinträgen und Schaltflächen. Die published-Eigenschaften und -Ereignisse von TAction-Aktionen können zur Entwurfszeit im Objektinspektor verwaltet werden.
Die Klasse TAction entspricht weitgehend der Klasse TCustomAction. TAction erweitert nur die folgenden Features von TCustomAction:
- Ändert für die folgenden Eigenschaften den Gültigkeitsbereich public in published: AutoCheck, Checked, Enabled, GroupIndex, HelpType, HelpContext, HelpKeyword, Hint, ShortCut, SecondaryShortCuts, Text, Visible, UnsupportedArchitectures und UnsupportedPlatforms.
- Legt für die Ereignisse OnExecute und OnUpdate den Gültigkeitsbereich published fest.
- Der Gültigkeitsbereich published dieser Eigenschaften und Ereignisse ermöglicht, dass die Werte dieser Eigenschaften und Ereignisse mit dem Objektinspektor bearbeitet werden können.
- Die Eigenschaft DisableIfNoHandler wird während der Erstellung einer Aktion auf True gesetzt; das heißt, dass auf die Aktion nicht zugegriffen werden kann, wenn sie über keine OnExecute Ereignisbehandlungsroutine verfügt.
TAction ist eine generische Aktionskomponente. Sie kann zu Aktionslisten hinzugefügt werden, wenn keine vordefinierte Aktionsklasse vorhanden ist, die die gewünschte Reaktion auf Benutzerbefehle implementiert. Im Gegensatz zu vordefinierten Aktionsklassen, die mit integrierten Methoden reagieren, wenn Benutzer auf Client-Steuerelemente klicken, verfügt TAction über keine integrierten Reaktionen auf Benutzerbefehle. Stattdessen können Sie für TAction die Reaktion auf das Auslösen der Aktion durch Schreiben (im Objektinspektor) einer OnExecute-Ereignisbehandlungsroutine bereitstellen und die Eigenschaften von TAction mit einer OnUpdate-Ereignisbehandlungsroutine so konfigurieren, dass die aktuellen Bedingungen wiedergegeben werden.
Mit Aktionsobjekten werden die Reaktionen auf Benutzerbefehle (Aktionen) zentralisiert und Oberflächenelemente in Anwendungen dargestellt, die Aktionslisten verwenden.
Die Eigenschaft Visible definiert, ob die Aktionsdarstellung sichtbar ist. Dieser Visible-Wert kann an einen Client der Aktion weitergegeben werden. Normalerweise gibt IsVisibleLinked einer Aktionsverknüpfung True zurück, wenn die Aktion zu TAction gehört. In diesem Fall, wenn die Eigenschaft Visible auf False gesetzt ist, dann wird die Eigenschaft Visible des Client auch auf False gesetzt. Wenn z. B. ein Client ein Menüelement oder ein Steuerelement ist, dann wird dieses Menüelement oder Steuerelement auf unsichtbar gesetzt. Dieses Verhalten von Visible in TAction ist der Gegensatz zum Verhalten in TCustomViewAction.
TAction kann auch als Basisklasse für vordefinierte Aktionsklassen verwendet werden. Sie können Klassen von TAction ableiten, wenn Sie den Gültigkeitsbereich published der unterstützten Eigenschaften und Ereignisse beibehalten möchten. Wenn Sie für einige der unterstützten Eigenschaften und Ereignisse den Gültigkeitsbereich public verwenden möchten, können Sie von TCustomAction ableiten.
Informationen über vordefinierte Aktionen, die das Verhalten von TAction erweitern, finden Sie bei den Aktionsklassen in der Unit FMX.StdActns.