SolidWorksMakroprogrammierung

Objekt · SldWorks

MateInPlace-Objekt

Steht für eine InPlace-Verknüpfung, die entsteht, wenn du eine Komponente im Kontext der Baugruppe einfügst.

Deklaration Dim x As SldWorks.MateInPlace · in der englischen .NET-Hilfe: IMateInPlace

Beschreibung

Eine InPlace-Verknüpfung ist eine deckungsgleiche Verknüpfung, die entsteht, wenn du eine Komponente im Kontext der Baugruppe einfügst. Ihre Elemente sind Flächen oder Referenzebenen. MateInPlace liefert die Komponente der Verknüpfung, die Elemente, ihre Art und die Namen der Komponenten dazu. Alle Befehle sind nur lesbar und gibt es seit SOLIDWORKS 2004.

Zugriff

Beispiel

' Gibt Komponente und Elemente der ausgewählten InPlace-Verknüpfung aus.
' Vorbedingung: Eine Baugruppe ist offen, im FeatureManager ist eine InPlace-Verknüpfung ausgewählt.
' Ergebnis:     Komponente, Namen und Art der Elemente stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swSpez As Object
    Dim swInPlace As SldWorks.MateInPlace
    Dim swComp As SldWorks.Component2
    Dim sArt As String
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    Set swSpez = swFeat.GetSpecificFeature2
    If Not TypeOf swSpez Is SldWorks.MateInPlace Then
        Debug.Print swFeat.Name & " ist keine InPlace-Verknüpfung."
        Exit Sub
    End If
    Set swInPlace = swSpez

    Set swComp = swInPlace.Component
    If swComp Is Nothing Then
        Debug.Print swFeat.Name & ": keine Komponente (liegt die Verknüpfung in einer Unterbaugruppe?)"
    Else
        Debug.Print swFeat.Name & ": Komponente " & swComp.Name2
    End If

    For i = 0 To swInPlace.GetMateEntityCount - 1
        Select Case swInPlace.MateEntityType(i)
            Case swSelFACES: sArt = "Fläche"
            Case swSelDATUMPLANES: sArt = "Ebene"
            Case Else: sArt = "Art " & swInPlace.MateEntityType(i)
        End Select
        Debug.Print "  " & i & ": " & swInPlace.MateComponentName(i) & ", " & sArt
    Next i
End Sub

Bemerkungen

Erkennen: Component2.GetMates liefert Mate2- und MateInPlace-Objekte gemischt, die Hilfebeispiele unterscheiden sie mit TypeOf. Die Tabelle bei Feature.GetTypeName2 nennt für den Typnamen MateInPlace als Objekt Mate2. Die Seite von MateInPlace und das Hilfebeispiel „Get Component Names and Types for Inplace Mate“ holen mit Feature.GetSpecificFeature2 dagegen ein MateInPlace. Prüf deshalb mit TypeOf, wie im Beispiel oben.

Unterbaugruppen: MateInPlace.Component liefert Nothing, wenn die InPlace-Verknüpfung in einer Unterbaugruppe liegt.

Entstehung: Das Hilfebeispiel „Insert Join Feature“ legt mit AssemblyDoc.InsertNewPart2 ein neues Teil auf einer ausgewählten Fläche an und gibt danach die InPlace-Verknüpfungen der Komponenten aus. Einen Befehl, der eine InPlace-Verknüpfung gezielt anlegt oder ändert, nennt die Hilfe nicht.

Element oder Name: MateInPlace.MateEntity beschreibt die Hilfe als Namen des Elements, als Wert nennt sie aber eine Fläche oder Referenzebene. Die Eigenschaft ist als Object deklariert, liefert also das Element selbst.

Eigenschaften und Methoden

Eigenschaften 4, davon 4 beschrieben

NameBeschreibung
ComponentLiefert die Komponente der InPlace-Verknüpfung.
MateComponentNameLiefert den Namen der Komponente zu einem Element der InPlace-Verknüpfung.
MateEntityLiefert ein Element der InPlace-Verknüpfung, eine Fläche oder eine Referenzebene.
MateEntityTypeLiefert die Art eines Elements der InPlace-Verknüpfung, etwa Fläche oder Ebene.

Methoden 1, davon 1 beschrieben

NameBeschreibung
GetMateEntityCountLiefert die Zahl der Elemente der InPlace-Verknüpfung.

Siehe auch

Englisches Original: IMateInPlace in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.