SolidWorksMakroprogrammierung

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 Boolean
bErfolg = swView.SetDisplayMode4(False, swHIDDEN, False, False, True)

Parameter

UseParentBooleanByVal
True: Die Ansicht übernimmt die Einstellungen ihrer übergeordneten Ansicht. False: Die Ansicht bekommt eigene Einstellungen aus den folgenden Parametern. Wie sich True genau auswirkt, steht unter Bemerkungen.
ModeLongByVal

Der Anzeigemodus als Wert aus swDisplayMode_e:

  • swWIREFRAME (0): Drahtdarstellung
  • swHIDDEN_GREYED (1): verdeckte Kanten sichtbar
  • swHIDDEN (2): verdeckte Kanten ausgeblendet
  • swSHADED (3): schattiert
  • swSHADED_EDGES (7): schattiert mit Kanten

Die Werte swFACETED_WIREFRAME (4), swFACETED_HIDDEN_GREYED (5) und swFACETED_HIDDEN (6) bringen hier keine Entwurfsqualität: SOLIDWORKS nimmt dafür einfach 0, 1 oder 2. Ob swDisplayModeDEFAULT (8) erlaubt ist, sagt die Hilfe nicht.

FacetedBooleanByVal
True für Entwurfsqualität, False für hohe Qualität der Anzeige.
EdgesBooleanByVal
True, wenn die Kanten zu sehen sein sollen, solange die Ansicht schattiert ist, sonst False.
CThreadHighQualityBooleanByVal
True zeigt die Gewindedarstellungen in hoher Qualität, False in 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
Loop

Bemerkungen

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.