SolidWorksMakroprogrammierung

Methode · View

GetVisibleEntities2-Methode (View)

Liefert die Kanten, Flächen, Ecken oder Silhouettenkanten einer Komponente, die in einer Zeichenansicht sichtbar sind.

Syntax

Function GetVisibleEntities2( _
   ByVal LpViewComponent As Component2, _
   ByVal EntityType As Long _
) As Variant
vKanten = swView.GetVisibleEntities2(swComp, swViewEntityType_Edge)

Parameter

LpViewComponentComponent2ByVal
Die Komponente, deren sichtbare Elemente du willst, etwa aus View.GetVisibleComponents oder über View.GetVisibleDrawingComponents und DrawingComponent.Component. Was du in der Ansicht eines Teils übergibst, sagt die Hilfe nicht.
EntityTypeLongByVal

Die Art der Elemente, ein Wert aus swViewEntityType_e:

  • swViewEntityType_Edge (1): Kanten
  • swViewEntityType_Vertex (2): Ecken
  • swViewEntityType_Face (3): Flächen
  • swViewEntityType_SilhouetteEdge (4): Silhouettenkanten

Rückgabewert

Array mit den sichtbaren Elementen der gewählten Art in dieser Komponente. Kanten, Ecken und Flächen kannst du einer Variablen vom Typ Edge, Vertex oder Face2 zuweisen, zum Auswählen auch Entity. Silhouettenkanten kommen als SilhouetteEdge zurück. Was zurückkommt, wenn es keine sichtbaren Elemente gibt, sagt die Hilfe nicht. Prüf das Ergebnis deshalb mit IsArray.

Beispiel

' swView ist eine Zeichenansicht (View) einer Baugruppe, etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim swComp As SldWorks.Component2
Dim swEdge As SldWorks.Edge
Dim swCurve As SldWorks.Curve
Dim vKomponenten As Variant, vKanten As Variant, vKreis As Variant
Dim i As Long, j As Long
vKomponenten = swView.GetVisibleComponents
If IsArray(vKomponenten) Then
    For i = 0 To UBound(vKomponenten)
        Set swComp = vKomponenten(i)
        vKanten = swView.GetVisibleEntities2(swComp, swViewEntityType_Edge)
        If IsArray(vKanten) Then
            For j = 0 To UBound(vKanten)
                Set swEdge = vKanten(j)
                Set swCurve = swEdge.GetCurve
                If swCurve.IsCircle Then
                    vKreis = swCurve.CircleParams
                    Debug.Print swComp.Name2 & ": Kreis oder Bogen, Radius " & Format(vKreis(6) * 1000, "0.00") & " mm"
                End If
            Next j
        End If
    Next i
End If

Bemerkungen

Sichtbar ist ein Element, solange andere Elemente es in der Ansicht nicht vollständig verdecken. Eine teilweise verdeckte Kante gehört also dazu.

Ersetzt View.GetVisibleEntities. Neu ist, dass jetzt auch Silhouettenkanten (swViewEntityType_SilhouetteEdge) unterstützt werden. Silhouettenkanten sind keine Kanten des Modells, sondern die Umrisslinien gekrümmter Flächen in der Zeichnung, etwa die seitlichen Linien eines Zylinders.

Die Anzahl vorab liefert View.GetVisibleEntityCount2. Willst du die Elemente auf dem Blatt auswählen, übergib an Entity.Select4 ein SelectData, dessen SelectData.View auf diese Ansicht zeigt. Silhouettenkanten wählst du mit SilhouetteEdge.Select2 aus.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2014

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

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