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 BooleanswModel.Extension.SetUserPreferenceToggle UserPref, swDetailingNoOptionSpecified, ValueParameter
UserPrefLongByValWelche Einstellung, ein Wert aus
swUserPreferenceToggle_e, zum Beispiel:swDisplayPlanes: Ebenen anzeigenswDisplayOrigins: Ursprünge anzeigenswDisplaySketches: Skizzen anzeigenswDisplayAxes: Achsen anzeigen
UserPrefOptionLongByVal- Nur für Einstellungen, die es je Beschriftungs- oder Bemaßungsart einzeln gibt, ein Wert aus
swUserPreferenceOption_e. SonstswDetailingNoOptionSpecified. ValueBooleanByValTrueschaltet die Einstellung ein,Falseaus.
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 SubBemerkungen
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.