Methode · View
SetDisplayMode4-Methode (View)
Legt den Anzeigemodus einer Zeichenansicht fest, dazu Anzeigequalität, Kanten im schattierten Modus und Qualität der Gewindedarstellungen.
Syntax
Function SetDisplayMode4( _
ByVal UseParent As Boolean, _
ByVal Mode As Long, _
ByVal Faceted As Boolean, _
ByVal Edges As Boolean, _
ByVal CThreadHighQuality As Boolean _
) As BooleanbErfolg = swView.SetDisplayMode4(False, swHIDDEN, False, False, True)Parameter
UseParentBooleanByValTrue: Die Ansicht übernimmt die Einstellungen ihrer übergeordneten Ansicht.False: Die Ansicht bekommt eigene Einstellungen aus den folgenden Parametern. Wie sichTruegenau auswirkt, steht unter Bemerkungen.ModeLongByValDer Anzeigemodus als Wert aus
swDisplayMode_e:swWIREFRAME(0): DrahtdarstellungswHIDDEN_GREYED(1): verdeckte Kanten sichtbarswHIDDEN(2): verdeckte Kanten ausgeblendetswSHADED(3): schattiertswSHADED_EDGES(7): schattiert mit Kanten
Die Werte
swFACETED_WIREFRAME(4),swFACETED_HIDDEN_GREYED(5) undswFACETED_HIDDEN(6) bringen hier keine Entwurfsqualität: SOLIDWORKS nimmt dafür einfach 0, 1 oder 2. ObswDisplayModeDEFAULT(8) erlaubt ist, sagt die Hilfe nicht.FacetedBooleanByValTruefür Entwurfsqualität,Falsefür hohe Qualität der Anzeige.EdgesBooleanByValTrue, wenn die Kanten zu sehen sein sollen, solange die Ansicht schattiert ist, sonstFalse.CThreadHighQualityBooleanByValTruezeigt die Gewindedarstellungen in hoher Qualität,Falsein Entwurfsqualität.
Rückgabewert
True, wenn der Anzeigemodus gesetzt wurde, sonst False.
Beispiel
' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim swView As SldWorks.View
Dim bErfolg As Boolean
Set swView = swDraw.GetFirstView ' zuerst das Blatt selbst
Set swView = swView.GetNextView ' erste echte Zeichenansicht
Do While Not swView Is Nothing
' eigene Einstellung, verdeckte Kanten ausgeblendet, Entwurfsqualität, Gewinde in hoher Qualität
bErfolg = swView.SetDisplayMode4(False, swHIDDEN, True, False, True)
Debug.Print swView.GetName2 & ": " & bErfolg & ", Modus jetzt " & swView.GetDisplayMode2 & ", Entwurfsqualität " & swView.GetFacettedHlrDisplay
Set swView = swView.GetNextView
LoopBemerkungen
Mit UseParent = True gilt: Hat die Ansicht eine übergeordnete Ansicht, ignoriert SOLIDWORKS Mode, Faceted und Edges. Hat sie keine, bleibt ihr Anzeigemodus unverändert. Ob CThreadHighQuality in diesen Fällen trotzdem wirkt und was dann zurückkommt, sagt die Hilfe nicht. Willst du sicher eigene Werte setzen, übergib False.
Entwurfs- oder hohe Qualität wählst du nur über Faceted, nicht über die swFACETED_...-Werte von Mode. Die Entwurfsqualität kann die Leistung verbessern, weil die genaue Darstellung Zeit kostet. Beim Vorgänger SetDisplayMode3 schreibt die Hilfe, dass sich eine Ansicht in hoher Qualität nicht mehr auf Entwurfsqualität zurückstellen lässt. Ob das hier noch gilt, sagt sie nicht, prüf es deshalb mit View.GetFacettedHlrDisplay wie im Beispiel. Wie Edges mit swSHADED und swSHADED_EDGES zusammenspielt, erklärt die Hilfe nicht.
Zum Nachprüfen liest du die Einstellungen einzeln: View.GetUseParentDisplayMode, View.GetDisplayMode2, View.GetFacettedHlrDisplay, View.GetDisplayEdgesInShadedMode und View.GetCThreadQuality. Brauchst du nach dem Umstellen sofort die neue Geometrie der Ansicht, etwa ihre Polylinien, rufst du vorher View.UpdateViewDisplayGeometry auf. Ob die Zeichnung sonst neu aufgebaut werden muss, sagt die Hilfe nicht.
Die tangentialen Kanten stellst du getrennt mit View.SetDisplayTangentEdges2 ein. Ersetzt View.SetDisplayMode3, dem der Parameter CThreadHighQuality fehlte.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2021
Englisches Original: IView::SetDisplayMode4 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.