Methode · EnumFaces2
Next-Methode (EnumFaces2)
Holt die nächste Fläche aus der Aufzählung.
Syntax
Function Next( _
ByVal Celt As Long, _
ByRef Rgelt As Face2, _
ByRef PceltFetched As Long _
) As HResultswEnum.Next 1, swFace, nGeholtParameter
CeltLongByVal- Wie viele Flächen Next holen soll. In VBA vermutlich immer 1, weil Rgelt nur ein einzelnes Objekt aufnimmt.
RgeltFace2ByRef · Rückgabe- Gibt die geholte Fläche zurück (
Face2). Das ist ein Array mit Celt Elementen, in VBA eine einzelne Variable. PceltFetchedLongByRef · Rückgabe- Gibt zurück, wie viele Flächen Next geholt hat. Der Wert ist kleiner als Celt, wenn weniger Flächen übrig sind, oder NULL, wenn keine mehr da sind.
Rückgabewert
Ein HResult. Was der Wert bedeutet, sagt die Hilfe nicht. In VBA rufst du den Befehl ohne Klammern auf und lässt den Wert weg.
Beispiel
' swEnum ist eine Aufzählung der Flächen (EnumFaces2), etwa aus Body2.EnumFaces.
Dim swFace As SldWorks.Face2
Dim nGeholt As Long, n As Long
Do
Set swFace = Nothing
swEnum.Next 1, swFace, nGeholt
If swFace Is Nothing Then Exit Do
n = n + 1
Debug.Print n & ": " & Format(swFace.GetArea * 1000000, "0.00") & " mm²"
LoopBemerkungen
Nur für In-Process-DLLs gedacht.
Welchen Wert PceltFetched am Ende der Aufzählung in VBA hat, sagt die Hilfe nicht. Das Beispiel setzt deshalb die Variable vor jedem Aufruf auf Nothing und hört auf, wenn sie Nothing bleibt. Mit EnumFaces2.Reset fängst du wieder von vorn an.
Das Hilfebeispiel „Enumerate Bodies (C++)“ holt die Flächen eines Körpers ebenfalls mit Next und 1, allerdings noch mit den alten Aufzählungen.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2001Plus
Englisches Original: IEnumFaces2::Next in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.