Objekt · SldWorks
PropertyManagerPageTextbox-Objekt
Ein Textfeld auf einer PropertyManager-Seite: der Text, die Höhe und der Stil, etwa mehrzeilig oder schreibgeschützt.
Beschreibung
PropertyManagerPageTextbox gibt Zugriff auf ein Textfeld 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. Jede Änderung des Texts meldet die Seite über OnTextboxChanged an ihren Handler. Text gibt es seit SOLIDWORKS 2001Plus, Style seit 2007 und Height seit 2008.
Zugriff
PropertyManagerPageGroup.AddControl2mitswControlType_TextboxausswPropertyManagerPageControlType_e: legt ein Textfeld in einem Gruppenfeld anPropertyManagerPage2.AddControl2undPropertyManagerPageTab.AddControl2: dasselbe auf der Seite oder in einer Registerkarte
Beispiel
' Ausschnitt aus dem Aufbau einer PropertyManager-Seite: legt ein Textfeld mit Vorgabetext an.
' 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 OnTextboxChanged mit der ID 2 auswertet.
' Ergebnis: Das Textfeld erscheint mit dem Vorgabetext, sobald die Seite angezeigt wird.
Dim swText As SldWorks.PropertyManagerPageTextbox
Dim nOptionen As Long
nOptionen = swControlOptions_Visible + swControlOptions_Enabled
Set swText = swGruppe.AddControl2(2, swControlType_Textbox, "Bezeichnung", _
swControlAlign_Indent, nOptionen, "Bezeichnung des Bauteils")
If swText Is Nothing Then
Debug.Print "Textfeld nicht angelegt"
Else
swText.Style = swPropMgrPageTextBoxStyle_NotifyOnlyWhenFocusLost
swText.Text = "Halter"
End If
' Später, solange die Seite angezeigt wird, etwa im Handler OnClose:
Debug.Print "Eingabe: " & swText.TextBemerkungen
Werte lesen: Die Steuerelemente halten nur Vorgabewerte, solange die Seite nicht angezeigt wird. Ist sie sichtbar, liefern sie die aktuelle Einstellung, nach dem Schließen nicht mehr. Lies PropertyManagerPageTextbox.Text deshalb, solange die Seite offen ist, etwa im Handler OnTextboxChanged oder OnClose.
Meldungen: Ohne Stil meldet die Seite nach swPropMgrPageTextBoxStyle_e jede Änderung eines Zeichens. Mit swPropMgrPageTextBoxStyle_NotifyOnlyWhenFocusLost kommt die Meldung erst, wenn das Textfeld den Fokus verliert.
Gemeinsame Befehle: Für Befehle aus PropertyManagerPageControl weist du das Textfeld 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: In „Set Focus on PropertyManager Page Control“ setzt die Seite mit PropertyManagerPage2.SetFocus den Fokus auf ein Textfeld, sobald der Benutzer ein Kontrollkästchen anhakt.
Eigenschaften und Methoden
Eigenschaften 3, davon 3 beschrieben
| Name | Beschreibung |
|---|---|
| Height | Liest oder setzt die Höhe eines Textfelds auf einer PropertyManager-Seite. |
| Style | Liest oder setzt den Stil eines Textfelds auf einer PropertyManager-Seite: mehrzeilig, ohne Rahmen, schreibgeschützt oder Meldung erst beim Verlassen. |
| Text | Liest oder setzt den Text in einem Textfeld auf einer PropertyManager-Seite. |
Siehe auch
Englisches Original: IPropertyManagerPageTextbox in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.