SolidWorksMakroprogrammierung

Methode · EnumDisplayDimensions

Next-Methode (EnumDisplayDimensions)

Holt die nächste Bemaßung aus der Aufzählung.

Syntax

Function Next( _
   ByVal Celt As Long, _
   ByRef Rgelt As DisplayDimension, _
   ByRef PceltFetched As Long _
) As HResult
swEnum.Next 1, swDispDim, nGeholt

Parameter

CeltLongByVal
Wie viele Bemaßungen Next holen soll. In VBA vermutlich immer 1, weil Rgelt nur ein einzelnes Objekt aufnimmt.
RgeltDisplayDimensionByRef · Rückgabe
Gibt die geholte Bemaßung zurück (DisplayDimension). Das ist ein Array mit Celt Elementen, in VBA eine einzelne Variable.
PceltFetchedLongByRef · Rückgabe
Gibt zurück, wie viele Bemaßungen Next geholt hat. Der Wert ist kleiner als Celt, wenn weniger Bemaßungen ü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 Bemaßungen (EnumDisplayDimensions), etwa aus Feature.EnumDisplayDimensions.
Dim swDispDim As SldWorks.DisplayDimension
Dim nGeholt As Long, n As Long
Do
    Set swDispDim = Nothing
    swEnum.Next 1, swDispDim, nGeholt
    If swDispDim Is Nothing Then Exit Do
    n = n + 1
    Debug.Print n & ": " & swDispDim.GetNameForSelection
Loop

Bemerkungen

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 EnumDisplayDimensions.Reset fängst du wieder von vorn an.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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