Vcl.ActnList.TCustomAction.Execute

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Execute: Boolean; override;

C++

DYNAMIC bool __fastcall Execute();

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Vcl.ActnList.pas
Vcl.ActnList.hpp
Vcl.ActnList TCustomAction

Beschreibung

Reagiert, wenn ein Client-Steuerelement ausgelöst wird.

Execute wird automatisch aufgerufen, wenn ein Client-Steuerelement einen Impuls auslöst (beispielsweise wenn der Benutzer einen Schaltfläche anklickt oder einen Menüeintrag auswählt). Die Methode gibt True zurück, wenn eine Ereignisbehandlungsroutine für die Aktion gefunden wurde, und False, wenn keine Ereignisbehandlungsroutine vorhanden oder die Aktion deaktiviert ist.

Execute überprüft zunächst, ob die Aktion aktualisiert wurde. Wenn die Eigenschaft Enabled True ist, versucht die Methode anschließend, die Aktion durch das Erzeugen eines OnExecute-Ereignisses für die Aktionsliste, die die betreffende Aktion enthält (sofern die Aktion zu einer Aktionsliste gehört) zu verarbeiten. Wenn die OnExecute-Ereignisbehandlungsroutine der Aktionsliste die Aktion nicht behandeln kann, erzeugt Execute ein OnActionExecute-Ereignis für die Anwendung. Wenn weder die Aktionsliste noch die Anwendung die Aktion als Reaktion auf diese Ereignisse bearbeitet, erzeugt Execute ein eigenes OnExecute-Ereignis. Wenn diese Aktion keine OnExecute-Ereignisbehandlungsroutine besitzt, wird die Anwendung angewiesen, das aktuelle Zielsteuerelement zu suchen und die Methode ExecuteTarget aufzurufen. Diese Methode ist der Mechanismus, anhand dessen vordefinierte Aktionsklassen ihre Funktionen ausführen.

Siehe auch

Codebeispiele