SolidWorksMakroprogrammierung

Eigenschaft · Feature

Name-Eigenschaft (Feature)

Liest oder ändert den Namen eines Features, so wie er im FeatureManager steht.

Syntax

Property Name As String
sName = swFeat.Name           ' auslesen
swFeat.Name = "Grundkörper"   ' ändern

Wert

Der Name des Features, zum Beispiel Skizze1 oder Verrundung2.

Beispiel

' Benennt das im FeatureManager ausgewählte Feature in "Grundkörper" um.
' Vorbedingung: Ein Teil ist geöffnet, ein Feature wie eine Extrusion ist ausgewählt.
' Ergebnis:     Das Feature heißt im FeatureManager "Grundkörper".
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSelMgr As SldWorks.SelectionMgr
    Dim swFeat As SldWorks.Feature

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSelMgr = swModel.SelectionManager

    If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelBODYFEATURES Then
        swApp.SendMsgToUser2 "Bitte ein Feature im FeatureManager auswählen.", swMbWarning, swMbOk
        Exit Sub
    End If

    Set swFeat = swSelMgr.GetSelectedObject6(1, -1)
    swFeat.Name = "Grundkörper"
    If swFeat.Name <> "Grundkörper" Then
        swApp.SendMsgToUser2 "Umbenennen nicht möglich, der Name ist vielleicht schon vergeben.", swMbWarning, swMbOk
    End If
    swModel.EditRebuild3
End Sub

Bemerkungen

Der neue Name muss im FeatureManager eindeutig sein und darf keine Zeichen enthalten, die SOLIDWORKS für sich reserviert. Sonst bleibt der alte Name stehen, ohne Fehlermeldung. Das Beispiel prüft deshalb nach dem Umbenennen, ob der Name wirklich übernommen wurde.

Der Benutzer sieht den neuen Namen erst nach einem Neuaufbau, deshalb ruft das Beispiel ModelDoc2.EditRebuild3 auf.

Der Name ist gut für Meldungen an den Benutzer, aber unsicher zum Erkennen eines Features: Er hängt von der Sprache der Vorlage ab (Skizze1 oder Sketch1) und lässt sich ändern. Die Art eines Features erkennst du sicherer an Feature.GetTypeName2.

Siehe auch

In den Videos

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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