Objekt · SldWorks
PropertyManagerPageWindowFromHandle-Objekt
Ein .NET-Steuerelement auf einer PropertyManager-Seite, das du über sein Fenster-Handle einbindest: Höhe und Handle.
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
PropertyManagerPage2.AddControl2,PropertyManagerPageGroup.AddControl2oderPropertyManagerPageTab.AddControl2mitswControlType_WindowFromHandle
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 FunctionBemerkungen
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
| Name | Beschreibung |
|---|---|
| Height | Liest oder setzt die Höhe eines .NET-Steuerelements auf einer PropertyManager-Seite in Dialogeinheiten. |
Methoden 2, davon 1 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| SetWindowHandle | veraltet 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.