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).
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
PropertyManagerPage2.AddControl2,PropertyManagerPageGroup.AddControl2oderPropertyManagerPageTab.AddControl2mitswControlType_Label
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Bold | Liest oder setzt, ob ein Bereich von Zeichen der Beschriftung fett ist. |
| Caption | Liest oder setzt den Text einer Beschriftung auf einer PropertyManager-Seite. |
| CharacterBackgroundColor | Liest oder setzt die Hintergrundfarbe eines Bereichs von Zeichen der Beschriftung. |
| CharacterColor | Liest oder setzt die Farbe eines Bereichs von Zeichen der Beschriftung. |
| Font | Liest oder setzt die Schriftart eines Bereichs von Zeichen der Beschriftung. |
| Height | Liest oder setzt die Höhe einer Beschriftung in Dialogeinheiten. |
| Italic | Liest oder setzt, ob ein Bereich von Zeichen der Beschriftung kursiv ist. |
| LineOffset | Liest oder setzt, wie weit ein Bereich von Zeichen der Beschriftung über oder unter der Grundlinie steht, etwa für Exponenten und Indizes. |
| SizeRatio | Liest oder setzt die Größe eines Bereichs von Zeichen der Beschriftung im Verhältnis zur normalen Größe. |
| Style | Liest oder setzt die Ausrichtung und den Rahmen einer Beschriftung: links, mittig, rechts, vertieft. |
| Underline | Liest 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.