TActionList — Sammlung von Befehlen

Hält die TAction-Objekte einer Anwendung und zieht ihren Zustand im Leerlauf nach. Sie ist Eigentümerin: was hier angelegt wird, gibt sie beim Zerstören mit frei.

Unit: vega.actions · Basis: keine — eigene Wurzel

→ Alle Steuerelemente · Klassenbaum · Guide: Komponenten

Vererbung

Kette: TActionList — eigene Wurzel, kein Vorfahr. Was diese Klasse kann, steht vollständig auf dieser Seite.

Direkte Nachfahren: keine — diese Klasse wird nicht weiter abgeleitet.

Quelle: vega/actions.lyx

Verwendung

var al: TActionList := new TActionList();

var neu:  TAction := al.Add("Neu");
var oeff: TAction := al.Add("Oeffnen");
var spei: TAction := al.Add("Speichern");

// ... verknuepfen und Handler setzen ...

al.SetEnabled(false);   // schaltet die Zustandspflege ab, nicht die Befehle

TApplication ruft UpdateActions selbst; eine eigene Schleife braucht es nicht.

Besonderheiten

  • Enabled schaltet die Zustandspflege, nicht die Befehle: ausgeschaltet läuft kein OnUpdate mehr. Nützlich, solange die Anwendung gerade selbst am Zustand schraubt und nicht dagegen anarbeiten will.
  • Die Liste besitzt ihre Befehle. Destroy gibt sie mit frei — einzelne Befehle nicht selbst zerstören.
  • Add legt an und trägt ein in einem Schritt; das Ergebnis ist der neue TAction.

Eigenschaften

Alle Eigenschaften, auch die geerbten.

Name Typ Bedeutung Herkunft
Enabled bool Ausgeschaltet laeuft kein OnUpdate mehr. Nuetzlich, solange eine Anwendung gerade selbst am Zustand schraubt eigen
Items TObjectList Kind Nummer i eigen

Methoden

Alle Methoden, auch die geerbten.

Signatur Zweck Herkunft
Add(caption: pchar): TAction Einen Befehl anlegen und aufnehmen. Er gehört danach der Liste eigen
AddAction(a: TAction): void Einen fertigen Befehl aufnehmen eigen
At(i: int64): TAction Befehl Nummer i eigen
ByName(name: pchar): TAction Befehl über seinen Namen finden. Das ist der Weg für Anwendungen, die ihre Oberflaeche aus einer Datei aufbauen — dort steht ein Name, kein Zeiger eigen
Count(): int64 Zahl der Befehle eigen
Create(): void Anlegen; new TActionList() eigen
Destroy(): void Gibt eigene Ressourcen frei eigen
HandleShortcut(key: int64, mods: int64): bool Ein Tastenkuerzel ausfuehren, das zu keinem Menue gehört. Menues prüfen ihre Kürzel selbst; das hier ist für Befehle, die nur in der Werkzeugleiste haengen eigen
Update(): void Alle Befehle prüfen lassen. Wird von TApplication gerufen eigen
UpdateThrottled(now: int64): bool Gedrosselte Fassung: prüft hoechstens alle VEGA_ACTION_UPDATE_MS. Liefert true, wenn wirklich geprueft wurde eigen

Letzte Aktualisierung: 2026-09-05 — Seite neu angelegt; erhoben aus vega/actions.lyx im Repo lyx-vcl.