SolidWorksMakroprogrammierung

Methode · DrawingDoc

FeatureByName-Methode (DrawingDoc)

Liefert das Feature der Zeichnung mit dem angegebenen Namen.

Syntax

Function FeatureByName( _
   ByVal Name As String _
) As Object
Set swFeat = swDraw.FeatureByName("Zeichenansicht1")

Parameter

NameStringByVal
Name des Features. Auch eine Zeichenansicht ist in der Zeichnung ein Feature, du findest sie unter ihrem Namen, etwa "Zeichenansicht1". In einer englischen Zeichnung heißt sie standardmäßig "Drawing View1".

Rückgabewert

Das Feature (Feature). Was zurückkommt, wenn es kein Feature mit diesem Namen gibt, sagt die Hilfe nicht. Prüf das Ergebnis vorsichtshalber mit Is Nothing.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim swFeat As SldWorks.Feature
Dim swUnterFeat As SldWorks.Feature
Set swFeat = swDraw.FeatureByName("Zeichenansicht1")
If swFeat Is Nothing Then
    Debug.Print "Kein Feature mit diesem Namen gefunden."
Else
    Set swUnterFeat = swFeat.GetFirstSubFeature
    Do While Not swUnterFeat Is Nothing
        Debug.Print swUnterFeat.Name & " (" & swUnterFeat.GetTypeName2 & ")"
        Set swUnterFeat = swUnterFeat.GetNextSubFeature
    Loop
End If

Bemerkungen

Den Namen einer Zeichenansicht liefert View.GetName2. Unter dem Feature einer Ansicht hängen weitere Features, etwa eine Bohrungstabelle. Die gehst du wie im Beispiel mit Feature.GetFirstSubFeature und Feature.GetNextSubFeature durch.

Ob beim Namen Groß- und Kleinschreibung zählt, sagt die Hilfe nicht.

Siehe auch

Verfügbarkeit

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

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

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