SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageLabel-Objekt

Eine Beschriftung auf einer PropertyManager-Seite: Text, Ausrichtung, Höhe und die Formatierung einzelner Zeichen (fett, kursiv, unterstrichen, Schrift, Farbe, Größe, hoch- und tiefgestellt).

Deklaration Dim x As SldWorks.PropertyManagerPageLabel · in der englischen .NET-Hilfe: IPropertyManagerPageLabel

Beschreibung

PropertyManagerPageLabel gibt Zugriff auf eine Beschriftung auf einer PropertyManager-Seite. Eine Beschriftung ist fester Text ohne Eingabe, etwa eine Erklärung über einem Eingabefeld. Du legst sie mit AddControl2 und swControlType_Label aus swPropertyManagerPageControlType_e an. Wie jedes Steuerelement ist sie zugleich ein PropertyManagerPageControl, darüber setzt du etwa die Farben der ganzen Beschriftung.

Die meisten Eigenschaften formatieren einen Bereich von Zeichen. Den Bereich gibst du mit StartChar und EndChar an, beide nullbasiert. So stellst du etwa einzelne Zeichen hoch oder tief, wie in einer Formel.

Die Befehle gibt es seit SOLIDWORKS 2001Plus SP02, die Zeichenformate seit 2008.

Zugriff

Beispiel

' Ausschnitt aus dem Aufbau einer PropertyManager-Seite im Klassenmodul des Handlers.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
'               die noch nicht angezeigt wird.
' Ergebnis:     Die Beschriftung zeigt „Fläche A = r² · π“ mittig, „Fläche“ fett und
'               die 2 hochgestellt.
Const ID_FORMEL As Long = 70

Dim swGruppe As SldWorks.PropertyManagerPageGroup
Dim swLabel As SldWorks.PropertyManagerPageLabel

Private Sub BeschriftungAnlegen()
    Set swLabel = swGruppe.AddControl2(ID_FORMEL, swControlType_Label, "Fläche A = r2 · π", _
                                       swControlAlign_LeftEdge, _
                                       swControlOptions_Visible + swControlOptions_Enabled, "")
    If swLabel Is Nothing Then Exit Sub

    swLabel.Style = swPropMgrPageLabelStyle_CenterText    ' nur vor dem Anzeigen
    swLabel.Bold(0, 5) = True                             ' Zeichen 0 bis 5: "Fläche"
    swLabel.LineOffset(12, 12) = 0.5                      ' die 2 nach dem r hochstellen
    swLabel.SizeRatio(12, 12) = -0.3                      ' und etwas kleiner
End Sub

Bemerkungen

Zeichenbereich: StartChar und EndChar sind nullbasiert. Ob EndChar noch zum Bereich gehört, sagt die Hilfe nicht. Das Beispiel nimmt es an. Was beim Ändern von PropertyManagerPageLabel.Caption mit den Formaten geschieht, sagt die Hilfe auch nicht.

Wann was geht: PropertyManagerPageLabel.Style und PropertyManagerPageLabel.Height setzt du nur, bevor die Seite angezeigt wird. Für die übrigen Eigenschaften nennt die Hilfe keine Einschränkung.

Als Meldungsfeld: Du kannst ein Gruppenfeld mit nur einer Beschriftung wie ein Meldungsfeld aussehen lassen. Gruppenfeld und Beschriftung bekommen dieselbe Hintergrundfarbe, der Text eine andere, siehe PropertyManagerPageGroup.BackgroundColor.

Ungenau: Die Werte für PropertyManagerPageLabel.LineOffset und PropertyManagerPageLabel.SizeRatio beschreibt die Hilfe nur grob. Die Werte im Beispiel sind deshalb geschätzt.

Zeichen außerhalb des Zeichensatzes Windows-1252 wie π lassen sich im VBA-Editor nicht speichern. Auf der Seite erscheinen sie dann als „?“.

Eigenschaften und Methoden

Eigenschaften 11, davon 11 beschrieben

NameBeschreibung
BoldLiest oder setzt, ob ein Bereich von Zeichen der Beschriftung fett ist.
CaptionLiest oder setzt den Text einer Beschriftung auf einer PropertyManager-Seite.
CharacterBackgroundColorLiest oder setzt die Hintergrundfarbe eines Bereichs von Zeichen der Beschriftung.
CharacterColorLiest oder setzt die Farbe eines Bereichs von Zeichen der Beschriftung.
FontLiest oder setzt die Schriftart eines Bereichs von Zeichen der Beschriftung.
HeightLiest oder setzt die Höhe einer Beschriftung in Dialogeinheiten.
ItalicLiest oder setzt, ob ein Bereich von Zeichen der Beschriftung kursiv ist.
LineOffsetLiest oder setzt, wie weit ein Bereich von Zeichen der Beschriftung über oder unter der Grundlinie steht, etwa für Exponenten und Indizes.
SizeRatioLiest oder setzt die Größe eines Bereichs von Zeichen der Beschriftung im Verhältnis zur normalen Größe.
StyleLiest oder setzt die Ausrichtung und den Rahmen einer Beschriftung: links, mittig, rechts, vertieft.
UnderlineLiest oder setzt, wie ein Bereich von Zeichen der Beschriftung unterstrichen ist: nicht, durchgezogen oder gestrichelt.

Siehe auch

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

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