SolidWorksMakroprogrammierung

Methode · FeatureManager

InsertMacroFeature3-Methode (FeatureManager)

Fügt ein Makro-Feature ein, also ein eigenes Feature, dessen Neuaufbau ein Makro oder Add-In übernimmt.

Syntax

Function InsertMacroFeature3( _
   ByVal BaseName As String, _
   ByVal ProgId As String, _
   ByVal MacroMethods As Variant, _
   ByVal ParamNames As Variant, _
   ByVal ParamTypes As Variant, _
   ByVal ParamValues As Variant, _
   ByVal DimTypes As Variant, _
   ByVal DimValues As Variant, _
   ByVal EditBodies As Variant, _
   ByVal IconFiles As Variant, _
   ByVal Options As Long _
) As Feature
Set swFeat = swFeatMgr.InsertMacroFeature3("Mein Feature", "", vMethoden, vNamen, vTypen, vWerte, Empty, Empty, Empty, Empty, swMacroFeatureByDefault)

Parameter

BaseNameStringByVal
Grundname des Features. Er wird im Feature gespeichert, lässt sich nicht mehr ändern und ergibt den ersten Namen im FeatureManager.
ProgIdStringByVal
Bei einem Add-In mit COM die ProgID der Klasse, die ISwComFeature umsetzt, bei .NET der Klassenname. In VBA ein leerer Text.
MacroMethodsVariantByVal
Nur in VBA: Array mit genau neun Texten, je Datei, Modul und Prozedur für Neuaufbau, Bearbeiten und Sicherheitsfunktion (siehe Bemerkungen).
ParamNamesVariantByVal
Array mit den Namen der Parameter.
ParamTypesVariantByVal
Array mit den Typen der Parameter, Werte aus swMacroFeatureParamType_e: Text (0), Double (1), Integer (2).
ParamValuesVariantByVal
Array mit den Werten der Parameter, als Texte.
DimTypesVariantByVal
Array mit den Arten der Bemaßungen, Werte aus swDimensionType_e. Erlaubt sind nur swLinearDimension, swAngularDimension und swRadialDimension.
DimValuesVariantByVal
Array mit den Werten der Bemaßungen.
EditBodiesVariantByVal
Array mit den Körpern (Body2), die das Feature verändert.
IconFilesVariantByVal
Array mit drei oder neun Dateinamen für die Symbole im FeatureManager (siehe Bemerkungen).
OptionsLongByVal
Lage im FeatureManager und weitere Optionen, Werte aus swMacroFeatureOptions_e, meist swMacroFeatureByDefault (0).

Rückgabewert

Das neue Feature.

Beispiel

' Fügt ein Makro-Feature ein, dessen Neuaufbau die Prozedur swmNeuaufbau in diesem Makro übernimmt.
' Vorbedingung: Ein Teil ist geöffnet. Das Makro ist gespeichert und hat ein Modul "Module1".
' Ergebnis:     Ein Feature "Hinweis" im FeatureManager.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim sDatei As String
    Dim vMethoden(8) As String
    Dim vNamen(0) As String, vTypen(0) As Long, vWerte(0) As String
    Dim swFeat As SldWorks.Feature

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

    sDatei = swApp.GetCurrentMacroPathName
    vMethoden(0) = sDatei: vMethoden(1) = "Module1": vMethoden(2) = "swmNeuaufbau"
    vMethoden(3) = sDatei: vMethoden(4) = "Module1": vMethoden(5) = "swmBearbeiten"
    vMethoden(6) = "": vMethoden(7) = "": vMethoden(8) = ""

    vNamen(0) = "Text": vTypen(0) = swMacroFeatureParamTypeString: vWerte(0) = "Bitte prüfen"

    Set swFeat = swModel.FeatureManager.InsertMacroFeature3("Hinweis", "", vMethoden, _
        vNamen, vTypen, vWerte, Empty, Empty, Empty, Empty, swMacroFeatureByDefault)
    If swFeat Is Nothing Then swApp.SendMsgToUser2 "Makro-Feature nicht erzeugt.", swMbWarning, swMbOk
End Sub

Function swmNeuaufbau(varApp As Variant, varDoc As Variant, varFeat As Variant) As Variant
    swmNeuaufbau = True
End Function

Function swmBearbeiten(varApp As Variant, varDoc As Variant, varFeat As Variant) As Variant
    swmBearbeiten = True
End Function

Bemerkungen

Prozeduren in VBA: Das Array MacroMethods enthält dreimal Datei, Modul und Prozedur: für den Neuaufbau, für Feature bearbeiten und für die Sicherheitsfunktion. Die Datei ist der volle Pfad des Makros. Liegt die Prozedur im selben Makro, liefert ihn SldWorks.GetCurrentMacroPathName. Ohne Sicherheitsfunktion bleiben die letzten drei Texte leer. Die Prozedurnamen müssen mit swm beginnen. Welche Parameter die Prozeduren genau bekommen und was sie zurückgeben sollen, steht in der Hilfe unter „Overview of Macro Features“, nicht auf dieser Seite. Das Beispiel nimmt die übliche Form mit drei Variant-Parametern.

Symbole: Drei Dateien (normal, unterdrückt, hervorgehoben) als Bitmap mit 16 x 18 Pixeln, oder seit SOLIDWORKS 2017 neun Dateien in den Größen 20, 32 und 40 Pixel, je normal, unterdrückt und hervorgehoben. Voller Pfad oder nur der Dateiname.

Den Grundnamen liest du später mit MacroFeatureData.GetBaseName. Die externen Dateien eines Makro-Features listet ModelDoc2.ListAuxiliaryExternalFileReferences. swMacroFeatureEmbedMacroFile geht nicht mit .NET-Sprachen.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2007

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

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