SolidWorksMakroprogrammierung

Objekt · SldWorks

Light-Objekt

Das Feature eines Lichts: seine dauerhafte Kennung im Dokument.

Deklaration Dim x As SldWorks.Light · in der englischen .NET-Hilfe: ILight

Beschreibung

Light gibt Zugriff auf das Feature eines Lichts, also einer Lichtquelle wie eines Spotlights. Das Objekt hat nur einen Befehl, die Kennung des Lichts. Licht anlegen und einstellen geht über ModelDoc2, etwa mit ModelDoc2.AddLightSource und ModelDoc2.SetLightSourcePropertyValuesVB. Den Befehl gibt es seit SOLIDWORKS 2004.

Zugriff

Beispiel

' Wählt das Licht „Spot1“ aus und gibt seine Kennung aus.
' Vorbedingung: Ein Modell mit einem Licht namens „Spot1“ ist offen, etwa nach
'               ModelDoc2.AddLightSource wie im Hilfebeispiel.
' Ergebnis:     Die Kennung steht im Direktfenster, das Modell bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swLicht As SldWorks.Light

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If False = swModel.Extension.SelectByID2("Spot1", "LIGHTS", 0, 0, 0, False, 0, Nothing, 0) Then Exit Sub

    Set swFeat = swModel.SelectionManager.GetSelectedObject6(1, -1)
    Set swLicht = swFeat.GetSpecificFeature2
    If swLicht Is Nothing Then Exit Sub
    Debug.Print swFeat.Name & ": Kennung " & swLicht.GetID
    swModel.ClearSelection2 True
End Sub

Bemerkungen

Licht anlegen: Das Hilfebeispiel „Add Spotlight and Get Light Feature“ legt mit ModelDoc2.AddLightSource ein Spotlight namens „Spot1“ an, stellt es mit ModelDoc2.SetLightSourcePropertyValuesVB ein, wählt es mit dem Typ LIGHTS aus und liest dann die Kennung. Das Beispiel „Redirect Spotlight“ richtet ein Spotlight zusätzlich an einer 3D-Skizze aus.

Kennung: Die Kennung aus Light.GetID ist im Dokument eindeutig und ändert sich auch beim Umbenennen nicht. Sie ist keine persistente Referenz, mit der du das Licht wiederfinden könntest.

Beim Durchlaufen der Features mit ModelDoc2.FirstFeature und Feature.GetNextFeature taucht das Licht nicht auf. Hol es stattdessen über die Auswahl mit dem Typ LIGHTS.

Eigenschaften und Methoden

Methoden 1, davon 1 beschrieben

NameBeschreibung
GetIDLiefert die Kennung des Lichts, die im Dokument eindeutig ist und sich nie ändert.

Siehe auch

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

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