SolidWorksMakroprogrammierung

Objekt · SldWorks

DimXpertManager-Objekt

Das DimXpert-Schema einer Konfiguration eines Teils: Name, Beschreibung, Kommentar, Anordnung auf der Registerkarte DimXpertManager und der Zugang zu den DimXpert-Features und -Beschriftungen.

Deklaration Dim x As SldWorks.DimXpertManager · in der englischen .NET-Hilfe: IDimXpertManager

Beschreibung

DimXpertManager liefert das DimXpert-Schema einer Konfiguration. Das Schema ist das, was SOLIDWORKS auf der Registerkarte DimXpertManager im Verwaltungsbereich zeigt: die DimXpert-Features, also die Elemente des Teils, die DimXpert für Bemaßung und Toleranzen erkannt hat, und die DimXpert-Beschriftungen wie Maße, Bezüge und Form- und Lagetoleranzen. Das gilt für geöffnete Teile. Die Befehle gibt es seit SOLIDWORKS 2010.

Zugriff

Beispiel

' Gibt Name, Beschreibung, Kommentar und Anordnung des DimXpert-Schemas der aktiven
' Konfiguration aus, dazu die Zahl der DimXpert-Features und -Beschriftungen.
' Vorbedingung: Ein Teil mit DimXpert-Beschriftungen ist geöffnet. Unter Extras > Verweise
'               ist die „SOLIDWORKS DimXpert type library“ eingebunden.
' Ergebnis:     Die Angaben stehen im Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSchema As SldWorks.DimXpertManager
    Dim swDxTeil As SwDimXpert.DimXpertPart
    Dim sKonf As String

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

    sKonf = swModel.ConfigurationManager.ActiveConfiguration.Name
    Set swSchema = swModel.Extension.DimXpertManager(sKonf, False)   ' kein neues Schema anlegen
    If swSchema Is Nothing Then
        Debug.Print "Kein DimXpert-Schema in " & sKonf
        Exit Sub
    End If

    Debug.Print "Schema:       " & swSchema.SchemaName
    Debug.Print "Beschreibung: " & swSchema.SchemaDescription
    Debug.Print "Kommentar:    " & swSchema.SchemaComment
    Select Case swSchema.TreeDisplay
        Case swDimXpertTreeDisplay_Flat: Debug.Print "Anordnung:    flach"
        Case swDimXpertTreeDisplay_Annotation: Debug.Print "Anordnung:    nach Beschriftungen"
        Case swDimXpertTreeDisplay_Feature: Debug.Print "Anordnung:    nach Features"
    End Select

    Set swDxTeil = swSchema.DimXpertPart
    If Not swDxTeil Is Nothing Then
        Debug.Print "Features:     " & swDxTeil.GetFeatureCount
        Debug.Print "Beschriftungen: " & swDxTeil.GetAnnotationCount
    End If
End Sub

Bemerkungen

DimXpert-Typbibliothek: DimXpertManager.DimXpertPart liefert ein Objekt aus der eigenen DimXpert-API (DimXpertPart mit DimXpertFeature, DimXpertAnnotation usw.). Diese Objekte haben hier keine eigenen Seiten. Damit du sie in VBA mit Typ deklarieren kannst, binden die Hilfebeispiele unter Extras > Verweise die „SOLIDWORKS DimXpert type library“ ein. Ohne diesen Verweis deklarierst du die Variable As Object.

Schema anlegen: Mit CreateSchema = True legen ModelDocExtension.DimXpertManager und Configuration.DimXpertManager ein Schema an, wenn die Konfiguration noch keins hat. So macht es das Hilfebeispiel. Ob mit False und ohne Schema Nothing zurückkommt, sagt die Hilfe nicht. Das Beispiel oben prüft deshalb auf Nothing.

Lesen und setzen: Die Hilfe beschreibt DimXpertManager.SchemaName, DimXpertManager.SchemaDescription, DimXpertManager.SchemaComment und DimXpertManager.TreeDisplay nur als lesend („Gets“). Die .NET-Deklaration weist sie auch als schreibbar aus. Ob das Setzen wirkt, sagt die Hilfe nicht.

Auswahl: Im Hilfebeispiel „Get DimXpertManager Info“ liefert SelectionMgr.GetSelectedObject6 für ausgewählte DimXpert-Features (swSelSWIFTFEATURES) und -Beschriftungen (swSelSWIFTANNOTATIONS) ein Feature. Ob es ein Feature oder eine Beschriftung ist, liefern Feature.IsDimXpertFeature und Feature.IsDimXpertAnnotation. Ob eine gewöhnliche Annotation von DimXpert stammt, liefert Annotation.IsDimXpert.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
DimXpertPartLiefert das DimXpertPart-Objekt mit den DimXpert-Features und -Beschriftungen des Schemas.
SchemaCommentLiefert den Kommentar des DimXpert-Schemas.
SchemaDescriptionLiefert die Beschreibung des DimXpert-Schemas.
SchemaNameLiefert den Namen des DimXpert-Schemas.
TreeDisplayLiefert, wie die Registerkarte DimXpertManager die Einträge des Schemas anordnet: flach, nach Beschriftungen oder nach Features.

Siehe auch

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

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