SolidWorksMakroprogrammierung

Methode · DrawingDoc

GetPenInfo-Methode (DrawingDoc)

Liefert Linienschriftart, Linienstärke und Farbe der Stifte, die SOLIDWORKS verwendet.

Syntax

Function GetPenInfo() As Variant
vInfo = swDraw.GetPenInfo

Rückgabewert

Ein Array mit Ganzzahlen (Long oder Integer). Es ist so aufgebaut: font, weight, color, also Linienschriftart, Linienstärke und Farbe. Ob sich diese drei Werte für jeden Stift wiederholen (dann hat das Array DrawingDoc.GetPenCount mal 3 Einträge), sagt die Hilfe nicht ausdrücklich.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim vInfo As Variant
Dim i As Long
vInfo = swDraw.GetPenInfo
If IsArray(vInfo) Then
    Debug.Print "Stifte: " & swDraw.GetPenCount & ", Werte: " & UBound(vInfo) + 1
    For i = 0 To UBound(vInfo) - 2 Step 3
        Debug.Print "Schriftart " & vInfo(i) & ", Stärke " & vInfo(i + 1) & ", Farbe " & vInfo(i + 2)
    Next i
End If

Bemerkungen

Die Hilfe spricht von einem „Array, das ein Array von Long- oder Integer-Werten enthält“. Ob das Ergebnis also flach oder verschachtelt ist, bleibt offen. Das Beispiel geht von einem flachen Array aus und davon, dass je Stift drei Werte hintereinander stehen. Die erste Zeile der Ausgabe zeigt dir, ob die Anzahl der Werte dazu passt. Wie die Werte zu lesen sind, erklärt die Hilfe nicht: ob „font“ ein Index wie bei DrawingDoc.GetLineFontCount2 ist, in welcher Einheit die Stärke steht und wie die Farbe kodiert ist. Probier es aus, bevor du dich darauf verlässt.

Das Ergebnis ist ein flaches Array mit drei Werten je Stift (Schriftart, Stärke, Farbe) hintereinander.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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