SolidWorksMakroprogrammierung

Objekt · SldWorks

PropertyManagerPageWindowFromHandle-Objekt

Ein .NET-Steuerelement auf einer PropertyManager-Seite, das du über sein Fenster-Handle einbindest: Höhe und Handle.

Deklaration Dim x As SldWorks.PropertyManagerPageWindowFromHandle · in der englischen .NET-Hilfe: IPropertyManagerPageWindowFromHandle

Beschreibung

PropertyManagerPageWindowFromHandle gibt Zugriff auf ein .NET-Steuerelement auf einer PropertyManager-Seite. Damit bindet ein .NET-Add-in eigene Windows-Forms-, Benutzer- oder WPF-Steuerelemente in seine Seite ein. Du legst das Steuerelement mit AddControl2 und swControlType_WindowFromHandle aus swPropertyManagerPageControlType_e an und übergibst dann mit PropertyManagerPageWindowFromHandle.SetWindowHandlex64 das Fenster-Handle deines .NET-Steuerelements. Wie jedes Steuerelement ist es zugleich ein PropertyManagerPageControl.

Die Hilfe zeigt das nur in .NET-Add-ins („Add .NET Controls to SOLIDWORKS Using an Add-in“, C# und VB.NET). Ein Beispiel für VBA gibt es nicht. Height gibt es seit SOLIDWORKS 2010.

Zugriff

Beispiel

' Ausschnitt aus dem Aufbau einer PropertyManager-Seite im Klassenmodul des Handlers.
' Vorbedingung: swGruppe ist ein Gruppenfeld (PropertyManagerPageGroup) auf einer Seite,
'               die noch nicht angezeigt wird. Die Klasse implementiert
'               PropertyManagerPage2Handler9, siehe PropertyManagerPage2.
' Ergebnis:     Das Steuerelement ist angelegt und 50 Dialogeinheiten hoch. Das Handle des
'               .NET-Steuerelements übergibt ein .NET-Add-in vor jedem Anzeigen mit
'               SetWindowHandlex64. Ein VBA-Beispiel dafür nennt die Hilfe nicht.
Const ID_NETZ As Long = 40

Dim swGruppe As SldWorks.PropertyManagerPageGroup
Dim swNetz As SldWorks.PropertyManagerPageWindowFromHandle

Private Sub NetzAnlegen()
    Set swNetz = swGruppe.AddControl2(ID_NETZ, swControlType_WindowFromHandle, ".NET-Steuerelement", _
                                      swControlAlign_LeftEdge, _
                                      swControlOptions_Visible + swControlOptions_Enabled, "")
    If swNetz Is Nothing Then Exit Sub
    swNetz.Height = 50
End Sub

Private Function PropertyManagerPage2Handler9_OnWindowFromHandleControlCreated(ByVal Id As Long, ByVal Status As Boolean) As Long
    If Id = ID_NETZ And Not Status Then
        Debug.Print ".NET-Steuerelement nicht erstellt"
        PropertyManagerPage2Handler9_OnWindowFromHandleControlCreated = swHandleWindowFromHandleCreationFailure_Cancel
    End If
End Function

Bemerkungen

Handler: Ein Add-in mit .NET-Steuerelementen muss OnWindowFromHandleControlCreated im Handler der Seite implementieren. SOLIDWORKS ruft es auf, wenn es das Steuerelement zu erstellen versucht. Klappt das nicht, kommt Status = False, und der Handler gibt zurück, was geschehen soll, als Wert aus swHandleWindowFromHandleCreationFailure_e. Achtung: swHandleWindowFromHandleCreationFailure_Cancel erstellt die Seite ohne das Steuerelement, swHandleWindowFromHandleCreationFailure_Continue bricht die ganze Seite ab.

Handle bei jedem Anzeigen: Nach dem veralteten PropertyManagerPageWindowFromHandle.SetWindowHandle übergibst du das Handle jedes Mal, wenn du die Seite mit PropertyManagerPage2.Show2 anzeigst. Beim Schließen der Seite werden die Handles mit ihren Formularen zerstört.

Hilfebeispiel: „Add .NET Controls to SOLIDWORKS Using an Add-in“ setzt ein Windows-Formular (mit TopLevel = False), ein Benutzersteuerelement und ein WPF-Steuerelement in einem ElementHost auf die Seite. Vor dem Anzeigen übergibt es jeweils Handle.ToInt64() an PropertyManagerPageWindowFromHandle.SetWindowHandlex64.

Eigenschaften und Methoden

Eigenschaften 1, davon 1 beschrieben

NameBeschreibung
HeightLiest oder setzt die Höhe eines .NET-Steuerelements auf einer PropertyManager-Seite in Dialogeinheiten.

Methoden 2, davon 1 beschrieben, 1 veraltet

NameBeschreibung
SetWindowHandleveraltet ersetzt durch PropertyManagerPageWindowFromHandle.SetWindowHandlex64
SetWindowHandlex64Übergibt das Fenster-Handle des .NET-Steuerelements, das auf der PropertyManager-Seite erscheinen soll.

Siehe auch

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

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