SolidWorksMakroprogrammierung

Methode · Sheet

SetProperties2-Methode (Sheet)

Setzt die Eigenschaften des Blatts: Papierformat, Vorlage, Maßstab, Projektionsart, Größe und die Einstellung für benutzerdefinierte Eigenschaften.

Syntax

Sub SetProperties2( _
   ByVal PaperSz As Long, _
   ByVal Templ As Long, _
   ByVal Scale1 As Double, _
   ByVal Scale2 As Double, _
   ByVal FirstAngle As Boolean, _
   ByVal Width As Double, _
   ByVal Height As Double, _
   ByVal SameCustomPropAsSheetInDocProp As Boolean _
)
swBlatt.SetProperties2 swDwgPaperA3size, swDwgTemplateA3size, 1, 2, True, 0, 0, False

Parameter

PaperSzLongByVal
Das Papierformat, ein Wert aus swDwgPaperSizes_e.
TemplLongByVal
Die Vorlage, ein Wert aus swDwgTemplates_e.
Scale1DoubleByVal
Zähler des Maßstabs.
Scale2DoubleByVal
Nenner des Maßstabs.
FirstAngleBooleanByVal
True: Erstwinkelprojektion. False: Drittwinkelprojektion.
WidthDoubleByVal
Eigene Breite des Papiers bei swDwgPapersUserDefined, vermutlich in Meter.
HeightDoubleByVal
Eigene Höhe des Papiers bei swDwgPapersUserDefined, vermutlich in Meter.
SameCustomPropAsSheetInDocPropBooleanByVal
True: im Dialog „Blatteigenschaften“ die Option „Wie in den Dokumenteigenschaften angegebenes Blatt“ wählen. False: nicht.

Beispiel

' swBlatt ist ein Zeichenblatt (Sheet), swModel die Zeichnung (ModelDoc2).
Dim v As Variant
v = swBlatt.GetProperties2
swBlatt.SetProperties2 v(0), v(1), v(2), v(3), Not (v(4) <> 0), v(5), v(6), (v(7) <> 0)
swModel.EditRebuild3

Bemerkungen

Dabei gilt:

  • Eine eigene Vorlage (swDwgTemplateCustom) bleibt, bis du mit Sheet.SetTemplateName eine andere angibst.
  • Passt Templ nicht zu PaperSz, passt die Vorlage nicht aufs Papier; Templ überschreibt PaperSz nicht.
  • Änderst du den Maßstab, übernehmen ihn alle Zeichenansichten, die den Blattmaßstab nutzen.
  • Für SameCustomPropAsSheetInDocProp True muss unter Extras > Optionen > Dokumenteigenschaften > Zeichenblätter die Option „Benutzerdefinierte Eigenschaftswerte aus diesem Blatt verwenden“ schon gesetzt sein.

Die Hilfe schreibt dort „swDwgPaperUserDefined“, in swDwgPaperSizes_e heißt der Wert swDwgPapersUserDefined. Größe und Papierformat setzt auch Sheet.SetSize. Das Hilfebeispiel „Set Drawing Sheet Properties“ liest die Werte mit Sheet.GetProperties2, setzt den letzten auf 1 und schreibt alle zurück. Die Methode ersetzt das veraltete SetProperties.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2016

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

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