Objekt · SldWorks
Measure-Objekt
Das Messwerkzeug: misst ausgewählte oder übergebene Elemente und liefert Abstände, Winkel, Längen, Flächen, Umfang, Durchmesser und Koordinaten.
Beschreibung
Measure gibt Zugriff auf das Messwerkzeug (measure tool). Du wählst ein oder zwei Elemente aus, etwa Flächen, Kanten oder Eckpunkte, oder übergibst sie als Array, rufst Measure.Calculate auf und liest danach die Ergebnisse. Ergebnisse, die für die gemessenen Elemente nicht gelten, sind -1. Die Befehle gibt es seit SOLIDWORKS 2008.
Zugriff
ModelDocExtension.CreateMeasure: erzeugt ein Messwerkzeug für das Dokument
Beispiel
' Misst die ausgewählten Elemente mit dem Messwerkzeug und gibt die Ergebnisse
' aus, die für die Auswahl gelten.
' Vorbedingung: Ein Teil ist offen. Ein oder zwei Elemente sind ausgewählt,
' etwa zwei Flächen oder eine Kante.
' Ergebnis: Die Werte stehen im Direktfenster (Strg+G), Längen in mm,
' Flächen in mm², Winkel in Grad.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swMessung As SldWorks.Measure
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swMessung = swModel.Extension.CreateMeasure
' Die Vorgaben nennt die Hilfe nicht, deshalb hier gesetzt
swMessung.ArcOption = swMeasureArcCircle_CenterToCenter
swMessung.ProjectionOption = swMeasureProjectOn_None
If False = swMessung.Calculate(Nothing) Then
Debug.Print "Diese Auswahl kann das Messwerkzeug nicht messen."
Exit Sub
End If
If swMessung.Distance <> -1 Then Debug.Print "Abstand: " & swMessung.Distance * 1000# & " mm"
If swMessung.CenterDistance <> -1 Then Debug.Print "Mittenabstand: " & swMessung.CenterDistance * 1000# & " mm"
If swMessung.Angle <> -1 Then Debug.Print "Winkel: " & swMessung.Angle * 180# / 3.14159265358979 & "°"
If swMessung.Length <> -1 Then Debug.Print "Länge: " & swMessung.Length * 1000# & " mm"
If swMessung.Diameter <> -1 Then Debug.Print "Durchmesser: " & swMessung.Diameter * 1000# & " mm"
If swMessung.Area <> -1 Then Debug.Print "Fläche: " & swMessung.Area * 1000000# & " mm²"
If swMessung.Perimeter <> -1 Then Debug.Print "Umfang: " & swMessung.Perimeter * 1000# & " mm"
If swMessung.TotalArea <> -1 Then Debug.Print "Gesamtfläche: " & swMessung.TotalArea * 1000000# & " mm²"
If swMessung.IsParallel Then Debug.Print "Die Elemente sind parallel."
If swMessung.IsPerpendicular Then Debug.Print "Die Elemente stehen senkrecht aufeinander."
End SubBemerkungen
Hilfebeispiel: „Measure Selected Entities“ öffnet das Teil coupling_auto_geo.sldprt schreibgeschützt, wählt mit ModelDocExtension.SelectByID2 zwei Flächen aus, erzeugt das Messwerkzeug, setzt ArcOption auf 0 (Mittelpunkt zu Mittelpunkt) und ruft Calculate mit Nothing auf. Dann gibt es jedes Ergebnis aus, das nicht -1 ist. IsParallel, IsIntersect, IsPerpendicular und IsConcentricSpheres gibt es nur aus, wenn sie True sind.
-1 heißt „gilt nicht“: Abstände, Längen, Flächen, Winkel und Koordinaten sind -1, wenn sie für die gemessenen Elemente nicht gelten. Nur bei Measure.Radius sagt die Hilfe das nicht, das Hilfebeispiel prüft es trotzdem. Bei Measure.X, Measure.Y und Measure.Z kann -1 auch eine echte Koordinate sein. Die vier Is-Werte liefern True oder False.
Einheiten: Winkel liefert Measure.Angle im Bogenmaß. Für Längen und Flächen nennt die Hilfe keine Einheit; es sind Meter und Quadratmeter. Das Beispiel oben rechnet in mm und mm² um.
Ausgewählte oder übergebene Elemente: Die Hilfe beschreibt die Ergebnisse als Werte der ausgewählten Elemente (selected entities). Übergibst du die Elemente als Array an Measure.Calculate, gelten sie vermutlich genauso. Welche Elemente das Messwerkzeug messen kann und in welcher Kombination, sagt die Hilfe nicht. Bei einer ungültigen Art oder Kombination liefert Calculate False.
Ohne Messwerkzeug: Den kleinsten Abstand zweier Elemente samt den nächsten Punkten liefert ModelDoc2.ClosestDistance, den Flächeninhalt einer Fläche Face2.GetArea.
Eigenschaften und Methoden
Eigenschaften 30, davon 30 beschrieben
| Name | Beschreibung |
|---|---|
| Angle | Liefert den Winkel zwischen den beiden gemessenen Elementen. |
| AngleDecimalPlaces | Liest oder setzt die Zahl der Nachkommastellen für Winkelmessungen. |
| ArcLength | Liefert die Bogenlänge des gemessenen Bogens. |
| ArcOption | Liest oder setzt, wie das Messwerkzeug Abstände bei Bögen und Kreisen misst: vom Mittelpunkt, als kleinsten oder als größten Abstand. |
| Area | Liefert den Flächeninhalt des gemessenen Elements. |
| CenterDistance | Liefert den Mittenabstand der gemessenen Elemente: zwischen Zylinderachsen, Kreismittelpunkten oder beidem. |
| ChordLength | Liefert die Sehnenlänge des gemessenen Bogens. |
| DeltaX | Liefert den Abstand der gemessenen Elemente in x-Richtung. |
| DeltaY | Liefert den Abstand der gemessenen Elemente in y-Richtung. |
| DeltaZ | Liefert den Abstand der gemessenen Elemente in z-Richtung. |
| Diameter | Liefert den Durchmesser des gemessenen Kreises oder Zylinders. |
| Distance | Liefert den Abstand zwischen den gemessenen Elementen. |
| IsConcentricSpheres | Liefert, ob die beiden gemessenen Elemente konzentrische Kugeln sind. |
| IsIntersect | Liefert, ob sich die beiden gemessenen Elemente schneiden. |
| IsParallel | Liefert, ob die beiden gemessenen Elemente parallel sind. |
| IsPerpendicular | Liefert, ob die beiden gemessenen Elemente senkrecht aufeinander stehen. |
| Length | Liefert die Länge des gemessenen Elements, etwa einer Kante. |
| LengthDecimalPlaces | Liest oder setzt die Zahl der Nachkommastellen für Längenmessungen. |
| Normal | Liefert den Normalabstand zwischen der gemessenen Fläche und Ebene, also den Abstand senkrecht zur Ebene. |
| NormalDistance | Liefert den Normalabstand zwischen dem gemessenen Element und einer Ebene, also den Abstand senkrecht zur Ebene. |
| Perimeter | Liefert den Umfang des gemessenen Elements, etwa einer Fläche. |
| Projection | Liefert den projizierten Abstand zwischen den beiden gemessenen Elementen. |
| ProjectionOption | Liest oder setzt, ob das Messwerkzeug den Abstand der Elemente projiziert: gar nicht, auf den Bildschirm oder auf eine Fläche oder Ebene. |
| Radius | Liefert den Radius des gemessenen Bogens oder Zylinders. |
| SpericalCenterDistance | Liefert den Abstand zwischen den beiden gemessenen Kugelflächen. |
| TotalArea | Liefert die gesamte Fläche der beiden gemessenen Elemente. |
| TotalLength | Liefert die gesamte Länge der beiden gemessenen Elemente. |
| X | Liefert die x-Koordinate des gemessenen Punkts im Modellraum. |
| Y | Liefert die y-Koordinate des gemessenen Punkts im Modellraum. |
| Z | Liefert die z-Koordinate des gemessenen Punkts im Modellraum. |
Methoden 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| Calculate | Misst die ausgewählten oder die übergebenen Elemente. |
| SetProjectionEntity | Legt die Fläche oder Ebene fest, auf die das Messwerkzeug den gemessenen Abstand projiziert. |
Siehe auch
Englisches Original: IMeasure in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.