SolidWorksMakroprogrammierung

Eigenschaft · MateReference

ReferenceEntity2-Eigenschaft (MateReference)

Liefert ein Element der Verknüpfungsreferenz, als Entity oder als Skizzenpunkt.

Syntax

Property ReferenceEntity2( _
   ByVal Index As Long _
) As Object
Set oElement = swRef.ReferenceEntity2(swMateReference_Primary)

Parameter

IndexLongByVal
Das Element, ein Wert aus swMateReferenceIndex_e: primär (0), sekundär (1) oder tertiär (2).

Wert

Ein Entity oder ein SketchPoint. Welches von beiden, sagt MateReference.ReferenceEntityType. Nur lesbar.

Beispiel

' swRef ist eine Verknüpfungsreferenz (MateReference), etwa aus Feature.GetSpecificFeature2.
Dim oElement As Object
Dim swFlaeche As SldWorks.Face2
Set oElement = swRef.ReferenceEntity2(swMateReference_Primary)
If Not oElement Is Nothing Then
    If swRef.ReferenceEntityType(swMateReference_Primary) = swSelFACES Then
        Set swFlaeche = oElement
        Debug.Print "Primäres Element: Fläche mit " & swFlaeche.GetArea * 1000000 & " mm²"
    End If
End If

Bemerkungen

Rufe vorher MateReference.ReferenceEntityCount auf und danach MateReference.ReferenceEntityType. Dann weist du das Element einer Variablen des passenden Typs zu. So macht es auch das Hilfebeispiel „Get Mate Reference Properties“: Bei swSelFACES weist es das Element einer Variablen vom Typ Face2 zu und gibt den Flächeninhalt aus.

Was die Eigenschaft liefert, wenn es zu dem Index kein Element gibt, sagt die Hilfe nicht. Das Beispiel prüft deshalb auf Nothing.

Die Eigenschaft ersetzt die veraltete MateReference.ReferenceEntity. Diese lieferte nur ein Entity, ReferenceEntity2 liefert auch Skizzenpunkte.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2011

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

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