clear_metrology_objectT_clear_metrology_objectClearMetrologyObjectClearMetrologyObjectclear_metrology_object (Operator)
Name
clear_metrology_objectT_clear_metrology_objectClearMetrologyObjectClearMetrologyObjectclear_metrology_object — Löschen von Metrology-Messobjekten und Freigabe des verwendeten
Speichers.
Signatur
Beschreibung
clear_metrology_objectclear_metrology_objectClearMetrologyObjectClearMetrologyObjectClearMetrologyObjectclear_metrology_object löscht in einem Messmodell z.B. mit
add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureadd_metrology_object_ellipse_measure,
add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureadd_metrology_object_ellipse_measure,
add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureadd_metrology_object_line_measure oder
add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure
angelegte Metrology-Messobjekte und gibt
den von den Metrology-Messobjekten referenzierten Speicherplatz wieder
frei.
Das Handle des Messmodells muss in
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle übergeben werden. Der Index der zu
löschenden Metrology-Messobjekte muss in IndexIndexIndexIndexindexindex übergeben
werden. Wird für den Parameter IndexIndexIndexIndexindexindex als Wert 'all'"all""all""all""all""all"
übergeben, werden alle Metrology-Messobjekte gelöscht. Nach dem Aufruf
sind die Metrology-Messobjekte ungültig.
Das Konzept der 2D-Messtechnik ist bei der Einleitung zu Kapitel
2D-Messtechnik beschrieben.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Parameter
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle (input_control, Zustand wird modifiziert) metrology_model → HMetrologyModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Messmodells.
IndexIndexIndexIndexindexindex (input_control) integer(-array) → HTupleMaybeSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Index der Metrology-Messobjekte.
Defaultwert:
'all'
"all"
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
clear_metrology_objectclear_metrology_objectClearMetrologyObjectClearMetrologyObjectClearMetrologyObjectclear_metrology_object den Wert TRUE. Gegebenenfalls wird
eine Fehlerbehandlung durchgeführt.
Modul
2D Metrology