====== TActionList — Sammlung von Befehlen ======

Hält die [[lyx_-_programmiersprache:vega:controls:taction|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

→ [[lyx_-_programmiersprache:vega:controls|Alle Steuerelemente]] · [[lyx_-_programmiersprache:vega:klassenbaum|Klassenbaum]] · [[lyx_-_programmiersprache:vega:guides:komponenten|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 =====

<code lyx>
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
</code>

''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 [[lyx_-_programmiersprache:vega:controls:taction|TAction]].

----

===== Eigenschaften =====

Alle Eigenschaften, auch die geerbten.

^ Name ^ Typ ^ Bedeutung ^ Herkunft ^
| ''Enabled'' | [[lyx_-_programmiersprache:sprache:datentypen#5_wahrheitswerte_bool|bool]] | Ausgeschaltet laeuft kein OnUpdate mehr. Nuetzlich, solange eine Anwendung gerade selbst am Zustand schraubt | eigen |
| ''Items'' | [[lyx_-_programmiersprache:vega:controls:tobjectlist|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''.