Objekt · SldWorks
SimpleHoleFeatureData2-Objekt
Die Definition einer einfachen Bohrung: Durchmesser, Endbedingung mit Tiefe oder Bezug, Richtung, Formschräge, Versatz und Feature-Bereich.
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
Feature.GetDefinition: bei einer einfachen Bohrung, mit dem TypnamenSketchHole(sieheFeature.GetTypeName2)
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 SubBemerkungen
Ä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
| Name | Beschreibung |
|---|---|
| AssemblyFeatureScope | Liest oder setzt, ob eine einfache Bohrung in einer Baugruppe nur ausgewählte Komponenten schneidet. |
| AutoSelect | Liest oder setzt, ob die Bohrung in einem Mehrkörperteil automatisch alle Körper schneidet oder nur die angegebenen. |
| AutoSelectComponents | Liest oder setzt, ob eine einfache Bohrung in einer Baugruppe automatisch alle betroffenen Komponenten wählt. |
| Depth | Liest oder setzt die Tiefe einer einfachen Bohrung mit der Endbedingung Blind. |
| Diameter | Liest oder setzt den Durchmesser der einfachen Bohrung. |
| DraftAngle | Liest oder setzt den Winkel der Formschräge der einfachen Bohrung. |
| DraftOutward | Liest oder setzt, ob die Formschräge der einfachen Bohrung nach außen geht. |
| DraftWhileExtruding | Liest oder setzt, ob die einfache Bohrung eine Formschräge hat. |
| Face | Liest oder setzt die Fläche, an der die einfache Bohrung endet. |
| FeatureScope | Liest oder setzt, ob die Bohrung in einem Mehrkörperteil nur bestimmte Körper schneidet. |
| FeatureScopeBodies | Liest oder setzt die Volumenkörper, die die Bohrung in einem Mehrkörperteil schneidet. |
| PropagateFeatureToParts | Liest oder setzt, ob eine einfache Bohrung in einer Baugruppe auf die betroffenen Teile übertragen wird. |
| ReverseDirection | Liest oder setzt, ob die Richtung des Schnitts umgekehrt ist. |
| ReverseOffset | Liest oder setzt, ob der Versatz von der Fläche umgekehrt ist. |
| SurfaceOffset | Liest oder setzt den Versatz der Bohrungstiefe von der Fläche. |
| TranslateSurface | Liest oder setzt, ob der Versatz von der Fläche als Verschiebung der Fläche gilt. |
| Type | Liest oder setzt die Endbedingung der einfachen Bohrung. |
| Vertex | Liest oder setzt den Eckpunkt, an dem die einfache Bohrung endet. |
Methoden 7, davon 7 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die einfache Bohrung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| GetDirectionReference | Liefert die ein oder zwei Elemente, die die Richtung des Schnitts festlegen. |
| GetEndConditionReference | Liefert das Element, das die Endbedingung der einfachen Bohrung festlegt, und seine Art. |
| GetFeatureScopeBodiesCount | Liefert die Zahl der Volumenkörper, die die Bohrung in einem Mehrkörperteil schneidet. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Bohrung nicht geändert hast. |
| SetDirectionReference | Legt die Richtung des Schnitts mit ein oder zwei Elementen fest. |
| SetEndConditionReference | Legt 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.