SolidWorksMakroprogrammierung

Objekt · SldWorks

SimpleHoleFeatureData2-Objekt

Die Definition einer einfachen Bohrung: Durchmesser, Endbedingung mit Tiefe oder Bezug, Richtung, Formschräge, Versatz und Feature-Bereich.

Deklaration Dim x As SldWorks.SimpleHoleFeatureData2 · in der englischen .NET-Hilfe: ISimpleHoleFeatureData2

Beschreibung

SimpleHoleFeatureData2 gibt Zugriff auf eine einfache Bohrung. Das ist ein kreisrunder Schnitt mit Durchmesser und Endbedingung, anders als die Bohrung aus dem Bohrungsassistenten (WizardHoleFeatureData2). Die meisten Befehle gibt es seit SOLIDWORKS 2001Plus, die für Bezüge und den Feature-Bereich seit 2003 SP01 bis 2009.

Zugriff

Neu anlegen kannst du eine einfache Bohrung mit FeatureManager.SimpleHole2.

Beispiel

' Gibt Durchmesser, Endbedingung und Tiefe der ausgewählten einfachen Bohrung aus und
' vergrößert den Durchmesser um 1 mm.
' Vorbedingung: Ein Teil mit einer einfachen Bohrung ist offen, die Bohrung ist im
'               FeatureManager ausgewählt.
' Ergebnis:     Die Werte stehen im Direktfenster, die Bohrung ist 1 mm größer.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSel As Object
    Dim swFeat As SldWorks.Feature
    Dim swDef As Object
    Dim swDaten As SldWorks.SimpleHoleFeatureData2

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swSel = swModel.SelectionManager.GetSelectedObject6(1, -1)
    If Not TypeOf swSel Is SldWorks.Feature Then Exit Sub
    Set swFeat = swSel
    Set swDef = swFeat.GetDefinition
    If Not TypeOf swDef Is SldWorks.SimpleHoleFeatureData2 Then Exit Sub

    Set swDaten = swDef
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Debug.Print swFeat.Name & " (" & swFeat.GetTypeName2 & "): Ø " & swDaten.Diameter * 1000 & " mm"
    Debug.Print "Endbedingung: " & swDaten.Type                 ' swEndConditions_e
    If swDaten.Type = swEndCondBlind Then Debug.Print "Tiefe: " & swDaten.Depth * 1000 & " mm"

    swDaten.Diameter = swDaten.Diameter + 0.001
    If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then swDaten.ReleaseSelectionAccess
End Sub

Bemerkungen

Ändern: Nach SimpleHoleFeatureData2.AccessSelections setzt du die Werte und rufst Feature.ModifyDefinition auf. Änderst du nichts, rufst du SimpleHoleFeatureData2.ReleaseSelectionAccess auf. Das Hilfebeispiel „Set New End Condition for Simple Hole Feature“ stellt so die Endbedingung auf eine ausgewählte Fläche um.

Typname: Die Tabelle zu Feature.GetTypeName2 ordnet SimpleHoleFeatureData2 dem Typnamen SketchHole zu. Das Beispiel oben prüft deshalb den Typ der Definition und gibt den Typnamen nur aus.

Einheiten: Für Durchmesser, Tiefe und Versatz nennt die Hilfe hier keine Einheit. Es sind Meter, wie bei FeatureManager.SimpleHole2. Für den Winkel der Formschräge nennt sie auch keine Einheit; es ist das Bogenmaß.

Mehr dazu: Bei vielen Befehlen verweist die Hilfe auf „Accessing Selections that Define Features“.

Eigenschaften und Methoden

Eigenschaften 18, davon 18 beschrieben

NameBeschreibung
AssemblyFeatureScopeLiest oder setzt, ob eine einfache Bohrung in einer Baugruppe nur ausgewählte Komponenten schneidet.
AutoSelectLiest oder setzt, ob die Bohrung in einem Mehrkörperteil automatisch alle Körper schneidet oder nur die angegebenen.
AutoSelectComponentsLiest oder setzt, ob eine einfache Bohrung in einer Baugruppe automatisch alle betroffenen Komponenten wählt.
DepthLiest oder setzt die Tiefe einer einfachen Bohrung mit der Endbedingung Blind.
DiameterLiest oder setzt den Durchmesser der einfachen Bohrung.
DraftAngleLiest oder setzt den Winkel der Formschräge der einfachen Bohrung.
DraftOutwardLiest oder setzt, ob die Formschräge der einfachen Bohrung nach außen geht.
DraftWhileExtrudingLiest oder setzt, ob die einfache Bohrung eine Formschräge hat.
FaceLiest oder setzt die Fläche, an der die einfache Bohrung endet.
FeatureScopeLiest oder setzt, ob die Bohrung in einem Mehrkörperteil nur bestimmte Körper schneidet.
FeatureScopeBodiesLiest oder setzt die Volumenkörper, die die Bohrung in einem Mehrkörperteil schneidet.
PropagateFeatureToPartsLiest oder setzt, ob eine einfache Bohrung in einer Baugruppe auf die betroffenen Teile übertragen wird.
ReverseDirectionLiest oder setzt, ob die Richtung des Schnitts umgekehrt ist.
ReverseOffsetLiest oder setzt, ob der Versatz von der Fläche umgekehrt ist.
SurfaceOffsetLiest oder setzt den Versatz der Bohrungstiefe von der Fläche.
TranslateSurfaceLiest oder setzt, ob der Versatz von der Fläche als Verschiebung der Fläche gilt.
TypeLiest oder setzt die Endbedingung der einfachen Bohrung.
VertexLiest oder setzt den Eckpunkt, an dem die einfache Bohrung endet.

Methoden 7, davon 7 beschrieben

NameBeschreibung
AccessSelectionsSetzt das Modell vor die einfache Bohrung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.
GetDirectionReferenceLiefert die ein oder zwei Elemente, die die Richtung des Schnitts festlegen.
GetEndConditionReferenceLiefert das Element, das die Endbedingung der einfachen Bohrung festlegt, und seine Art.
GetFeatureScopeBodiesCountLiefert die Zahl der Volumenkörper, die die Bohrung in einem Mehrkörperteil schneidet.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Bohrung nicht geändert hast.
SetDirectionReferenceLegt die Richtung des Schnitts mit ein oder zwei Elementen fest.
SetEndConditionReferenceLegt das Element fest, das die Endbedingung der einfachen Bohrung bestimmt, etwa eine Fläche.

Nicht aufgeführt sind 5 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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