Objekt · SldWorks
PropertyManagerPageNumberbox-Objekt
Ein Zahlenfeld auf einer PropertyManager-Seite: Wert, Bereich und Schrittweite, Einheit, Stil und eine angehängte Dropdown-Liste.
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
PropertyManagerPageGroup.AddControl2mitswControlType_NumberboxausswPropertyManagerPageControlType_e: legt ein Zahlenfeld in einem Gruppenfeld anPropertyManagerPage2.AddControl2undPropertyManagerPageTab.AddControl2: dasselbe auf der Seite oder in einer Registerkarte
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
| Name | Beschreibung |
|---|---|
| CurrentSelection | Liest oder setzt den gewählten Eintrag in der angehängten Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite. |
| DisplayedUnit | Liest oder setzt die Einheit, in der ein Zahlenfeld auf einer PropertyManager-Seite seinen Wert zeigt, etwa Millimeter statt Meter. |
| Height | Liest oder setzt die größte Höhe der angehängten Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite. |
| ItemText | Liefert den Text eines Eintrags in der angehängten Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite. |
| Style | Liest oder setzt den Stil eines Zahlenfelds auf einer PropertyManager-Seite: Dropdown-Liste, nur Auswahl, ohne Pfeile, Schieberegler oder Daumenrad. |
| Text | Liefert den Text, der in einem Zahlenfeld auf einer PropertyManager-Seite steht, etwa mit Einheit. |
| Value | Liest oder setzt den Wert in einem Zahlenfeld auf einer PropertyManager-Seite, in Systemeinheiten. |
Methoden 7, davon 6 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AddItems | Hängt Einträge an die Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite an. |
| Clear | Löscht alle Einträge aus der Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite. |
| DeleteItem | Löscht einen Eintrag aus der Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite. |
| InsertItem | Fügt einen Eintrag an einer bestimmten Stelle in die Dropdown-Liste eines Zahlenfelds auf einer PropertyManager-Seite ein. |
| SetRange | veraltet ersetzt durch PropertyManagerPageNumberbox.SetRange2 |
| SetRange2 | Legt fest, welche Art von Zahl ein Zahlenfeld auf einer PropertyManager-Seite zeigt, dazu Grenzen und Schrittweiten. |
| SetSliderParameters | Legt 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.