feedback_list_util¶

Quelle: base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl

Hinweise

Eine Feedback-Leiste, die jeweils eine zeitlich begrenzte Nachricht zeigt (Info, Warnung, Fehler oder eine Frage mit Bestätigungsschaltfläche). Der Linien- und Fahrzeug-Manager und das Infofenster von Fahrzeugen verwenden sie.

FeedbackListUtil¶

record global base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:3

global record FeedbackListUtil

Laden: local feedback_list_util = ug_require "::/gui/line_vehicle_mgmt/feedback_list_util.tl" as FeedbackListUtil

Hinweise

Feedback-Leiste für kurze Rückmeldungen zu Befehlen und für Bestätigungsfragen. Das Recipe ist FeedbackList.

Felder

Name	Typ	Beschreibung
`FeedbackList`	`RecipeWithApi<FeedbackListParams, FeedBackViewerAPI>`	Recipe der Feedback-Leiste. Über seine Node-Ref erreichst du `FeedBackViewerAPI`.Im Spiel {countFeedback} zusätzliche Feedback-Nachrichten · FertigIm Code: {countFeedback} Additional Feedback Messages · Dismiss 4-mal im Basisspiel verwendet

FeedbackListUtil.FeedbackDialogParam¶

record base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:4

record FeedbackDialogParam

Hinweise

Bestätigungsschaltfläche einer Feedback-Nachricht vom Typ Question oder Info.

Im Basisspiel verwendet: 3-mal in 3 Dateien

base/content/gui/gui/entity_window/vehicle/vehicle.tl:306

dialogData : FeedbackListUtil.FeedbackDialogParam,

base/content/gui/gui/line_vehicle_mgmt/feedback_list_util.tl:113

dialogData : FeedbackListUtil.FeedbackDialogParam,

base/content/gui/gui/line_vehicle_mgmt/manager_window.tl:6361

dialogData : FeedbackListUtil.FeedbackDialogParam,

Felder

Name	Typ	Beschreibung
`acceptText`	`string`	Beschriftung der Bestätigungsschaltfläche (z. B. `_("Delete")`).
`soundOnAccept`	`SoundOnAccept`	Optionaler Sound-Stil der Bestätigungsschaltfläche.

Funktionen

onAccept() base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:10

Hinweise

Wird beim Klick auf die Bestätigungsschaltfläche aufgerufen. Danach verschwindet die Nachricht.

FeedbackListUtil.FeedbackDialogParam.SoundOnAccept¶

enum base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:5

enum SoundOnAccept

Hinweise

Sound-Stil der Bestätigungsschaltfläche.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/line_vehicle_mgmt/feedback_list_util.tl:56

local sound2style <total> : {FeedbackListUtil.FeedbackDialogParam.SoundOnAccept:string} = {

Wert	Beschreibung
`"SellVehicle"`	Die Bestätigungsschaltfläche bekommt die Style-Klasse `sell-vehicle-sfx` (Verkaufsgeräusch).
`"DeleteLine"`	Die Bestätigungsschaltfläche bekommt die Style-Klasse `delete-line-sfx` (Geräusch zum Löschen einer Linie).

FeedbackListUtil.CommandFeedback¶

record base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:15

record CommandFeedback

Hinweise

Eine Feedback-Nachricht in der Warteschlange, wie FeedbackList sie speichert.

Im Basisspiel verwendet: 2-mal in 1 Datei

base/content/gui/gui/line_vehicle_mgmt/feedback_list_util.tl:10

commandFeedback : FeedbackListUtil.CommandFeedback

Felder

Name	Typ	Beschreibung
`time`	`number`	Anwendungszeit (aus `api.util.getApplicationTime()`), zu der die Nachricht abläuft. Mit 0 verschwindet sie sofort.
`message`	`string`	Text, den der Spieler sieht.
`mode`	`Mode`	Art der Nachricht.
`dialogData`	`FeedbackDialogParam`	Einstellungen der Bestätigungsschaltfläche für Nachrichten vom Typ `Info` und `Question`.
`timeout`	`number`	Anzeigedauer in Sekunden (Standard 5).
`id`	`number`	Optionale ID. Kommt eine Nachricht mit der ID einer wartenden Nachricht dazu, ersetzt sie diese, statt sich neu einzureihen.
`dismissible`	`boolean`	Bei true erscheint eine Schaltfläche zum Schließen (bei Fragen zum Abbrechen).

FeedbackListUtil.CommandFeedback.Mode¶

enum base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:16

enum Mode

Hinweise

Art der Nachricht. Davon hängen der Stil des Bandes ab und ob eine Bestätigungsschaltfläche erscheint.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/line_vehicle_mgmt/feedback_list_util.tl:112

mode : FeedbackListUtil.CommandFeedback.Mode,

Wert	Beschreibung
`"Info"`	Hinweis (Stil `info-tape`). Zeigt die Bestätigungsschaltfläche aus `dialogData`.
`"Warning"`	Warnung (Stil `warning-tape`).
`"Error"`	Fehlermeldung (Stil `error-tape`).
`"Question"`	Frage (Stil `info-tape`) mit der Bestätigungsschaltfläche aus `dialogData` und einer Schaltfläche zum Abbrechen.

FeedbackListUtil.FeedBackViewerAPI¶

record base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:31

record FeedBackViewerAPI

Hinweise

API eines FeedbackList-Knotens.

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/line_vehicle_mgmt/feedback_list_util.tl:187

end) as RecipeWithApi<FeedbackListUtil.FeedbackListParams, FeedbackListUtil.FeedBackViewerAPI>

Funktionen

addFeedback(message : string, mode? : string, dialogData? : FeedbackDialogParam, timeout? : number, id? : number, dismissible? : boolean) base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:32

Hinweise

Reiht eine Feedback-Nachricht ein und spielt LvmSFX.Feedback ab.

Parameter	Typ	Beschreibung
`message`	`string`	Text, der angezeigt wird.
`mode?`	`string`	`Info`, `Warning`, `Error` oder `Question`. Ohne Modus bekommt die Nachricht den Warnungsstil.
`dialogData?`	`FeedbackDialogParam`	Bestätigungsschaltfläche für Nachrichten vom Typ `Info` und `Question`.
`timeout?`	`number`	Anzeigedauer in Sekunden, Standard 5.
`id?`	`number`	Ersetzt eine wartende Nachricht mit derselben ID, statt eine neue hinzuzufügen.
`dismissible?`	`boolean`	Zeigt eine Schaltfläche zum Schließen bzw. Abbrechen.

Details

Angezeigt wird nur die erste Nachricht in der Warteschlange, dazu ein Zähler +N für die übrigen. Bei den Nachrichten dahinter wird der Ablauf in jedem Frame nach hinten verschoben. So bekommt jede Nachricht ihr volles timeout, sobald sie sichtbar wird.

Beispiel

-- aus manager_window.tl (commonParams.addFeedback leitet an diese API weiter)
addFeedback(_("Deleting the line will sell all vehicles on the line."), "Question", {
    onAccept = function() wrappedCommitDelete() end,
    acceptText = _("Delete"),
    soundOnAccept = "DeleteLine",
}, 2)

hasFeedback() : boolean base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:39

Hinweise

Sagt, ob eine Nachricht in der Warteschlange steht.

Rückgabe boolean: True, wenn mindestens eine Nachricht wartet.

FeedbackListUtil.FeedbackListParams¶

record base/tealdef/gui/line_vehicle_mgmt/feedback_list_util.d.tl:42

record FeedbackListParams

Hinweise

Parameter von FeedbackList (keine; übergib {}).

Im Basisspiel verwendet: 1-mal in 1 Datei

base/content/gui/gui/line_vehicle_mgmt/feedback_list_util.tl:187

end) as RecipeWithApi<FeedbackListUtil.FeedbackListParams, FeedbackListUtil.FeedBackViewerAPI>