SetAction

Kategorie: Objekte / Aktivität
Ab Engineversion: 4.6.5.0 CP

Beschreibung

Setzt die Aktivität des aufrufenden Objekts. Siehe auch ActMap.txt.

Syntax

bool SetAction (string szAction, object pTarget1, object pTarget2, bool fDirect);

Parameter

szAction:
Neue Aktivität. "ActIdle" oder "Idle" löscht die Aktivität.
pTarget1:
[opt] Erstes Zielobjekt für die Aktivität
pTarget2:
[opt] Zweites Zielobjekt für die Aktivität
fDirect:
[opt] Wenn true, werden Start-/AbortCalls umgangen, und die Aktivität wird trotz NoOtherAction gesetzt.

Anmerkungen

Wird pTarget1 bzw. pTarget2 nicht angegeben bzw. 0 übergeben, so bleibt das jeweiligen Action Target der vorigen Aktion erhalten. Um die Action Targets zu löschen sollte SetActionTargets benutzt werden.
Um die Aktivität eines Fremdobjektes zu setzen, sollte ObjectSetAction oder fremdobjekt->SetAction() benutzt werden.
Wenn fDirect false ist, wird der StartCall der Aktivität während der Ausführung von SetAction aufgerufen. Wenn dieser also zum Beispiel das Objekt löscht, darf die aufrufende Funktion danach nichts mehr mit dem Objekt machen!

Beispiel

SetAction("Dead");
Der aufrufende Clonk wird scheintot.
Siehe auch: GetAction, GetActionTarget, ObjectSetAction, SetActionKeepPhase, SetDir, SetPhase
Sven2, Juni 2003
Günther, Dezember 2004