SolidWorksMakroprogrammierung

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.

Deklaration Dim x As SldWorks.Measure · in der englischen .NET-Hilfe: IMeasure

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

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 Sub

Bemerkungen

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

NameBeschreibung
AngleLiefert den Winkel zwischen den beiden gemessenen Elementen.
AngleDecimalPlacesLiest oder setzt die Zahl der Nachkommastellen für Winkelmessungen.
ArcLengthLiefert die Bogenlänge des gemessenen Bogens.
ArcOptionLiest oder setzt, wie das Messwerkzeug Abstände bei Bögen und Kreisen misst: vom Mittelpunkt, als kleinsten oder als größten Abstand.
AreaLiefert den Flächeninhalt des gemessenen Elements.
CenterDistanceLiefert den Mittenabstand der gemessenen Elemente: zwischen Zylinderachsen, Kreismittelpunkten oder beidem.
ChordLengthLiefert die Sehnenlänge des gemessenen Bogens.
DeltaXLiefert den Abstand der gemessenen Elemente in x-Richtung.
DeltaYLiefert den Abstand der gemessenen Elemente in y-Richtung.
DeltaZLiefert den Abstand der gemessenen Elemente in z-Richtung.
DiameterLiefert den Durchmesser des gemessenen Kreises oder Zylinders.
DistanceLiefert den Abstand zwischen den gemessenen Elementen.
IsConcentricSpheresLiefert, ob die beiden gemessenen Elemente konzentrische Kugeln sind.
IsIntersectLiefert, ob sich die beiden gemessenen Elemente schneiden.
IsParallelLiefert, ob die beiden gemessenen Elemente parallel sind.
IsPerpendicularLiefert, ob die beiden gemessenen Elemente senkrecht aufeinander stehen.
LengthLiefert die Länge des gemessenen Elements, etwa einer Kante.
LengthDecimalPlacesLiest oder setzt die Zahl der Nachkommastellen für Längenmessungen.
NormalLiefert den Normalabstand zwischen der gemessenen Fläche und Ebene, also den Abstand senkrecht zur Ebene.
NormalDistanceLiefert den Normalabstand zwischen dem gemessenen Element und einer Ebene, also den Abstand senkrecht zur Ebene.
PerimeterLiefert den Umfang des gemessenen Elements, etwa einer Fläche.
ProjectionLiefert den projizierten Abstand zwischen den beiden gemessenen Elementen.
ProjectionOptionLiest oder setzt, ob das Messwerkzeug den Abstand der Elemente projiziert: gar nicht, auf den Bildschirm oder auf eine Fläche oder Ebene.
RadiusLiefert den Radius des gemessenen Bogens oder Zylinders.
SpericalCenterDistanceLiefert den Abstand zwischen den beiden gemessenen Kugelflächen.
TotalAreaLiefert die gesamte Fläche der beiden gemessenen Elemente.
TotalLengthLiefert die gesamte Länge der beiden gemessenen Elemente.
XLiefert die x-Koordinate des gemessenen Punkts im Modellraum.
YLiefert die y-Koordinate des gemessenen Punkts im Modellraum.
ZLiefert die z-Koordinate des gemessenen Punkts im Modellraum.

Methoden 2, davon 2 beschrieben

NameBeschreibung
CalculateMisst die ausgewählten oder die übergebenen Elemente.
SetProjectionEntityLegt 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.