SolidWorksMakroprogrammierung

Objekt · SldWorks

LightDialog-Objekt

Der Beleuchtungsdialog von SOLIDWORKS, wenn der Benutzer ihn öffnet: die Kennung des bearbeiteten Lichts und ein eigener Unterdialog.

Deklaration Dim x As SldWorks.LightDialog · in der englischen .NET-Hilfe: ILightDialog

Beschreibung

LightDialog gibt Zugriff auf den Beleuchtungsdialog von SOLIDWORKS, also den Dialog, in dem der Benutzer ein Licht bearbeitet. Damit ergänzt ein Programm den Dialog um eigene Angaben. Das Objekt kommt nur aus einem Ereignis. Die Befehle gibt es seit SOLIDWORKS 99.

Zugriff

  • AssemblyDoc.LightingDialogCreateNotify: Parameter dialog, wenn der Benutzer in einer Baugruppe einen Beleuchtungsdialog geöffnet hat
  • Ereignis PartDoc.LightingDialogCreateNotify: dasselbe in einem Teil

Beispiel

' Hängt sich an die Ereignisse des aktiven Teils und meldet beim Öffnen eines
' Beleuchtungsdialogs die Kennung des Lichts.
' Vorbedingung: Ein Teil ist offen. Der Code steht in einem UserForm "UserForm1",
'               im Modul startet main es mit UserForm1.Show vbModeless.
' Ergebnis:     Solange das UserForm offen ist, steht beim Öffnen des Dialogs für ein
'               Licht die Kennung im Direktfenster.
Option Explicit

Public WithEvents swPart As SldWorks.PartDoc

Private Sub UserForm_Initialize()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub
    Set swPart = swModel
End Sub

Private Function swPart_LightingDialogCreateNotify(ByVal dialog As Object) As Long
    Dim swDlg As SldWorks.LightDialog
    Dim nKennung As Long

    Set swDlg = dialog
    nKennung = swDlg.GetLightId
    If nKennung = -1 Then
        Debug.Print "Licht nicht gefunden"
    Else
        Debug.Print "Beleuchtungsdialog für das Licht mit der Kennung " & nKennung
    End If
End Function

Bemerkungen

Zweck: Du nimmst das Objekt, um dem Beleuchtungsdialog von SOLIDWORKS eigene Angaben hinzuzufügen. Die Hilfe hat zu LightDialog kein Beispiel und beschreibt die Ereignisse nur mit einem Satz.

Unterdialog: LightDialog.AddSubDialog erwartet einen Zeiger auf einen MFC-Dialog (CDialog). Aus VBA kommt nur LightDialog.GetLightId in Frage. Eigene Registerkarten mit einem ActiveX-Steuerelement fügst du über SWPropertySheet hinzu, das auch die Dialoge für Beleuchtung und Lichtquellen kennt (siehe swPropSheetType_e). Wie sich die beiden Wege zueinander verhalten, sagt die Hilfe nicht.

Kennung: Ob die Kennung aus GetLightId dieselbe ist wie die aus Light.GetID oder die Nummer bei ModelDoc2.GetLightSourceName, sagt die Hilfe nicht.

Öffnest du ein Spotlight per Doppelklick im FeatureManager, erscheint sein PropertyManager; das Ereignis LightingDialogCreateNotify kommt dabei nicht.

Eigenschaften und Methoden

Methoden 2, davon 2 beschrieben

NameBeschreibung
AddSubDialogFügt dem Beleuchtungsdialog einen eigenen Unterdialog hinzu, einen MFC-Dialog aus C++.
GetLightIdLiefert die Kennung des Lichts, das der Beleuchtungsdialog gerade bearbeitet.

Siehe auch

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

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