SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageControl-Objekt

Die gemeinsamen Eigenschaften und Methoden aller Steuerelemente auf einer PropertyManager-Seite: Sichtbarkeit, Aktivierung, QuickInfo, Lage und Größe, Farben, Bild vor dem Steuerelement.

Deklaration Dim x As SldWorks.PropertyManagerPageControl · in der englischen .NET-Hilfe: IPropertyManagerPageControl

Beschreibung

PropertyManagerPageControl bietet Methoden und Eigenschaften, die alle Steuerelemente einer PropertyManager-Seite gemeinsam haben. Eine PropertyManager-Seite ist eine eigene Seite deines Makros oder Add-ins im PropertyManager, die aussieht wie die Seiten von SOLIDWORKS selbst. Du legst sie mit SldWorks.CreatePropertyManagerPage an, setzt mit AddGroupBox Gruppenfelder darauf und mit AddControl2 Steuerelemente in die Gruppenfelder.

Jedes Steuerelement ist zugleich ein PropertyManagerPageControl. AddControl2 liefert ein Objekt des Typs, den du mit swPropertyManagerPageControlType_e bestellst, etwa ein Kontrollkästchen (PropertyManagerPageCheckbox) oder eine Schaltfläche (PropertyManagerPageButton). Dieses Objekt hat nur die Befehle seiner Art. Weist du es mit Set einer Variablen vom Typ PropertyManagerPageControl zu, erreichst du die Befehle hier. Das gilt für ActiveX-Steuerelemente, Bilder, Schaltflächen, Schaltflächen mit Bild, Kontrollkästchen, Kombinationsfelder, Beschriftungen, Listenfelder, Zahlenfelder, Optionsfelder, Auswahlfelder, Schieberegler, Register, Textfelder und .NET-Steuerelemente. Gruppenfelder (PropertyManagerPageGroup) gehören nicht dazu.

Die Befehle gibt es seit SOLIDWORKS 2001Plus, die neuesten seit 2010.

Zugriff

Beispiel

' Ausschnitt aus dem Aufbau einer PropertyManager-Seite im Klassenmodul des Handlers.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
'               die mit SldWorks.CreatePropertyManagerPage angelegt und noch nicht angezeigt ist.
'               Die Klasse implementiert PropertyManagerPage2Handler9 (Implements).
' Ergebnis:     Das Kontrollkästchen hat ein Bild und eine QuickInfo. Wählt der Benutzer
'               es an, erscheint eine Sprechblase mit einem Hinweis.
Const ID_KANTEN As Long = 2

Dim swGruppe As SldWorks.PropertyManagerPageGroup
Dim swKontroll As SldWorks.PropertyManagerPageCheckbox
Dim swSteuer As SldWorks.PropertyManagerPageControl

Private Sub SteuerelementAnlegen()
    Set swKontroll = swGruppe.AddControl2(ID_KANTEN, swControlType_Checkbox, "Kanten verrunden", _
                                          swControlAlign_Indent, _
                                          swControlOptions_Visible + swControlOptions_Enabled, "")
    If swKontroll Is Nothing Then Exit Sub

    Set swSteuer = swKontroll                      ' dasselbe Steuerelement als PropertyManagerPageControl
    swSteuer.Tip = "Alle Kanten des Körpers verrunden"
    swSteuer.SetStandardPictureLabel swBitmapLabel_SelectEdge
    swSteuer.OptionsForResize = swControlOptionsOnResize_LockLeft + swControlOptionsOnResize_LockRight
End Sub

Private Sub PropertyManagerPage2Handler9_OnCheckboxCheck(ByVal Id As Long, ByVal Checked As Boolean)
    If Id = ID_KANTEN And Checked Then
        swSteuer.ShowBubbleTooltip "Hinweis", "Das kann bei großen Teilen dauern.", ""
        Debug.Print "Gruppenfeld: " & swSteuer.GetGroupBox.Caption
    End If
End Sub

Bemerkungen

Wann was geht: Nach PropertyManagerPage2 hat eine Seite zwei Zustände. Solange sie nicht angezeigt wird, gibt es nur die API-Objekte, und sie halten die Vorgaben, die du setzt. Wird sie angezeigt, stehen die Objekte für die Steuerelemente im Fenster, und ihre Werte sind die aktuellen Einstellungen. Lage und Breite (PropertyManagerPageControl.Left, PropertyManagerPageControl.Width) setzt du vor dem Anzeigen. Die Bilder setzt du vorher, währenddessen oder nach dem Schließen.

Seite oder Steuerelement: Bei PropertyManagerPageControl.Enabled und PropertyManagerPageControl.Visible spricht die Hilfe vom Zustand der „PropertyManager page“. Gemeint ist dem Zusammenhang nach das Steuerelement, an dem du die Eigenschaft aufrufst.

Einheiten: Lage und Breite sind Dialogeinheiten bezogen auf das Gruppenfeld, das 100 Einheiten breit ist. Farben sind RGB-Werte, wie sie die VBA-Funktion RGB liefert.

Hilfebeispiele: Das Beispiel „Show Bubble ToolTip for PropertyManager Page Control“ weist ein Kontrollkästchen direkt einer Variablen vom Typ PropertyManagerPageControl zu und ruft dort PropertyManagerPageControl.ShowBubbleTooltip auf. Das Beispiel „Create PropertyManager Page With Many Controls“ geht den umgekehrten Weg: Es nimmt jedes neue Steuerelement erst als PropertyManagerPageControl entgegen und weist es dann einer Variablen des speziellen Typs zu. Mehr zum Aufbau steht in „Using PropertyManagerPage2 and the Related Objects“ im Programmierhandbuch.

Eigenschaften und Methoden

Eigenschaften 9, davon 9 beschrieben

NameBeschreibung
BackgroundColorLiest oder setzt die Hintergrundfarbe eines Steuerelements auf einer PropertyManager-Seite, bei Textfeld, Listenfeld und Beschriftung.
EnabledLiest oder setzt, ob ein Steuerelement auf einer PropertyManager-Seite bedienbar ist oder ausgegraut.
LeftLiest oder setzt den linken Rand eines Steuerelements in Dialogeinheiten, bezogen auf sein Gruppenfeld.
OptionsForResizeLiest oder setzt, wie sich ein Steuerelement verhält, wenn der Benutzer die PropertyManager-Seite breiter oder schmaler zieht.
TextColorLiest oder setzt die Textfarbe einer Beschriftung auf einer PropertyManager-Seite.
TipLiest oder setzt die QuickInfo eines Steuerelements auf einer PropertyManager-Seite.
TopLiest oder setzt den oberen Rand eines Steuerelements auf einer PropertyManager-Seite.
VisibleLiest oder setzt, ob ein Steuerelement auf einer PropertyManager-Seite sichtbar ist.
WidthLiest oder setzt die Breite eines Steuerelements in Dialogeinheiten, bezogen auf sein Gruppenfeld.

Methoden 4, davon 4 beschrieben

NameBeschreibung
GetGroupBoxLiefert das Gruppenfeld, in dem das Steuerelement steht.
SetPictureLabelByNameSetzt ein Bild aus einer Datei links vor ein Steuerelement auf einer PropertyManager-Seite.
SetStandardPictureLabelSetzt eines der Standardbilder von SOLIDWORKS links vor ein Steuerelement, etwa das Symbol für Kante oder Fläche.
ShowBubbleTooltipZeigt an einem Steuerelement eine Sprechblase mit Titel, Text und Bild, etwa als Hinweis auf eine falsche Eingabe.

Siehe auch

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

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