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 FeatureSet 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
ISwComFeatureumsetzt, 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 nurswLinearDimension,swAngularDimensionundswRadialDimension. 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, meistswMacroFeatureByDefault(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 FunctionBemerkungen
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.