SolidWorksMakroprogrammierung

Methode · ModelDocExtension

SetUserPreferenceToggle-Methode (ModelDocExtension)

Schaltet eine Ja/Nein-Einstellung des Dokuments ein oder aus, zum Beispiel ob Ebenen, Ursprünge oder Skizzen angezeigt werden.

Syntax

Function SetUserPreferenceToggle( _
   ByVal UserPref As Long, _
   ByVal UserPrefOption As Long, _
   ByVal Value As Boolean _
) As Boolean
swModel.Extension.SetUserPreferenceToggle UserPref, swDetailingNoOptionSpecified, Value

Parameter

UserPrefLongByVal

Welche Einstellung, ein Wert aus swUserPreferenceToggle_e, zum Beispiel:

  • swDisplayPlanes: Ebenen anzeigen
  • swDisplayOrigins: Ursprünge anzeigen
  • swDisplaySketches: Skizzen anzeigen
  • swDisplayAxes: Achsen anzeigen
UserPrefOptionLongByVal
Nur für Einstellungen, die es je Beschriftungs- oder Bemaßungsart einzeln gibt, ein Wert aus swUserPreferenceOption_e. Sonst swDetailingNoOptionSpecified.
ValueBooleanByVal
True schaltet die Einstellung ein, False aus.

Rückgabewert

Der neue Zustand der Einstellung: True für eingeschaltet, False für ausgeschaltet.

Beispiel

' Blendet im aktiven Dokument alle Ebenen, Ursprünge und Skizzen aus,
' zum Beispiel vor einem Bildschirmfoto.
' Vorbedingung: Ein Teil oder eine Baugruppe ist geöffnet.
' Ergebnis:     Nur noch die Körper sind zu sehen.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swExt As SldWorks.ModelDocExtension

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swExt = swModel.Extension

    swExt.SetUserPreferenceToggle swDisplayPlanes, swDetailingNoOptionSpecified, False
    swExt.SetUserPreferenceToggle swDisplayOrigins, swDetailingNoOptionSpecified, False
    swExt.SetUserPreferenceToggle swDisplaySketches, swDetailingNoOptionSpecified, False
End Sub

Bemerkungen

SOLIDWORKS unterscheidet zwei Arten von Einstellungen. Systemoptionen gelten für alle Dokumente und stehen unter Extras › Optionen › Systemoptionen. Dafür gibt es SldWorks.SetUserPreferenceToggle. Dokumenteigenschaften gehören zu einem Dokument und werden mit ihm gespeichert, unter Extras › Optionen › Dokumenteigenschaften. Dafür ist dieser Befehl da. Auch die Schalter unter Ansicht › Ausblenden/Einblenden gehören zum Dokument.

Welcher Wert aus swUserPreferenceToggle_e zu welcher Einstellung gehört und ob er zum System oder zum Dokument gehört, steht in der englischen Hilfe auf den Seiten „System Options and Document Properties“.

Eine geänderte Dokumenteigenschaft ist eine Änderung am Dokument und wird mit ihm gespeichert. Soll das Dokument hinterher wieder aussehen wie vorher, merk dir den alten Wert mit ModelDocExtension.GetUserPreferenceToggle und stell ihn am Ende wieder her.

Zeigt das Fenster eine geänderte Anzeige-Einstellung nicht sofort, zeichnet ModelView.GraphicsRedraw es neu. Den älteren Befehl ModelDoc2.GraphicsRedraw2 aus vielen Makros gibt es noch, er ist aber veraltet.

Der Vorgänger ModelDoc2.SetUserPreferenceToggle ist veraltet.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2009

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

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