SolidWorksMakroprogrammierung

Methode · MidSurface3

GetFirstFaceArray-Methode (MidSurface3)

Liefert die erste Fläche der Mittelfläche zusammen mit den Flächen des Körpers als Array und die Dicke.

Syntax

Function GetFirstFaceArray( _
   ByRef Thickness As Double _
) As Variant
vDaten = swMitte.GetFirstFaceArray(dDicke)

Parameter

ThicknessDoubleByRef · Rückgabe
Rückgabe: die Dicke zwischen den Flächen. Die Einheit nennt die Hilfe hier nicht; es ist Meter wie bei MidSurface3.GetFirstFace.

Rückgabewert

Array: die Fläche der Mittelfläche, die vorderen Flächen des Körpers, ein leerer Eintrag als Trenner und die hinteren Flächen (siehe Bemerkungen).

Beispiel

' swMitte ist eine Mittelfläche (MidSurface3), etwa aus Feature.GetSpecificFeature2.
Dim vDaten As Variant
Dim dDicke As Double
Dim bFlaeche As Boolean, bHinten As Boolean
Dim nVorne As Long, nHinten As Long
Dim i As Long
vDaten = swMitte.GetFirstFaceArray(dDicke)
If IsArray(vDaten) Then
    For i = 1 To UBound(vDaten)                  ' Eintrag 0 ist die Fläche der Mittelfläche
        bFlaeche = False
        If IsObject(vDaten(i)) Then bFlaeche = Not vDaten(i) Is Nothing
        If False = bFlaeche Then
            bHinten = True                       ' Trenner zwischen Vorder- und Rückflächen
        ElseIf bHinten Then
            nHinten = nHinten + 1
        Else
            nVorne = nVorne + 1
        End If
    Next i
    Debug.Print "Dicke " & Round(dDicke * 1000, 3) & " mm, " & nVorne & " vorne, " & nHinten & " hinten"
End If

Bemerkungen

Zwischen den vorderen und den hinteren Flächen steht immer ein leerer Eintrag (NULL) als Trenner. Die Hilfe beschreibt den Aufbau so:

  • bei einer vorderen Fläche: neutrale Fläche, vordere Fläche, NULL, hintere Fläche
  • bei mehreren vorderen Flächen: neutrale Fläche, vordere Flächen 1 und 2, NULL, hintere Flächen 1 und 2

Die neutrale Fläche ist die Fläche der Mittelfläche. Ob mehrere vordere Flächen einzeln im Array stehen oder als eigenes Teil-Array, sagt die Hilfe nicht eindeutig. Das Beispiel geht von einzelnen Einträgen aus.

Für alle Flächen rufst du GetFirstFaceArray einmal auf und dann MidSurface3.GetNextFaceArray für jede weitere Fläche, bei fünf Flächen also viermal.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2009

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

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