SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageTextbox-Objekt

Ein Textfeld auf einer PropertyManager-Seite: der Text, die Höhe und der Stil, etwa mehrzeilig oder schreibgeschützt.

Deklaration Dim x As SldWorks.PropertyManagerPageTextbox · in der englischen .NET-Hilfe: IPropertyManagerPageTextbox

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

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.Text

Bemerkungen

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

NameBeschreibung
HeightLiest oder setzt die Höhe eines Textfelds auf einer PropertyManager-Seite.
StyleLiest oder setzt den Stil eines Textfelds auf einer PropertyManager-Seite: mehrzeilig, ohne Rahmen, schreibgeschützt oder Meldung erst beim Verlassen.
TextLiest 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.