SolidWorksMakroprogrammierung

Methode · PropertyManagerPageNumberbox

SetRange2-Methode (PropertyManagerPageNumberbox)

Legt fest, welche Art von Zahl ein Zahlenfeld auf einer PropertyManager-Seite zeigt, dazu Grenzen und Schrittweiten.

Syntax

Sub SetRange2( _
   ByVal Units As Long, _
   ByVal Minimum As Double, _
   ByVal Maximum As Double, _
   ByVal Inclusive As Boolean, _
   ByVal Increment As Double, _
   ByVal FastIncr As Double, _
   ByVal SlowIncr As Double _
)
swZahl.SetRange2 swNumberBox_Length, 0.001, 0.1, True, 0.001, 0.01, 0.0005

Parameter

UnitsLongByVal
Art der Zahl, ein Wert aus swNumberboxUnitType_e, etwa swNumberBox_Length
MinimumDoubleByVal
Kleinster Wert, in Systemeinheiten
MaximumDoubleByVal
Größter Wert, in Systemeinheiten
InclusiveBooleanByVal
True: Minimum und Maximum gehören zum Bereich. False: sie gehören nicht dazu.
IncrementDoubleByVal
Schrittweite der Pfeile
FastIncrDoubleByVal
Schnelle Schrittweite für Bildlauf und Mausrad
SlowIncrDoubleByVal
Langsame Schrittweite für Bildlauf und Mausrad

Beispiel

' swZahl ist ein Zahlenfeld (PropertyManagerPageNumberbox), angelegt mit AddControl2 und swControlType_Numberbox.
' Grenzen und Schritte in Metern: 1 bis 100 mm, Schritt 1 mm, schnell 10 mm, langsam 0,5 mm
swZahl.SetRange2 swNumberBox_Length, 0.001, 0.1, True, 0.001, 0.01, 0.0005
swZahl.Value = 0.01

Bemerkungen

Die Grenzen stehen wie PropertyManagerPageNumberbox.Value in Systemeinheiten, also Meter bei Längen und Bogenmaß bei Winkeln. Für die Schrittweiten gilt das vermutlich auch, die Hilfe sagt es nicht ausdrücklich. Die Hilfe beschreibt die Methode als Bereich und Schrittweite „für den Schieberegler“, sie gilt aber für jedes Zahlenfeld.

Die Methode geht auch, während die Seite angezeigt wird, mit zwei Einschränkungen: Units kannst du dann nicht mehr ändern, der Parameter wird ignoriert. Und wird der aktuelle Wert durch den neuen Bereich ungültig, setzt du sofort mit Value einen gültigen Wert, sonst fordert ein Dialog den Benutzer dazu auf.

Das Hilfebeispiel „Create PropertyManager Page With Many Controls“ ruft SetRange2 swNumberBox_Length, -0.01, 0.01, True, 0.00001, 0.0001, 0.00005 auf. SetRange2 ersetzt das veraltete SetRange.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2008

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

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