SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageNumberbox-Objekt

Ein Zahlenfeld auf einer PropertyManager-Seite: Wert, Bereich und Schrittweite, Einheit, Stil und eine angehängte Dropdown-Liste.

Deklaration Dim x As SldWorks.PropertyManagerPageNumberbox · in der englischen .NET-Hilfe: IPropertyManagerPageNumberbox

Beschreibung

PropertyManagerPageNumberbox gibt Zugriff auf ein Zahlenfeld auf einer PropertyManager-Seite. Jedes Steuerelement ist zugleich ein PropertyManagerPageControl. Sichtbarkeit, Aktivierung und QuickInfo steuerst du dort, etwa mit PropertyManagerPageControl.Enabled, PropertyManagerPageControl.Visible und PropertyManagerPageControl.Tip. Ändert sich der Wert, meldet die Seite das über OnNumberboxChanged an ihren Handler. Value gibt es seit SOLIDWORKS 2001Plus, die meisten übrigen Befehle seit 2007 oder 2008.

Die Hilfe unterscheidet zwei Arten:

  • Drehfeld: ein Eingabefeld mit Pfeilen nach oben und unten, die den Wert erhöhen und verringern
  • Kombinationsfeld mit Drehfeld: zusätzlich ein Pfeil nach unten für eine angehängte Dropdown-Liste, die du selbst füllst. Die Art wählst du mit PropertyManagerPageNumberbox.Style.

Zugriff

Beispiel

' Ausschnitt aus dem Aufbau einer PropertyManager-Seite: legt ein Zahlenfeld für eine Länge
' von 1 bis 100 mm an, das den Wert in Millimetern zeigt.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
'               die mit SldWorks.CreatePropertyManagerPage angelegt und noch nicht angezeigt ist.
'               Die Seite hat einen Handler, der OnNumberboxChanged mit der ID 7 auswertet.
' Ergebnis:     Das Zahlenfeld erscheint mit 10 mm, sobald die Seite angezeigt wird.
Dim swZahl As SldWorks.PropertyManagerPageNumberbox
Dim nOptionen As Long

nOptionen = swControlOptions_Visible + swControlOptions_Enabled
Set swZahl = swGruppe.AddControl2(7, swControlType_Numberbox, "Tiefe", _
                                  swControlAlign_Indent, nOptionen, "Tiefe der Bohrung")
If swZahl Is Nothing Then
    Debug.Print "Zahlenfeld nicht angelegt"
Else
    ' 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.DisplayedUnit = swMM
    swZahl.Value = 0.01
End If

' Später, solange die Seite angezeigt wird:
Debug.Print "Tiefe: " & swZahl.Value * 1000 & " mm (Anzeige: " & swZahl.Text & ")"

Bemerkungen

Einheiten: Alle Zahlenfelder speichern ihre Werte in Metern oder Bogenmaß und zeigen sie in den Einheiten der aktuellen Einstellungen. PropertyManagerPageNumberbox.Value und die Grenzen in PropertyManagerPageNumberbox.SetRange2 stehen immer in Systemeinheiten. Mit PropertyManagerPageNumberbox.DisplayedUnit wählst du nur die Anzeige.

Prüfen und Ausdrücke: SOLIDWORKS prüft Werte und Einheiten selbst, die Pfeile erhöhen und verringern den Wert selbst. Der Benutzer kann auch Rechenausdrücke eingeben.

Genauigkeit: Die Zahl der Nachkommastellen richtet sich bei einem nicht metrischen Einheitensystem des Dokuments nach der Zahl der eingegebenen Stellen, nicht nach der Genauigkeit für Bemaßungen im Dokument.

Werte lesen: Die Steuerelemente halten nur Vorgabewerte, solange die Seite nicht angezeigt wird (Programmierhandbuch, „Using PropertyManagerPage2 and the Related Objects“). Ist sie sichtbar, liefern sie die aktuelle Einstellung, nach dem Schließen nicht mehr.

Veralteter Befehl: SetRange ist veraltet, Nachfolger ist PropertyManagerPageNumberbox.SetRange2. Das Hilfebeispiel „Cut Body in Half Using Macro Feature“ nimmt noch SetRange.

Gemeinsame Befehle: Für Befehle aus PropertyManagerPageControl weist du das Zahlenfeld einer Variablen dieses Typs zu. Die Hilfebeispiele holen Steuerelemente erst als PropertyManagerPageControl und weisen sie dann mit Set der Variablen des speziellen Typs zu.

Hilfebeispiel: „Create PropertyManager Page With Many Controls“ legt ein Zahlenfeld für eine Länge von -10 bis 10 mm mit Daumenrad an (SetRange2, Value und Style). Für die Dropdown-Liste bietet das Zahlenfeld dieselben Befehle wie ein Kombinationsfeld (PropertyManagerPageCombobox).

Solange die Seite noch nicht angezeigt wird, liefert PropertyManagerPageNumberbox.Text einen leeren Text, PropertyManagerPageNumberbox.Value dagegen schon den gesetzten Wert.

Eigenschaften und Methoden

Eigenschaften 7, davon 7 beschrieben

NameBeschreibung
CurrentSelectionLiest oder setzt den gewählten Eintrag in der angehängten Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite.
DisplayedUnitLiest oder setzt die Einheit, in der ein Zahlenfeld auf einer PropertyManager-Seite seinen Wert zeigt, etwa Millimeter statt Meter.
HeightLiest oder setzt die größte Höhe der angehängten Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite.
ItemTextLiefert den Text eines Eintrags in der angehängten Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite.
StyleLiest oder setzt den Stil eines Zahlenfelds auf einer PropertyManager-Seite: Dropdown-Liste, nur Auswahl, ohne Pfeile, Schieberegler oder Daumenrad.
TextLiefert den Text, der in einem Zahlenfeld auf einer PropertyManager-Seite steht, etwa mit Einheit.
ValueLiest oder setzt den Wert in einem Zahlenfeld auf einer PropertyManager-Seite, in Systemeinheiten.

Methoden 7, davon 6 beschrieben, 1 veraltet

NameBeschreibung
AddItemsHängt Einträge an die Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite an.
ClearLöscht alle Einträge aus der Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite.
DeleteItemLöscht einen Eintrag aus der Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite.
InsertItemFügt einen Eintrag an einer bestimmten Stelle in die Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite ein.
SetRangeveraltet ersetzt durch PropertyManagerPageNumberbox.SetRange2
SetRange2Legt fest, welche Art von Zahl ein Zahlenfeld auf einer PropertyManager-Seite zeigt, dazu Grenzen und Schrittweiten.
SetSliderParametersLegt fest, wie fein sich der Schieberegler eines Zahlenfelds auf einer PropertyManager-Seite einstellen lässt und wie viele Teilstriche er hat.

Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IAddItems). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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