FB_EntitiesHandler - AddTargetType (Methode)

Übersicht

Typ:	Methode
Verfügbar ab:	V1.4.1.0

Dieses Kapitel enthält Informationen zu folgenden Aspekten:

oAufgabenstellung

oBeschreibung

oSchnittstelle

oDiagnosemeldungen

Aufgabenstellung

Hinzufügen eines neuen Zieltyps zum Funktionsbaustein

Beschreibung

Die Methode AddTargetType wird verwendet, um dem Funktionsbaustein ein neues Ziel hinzuzufügen.

Die mit dieser Methode konfigurierten Daten werden innerhalb des Funktionsbausteins gespeichert und können später verwendet werden, um physische Informationen zu einem bestimmten Zieltyp (z. B. Länge, Höhe, Masse) abzurufen.

Die folgenden Parameter gelten als optional:

oi_stData.etShape: Wenn kein gültiger Wert angegeben wird, wird für das Feld automatisch der Standardwert ET_GeometricShape.Cube übernommen.

oi_stData.lrLength: Kann als Nullwert belassen werden.

oi_stData.lrWidth: Kann als Nullwert belassen werden.

oi_stData.lrHeight: Kann als Nullwert belassen werden.

oi_stData.lrMass: Kann als Nullwert belassen werden.

oi_stData.stCenterOfMass: Kann als Null-3D-Vektor belassen werden.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_stData	ST_TargetTypeData	Eine Datenstruktur, die eine Beschreibung eines Zieltyps in Form von physikalischen Eigenschaften enthält.

Ausgang	Datentyp	Beschreibung
q_etDiag	GD.ET_Diag	Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. EinWert ungleich GD.ET_Diag.Ok entspricht einer Diagnosemeldung.
q_etDiagExt	ET_DiagExt	Bausteinspezifischer Ausgang zur Diagnose. q_etDiag = ET_Diag.Ok -> Statusmeldung q_etDiag <> ET_Diag.Ok -> Diagnosemeldung
q_sMsg	STRING[80]	Ereignisabhängige Meldung, die detaillierte Informationen zum Diagnosezustand übergibt.

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. EinWert ungleich GD.ET_Diag.Ok entspricht einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

Bausteinspezifischer Ausgang zur Diagnose.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

q_sMsg

STRING[80]

Ereignisabhängige Meldung, die detaillierte Informationen zum Diagnosezustand übergibt.

Diagnosemeldungen

q_etDiag	q_etDiagExt	Enumerationswert von q_etDiagExt	Beschreibung
Ok	Ok	0	Ok
Ok	GeometricShapeInvalid	139	Der Wert einer geometrischen Form ist ungültig.
ExecutionAborted	MaxNumberOfTargetTypesExceeded	140	Die maximale Anzahl konfigurierbarer Zieltypen ist erreicht.
InputParameterInvalid	HeightRange	143	Eine angegebene Höhe liegt nicht im zulässigen Bereich.
InputParameterInvalid	LengthRange	141	Eine angegebene Länge liegt nicht im zulässigen Bereich.
InputParameterInvalid	MassRange	144	Eine angegebene Masse liegt nicht im zulässigen Bereich.
InputParameterInvalid	TargetTypeInvalid	134	Der angegebene Zieltyp ist ungültig.
InputParameterInvalid	WidthRange	142	Eine angegebene Breite liegt nicht im zulässigen Bereich.

GeometricShapeInvalid

Enumerationsname:	GeometricShapeInvalid
Enumerationswert:	139
Beschreibung:	Der Wert einer geometrischen Form ist ungültig.

Problem	Ursache	Lösung
Ein Zieltyp wurde erfolgreich zur Liste hinzugefügt, aber die Bibliothek hat dem Zieltyp den Standardwert ET_GeometricShape.Cube zugewiesen.	i_stData.etShape enthält einen ungültigen Wert.	Geben Sie unbedingt einen Wert im Bereich von ET_GeometricShape.Cube bis ET_GeometricShape.TriangularPrism an.

HeightRange

Enumerationsname:	HeightRange
Enumerationswert:	143
Beschreibung:	Eine angegebene Höhe liegt nicht im zulässigen Bereich.

Problem	Ursache	Lösung
Ein Zieltyp wurde nicht erfolgreich zur Liste hinzugefügt.	i_stData.lrHeight enthält einen negativen Wert.	Stellen Sie sicher, dass i_stData.lrHeight entweder Null oder ein positiver Wert ist.

LengthRange

Enumerationsname:	LengthRange
Enumerationswert:	141
Beschreibung:	Eine angegebene Länge liegt nicht im zulässigen Bereich.

Problem	Ursache	Lösung
Ein Zieltyp wurde nicht erfolgreich zur Liste hinzugefügt.	i_stData.lrLength enthält einen negativen Wert.	Stellen Sie sicher, dass i_stData.lrLength entweder Null oder ein positiver Wert ist.

MassRange

Enumerationsname:	MassRange
Enumerationswert:	144
Beschreibung:	Eine angegebene Masse liegt nicht im zulässigen Bereich.

Problem	Ursache	Lösung
Ein Zieltyp wurde nicht erfolgreich zur Liste hinzugefügt.	i_stData.lrMass enthält einen negativen Wert.	Stellen Sie sicher, dass i_stData.lrMass entweder Null oder ein positiver Wert ist.

MaxNumberOfTargetTypesExceeded

Enumerationsname:	MaxNumberOfTargetTypesExceeded
Enumerationswert:	140
Beschreibung:	Die maximale Anzahl konfigurierbarer Zieltypen ist erreicht.

Problem	Ursache	Lösung
Ein Zieltyp wurde nicht erfolgreich zur Liste hinzugefügt.	Gc_uiMaxNumberOfTargetTypes Zieltypen wurden bereits konfiguriert.	Achten Sie darauf, nicht mehr als Gc_uiMaxNumberOfTargetTypes Zieltypen zu konfigurieren.

Enumerationsname:	Ok
Enumerationswert:	0
Beschreibung:	Ok

Statusmeldung: Ein Zieltyp wurde der Liste erfolgreich hinzugefügt.

TargetTypeInvalid

Enumerationsname:	TargetTypeInvalid
Enumerationswert:	134
Beschreibung:	Der angegebene Zieltyp ist ungültig.

Problem	Ursache	Lösung
Ein Zieltyp wurde nicht erfolgreich zur Liste hinzugefügt.	i_stData.etType enthält einen ungültigen Wert.	Stellen Sie sicher, dass i_stData.etType einen Wert im Bereich von ET_TargetType.Type1 bis ET_TargetType.Type20 enthält.

WidthRange

Enumerationsname:	WidthRange
Enumerationswert:	142
Beschreibung:	Eine angegebene Breite liegt nicht im zulässigen Bereich.

Problem	Ursache	Lösung
Ein Zieltyp wurde nicht erfolgreich zur Liste hinzugefügt.	i_stData.lrWidth enthält einen negativen Wert.	Stellen Sie sicher, dass i_stData.lrWidth entweder Null oder ein positiver Wert ist.