FB_CollisionEntity – AddCollisionGroup

Überblick

Typ:	Methode
Verfügbar ab:	V1.0.0.0

Dieses Kapitel enthält Informationen zu folgenden Aspekten:

Aufgabe
Beschreibung
Schnittstelle
Rückgabewert
Diagnosemeldungen

Aufgabe

Fügt eine Kollisionsgruppe hinzu.

Beschreibung

Hinzufügen einer Kollisionsgruppe zur Kollisionseinheit.

Schnittstelle

Der Funktionsbaustein implementiert die Schnittstelle IF_CollisionEntity.

Zugriff: PUBLIC

Rückgabetyp: UDINT

Eingang	Datentyp	Beschreibung
i_ifCollisionGroup	IF_CollisionGroup	Zur Einheit hinzuzufügende Kollisionsgruppe.

Ausgang	Datentyp	Beschreibung
q_xError	BOOL	Der Ausgang wird auf TRUE gesetzt, wenn bei der Ausführung ein Fehler erkannt wurde.
q_etResult	ET_Result	POU-spezifischer Ausgang der Diagnose. q_xError = FALSE -> Statusmeldung. q_xError = TRUE -> Diagnosemeldung.
q_sResultMsg	STRING(80)	Ereignisabhängige Meldung, die zusätzliche Informationen über den Diagnosezustand gibt.

Rückgabewert

Der zurückgegebene Wert ist der Index der der Liste hinzugefügten Kollisionsgruppe. Er kann für den Verweis auf diese Gruppe über die Eigenschaft raifCollisionGroups verwendet werden.

Diagnosemeldungen

q_xError	q_etResult	Enumerationswert	Beschreibung
FALSE	Ok	0	Erfolg
TRUE	MaxNumberOfCollisionEntityGroupsReached	32	Die maximale Anzahl der Kollisionseinheitsgruppen wurde erreicht.
TRUE	InterfaceInvalid	11	Die bereitgestellte Schnittstelle ist ungültig (null).

OK

Enumerationsname:	Ok
Enumerationswert:	0
Beschreibung:	Erfolg

MaxNumberOfCollisionEntityGroupsReached

Enumerationsname:	MaxNumberOfCollisionEntityGroupsReached
Enumerationswert:	32
Beschreibung:	Die maximale Anzahl der Kollisionseinheitsgruppen wurde erreicht.

Problem	Ursache	Lösung
Es konnte keine Kollisionsgruppe zur Einheit hinzugefügt werden.	Die Liste der Kollisionsgruppen für diese Einheit ist bereits voll, d. h. udiNumberOfCollisionGroups = Gc_udiMaxNumberOfCollisionEntityGroups.	Stellen Sie sicher, dass udiNumberOfCollisionGroups < Gc_udiMaxNumberOfCollisionEntityGroups, bevor Sie diese Methode aufrufen.

InterfaceInvalid

Enumerationsname:	InterfaceInvalid
Enumerationswert:	11
Beschreibung:	Die bereitgestellte Schnittstelle ist ungültig (null).

Problem	Ursache	Lösung
Es konnte keine Kollisionsgruppe zur Einheit hinzugefügt werden.	i_ifCollisionGroup enthält eine ungültige Schnittstelle.	Stellen Sie sicher, dass i_ifCollisionGroup nicht null ist.

FB_CollisionEntity – AddCollisionGroup - (Methode)