Objekt · SldWorks
WizardHoleFeatureData2-Objekt
Die Feature-Daten einer Bohrung oder eines Langlochs aus dem Bohrungsassistenten: Typ, Norm, Schraube, Maße und Endbedingung.
Beschreibung
Hinter jeder Bohrung aus dem Bohrungsassistenten (Typname HoleWzd) steckt ein WizardHoleFeatureData2-Objekt mit ihren Feature-Daten. Das gilt auch für Langlöcher: mit Flachsenkung, mit Kegelsenkung oder gerade. Du liest die Daten mit Feature.GetDefinition und übernimmst Änderungen mit Feature.ModifyDefinition. Außerdem dient das Objekt als Vorlage für neue Bohrungen.
Zugriff
Feature.GetDefinition: aus einem Feature mit dem TypnamenHoleWzdFeatureManager.CreateDefinitionmitswFmHoleWzd: eine neue Definition fürFeatureManager.CreateFeature
Beispiel
' Gibt Typ, Norm, Größe und die passenden Maße der ausgewählten Bohrung aus.
' Vorbedingung: Ein Teil ist offen, eine Bohrung aus dem Bohrungsassistenten ist im FeatureManager ausgewählt.
' Ergebnis: Angaben im Direktfenster (Strg+G). Ein Sackloch wird 2 mm tiefer.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swFeat As SldWorks.Feature
Dim swWzd As SldWorks.WizardHoleFeatureData2
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocPART Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelBODYFEATURES Then Exit Sub
Set swFeat = swSelMgr.GetSelectedObject6(1, -1)
If swFeat.GetTypeName2 <> "HoleWzd" Then
Debug.Print "Keine Bohrung aus dem Bohrungsassistenten ausgewählt."
Exit Sub
End If
Set swWzd = swFeat.GetDefinition
Debug.Print swFeat.Name & ": Typ " & swWzd.Type & ", Norm " & swWzd.Standard2 & ", Größe " & swWzd.FastenerSize
Select Case swWzd.Type
Case swHoleBlind, swCounterBoreBlind, swCounterSinkBlind
Debug.Print "Sackloch Ø " & swWzd.HoleDiameter * 1000 & " x " & swWzd.HoleDepth * 1000 & " mm"
If swWzd.AccessSelections(swModel, Nothing) Then
swWzd.HoleDepth = swWzd.HoleDepth + 0.002
If swFeat.ModifyDefinition(swWzd, swModel, Nothing) Then
Set swWzd = swFeat.GetDefinition
Debug.Print "Neue Tiefe: " & swWzd.HoleDepth * 1000 & " mm"
End If
End If
Case swHoleThru, swCounterBoreThru, swCounterSinkThru
Debug.Print "Durchgehend Ø " & swWzd.ThruHoleDiameter * 1000 & " mm"
Case swTapBlind, swTapThru
Debug.Print "Gewinde Ø " & swWzd.ThreadDiameter * 1000 & " mm, " & swWzd.ThreadDepth * 1000 & " mm tief"
Case Else
Debug.Print "Anderer Typ, die gültigen Maße stehen in der Hilfetabelle."
End Select
End SubBemerkungen
Gültige Maße: Welche Eigenschaften gelten, hängt von WizardHoleFeatureData2.Type ab. Die Hilfetabelle „Hole Wizard Feature Types and Their Valid Properties“ listet sie je Typ. Grob gilt: Die älteren Bohrungsarten (Werte 0 bis 9 in swWzdHoleTypes_e) nutzen Diameter und Depth, neuere Sacklöcher HoleDiameter und HoleDepth, durchgehende Bohrungen ThruHoleDiameter und ThruHoleDepth. Gewindebohrungen nutzen Thread… und für das Kernloch TapDrill… bzw. ThruTapDrill…. Bei den Senkungen widersprechen die einzelnen Hilfeseiten der Tabelle teilweise. Die Seiten hier nennen dann beides.
Ändern: Nach dem Hilfethema „Accessing Selections that Define Features“ rufst du erst WizardHoleFeatureData2.AccessSelections auf. Das setzt das Modell vor die Bohrung zurück. Dann änderst du die Werte und übernimmst sie mit Feature.ModifyDefinition, das den Zugriff auch wieder freigibt. Ohne Änderung gibst du ihn mit WizardHoleFeatureData2.ReleaseSelectionAccess frei. Vor WizardHoleFeatureData2.Face, WizardHoleFeatureData2.Vertex und WizardHoleFeatureData2.GetEndConditionReference ist AccessSelections Pflicht, so steht es im Hilfebeispiel.
Neue Bohrung: Lege mit FeatureManager.CreateDefinition und swFmHoleWzd eine neue Definition an, belege sie mit WizardHoleFeatureData2.InitializeHole vor, ändere Werte, wähle die Fläche aus und erstelle die Bohrung mit FeatureManager.CreateFeature. Du kannst auch die Definition einer vorhandenen Bohrung an CreateFeature übergeben, um eine weitere Bohrung derselben Art zu erstellen. Direkt mit allen Werten geht es mit FeatureManager.HoleWizard5.
Nur lesbar: Type, Standard, Standard2, FastenerType2, FastenerSize, HeadClearanceType, Face und Vertex kannst du nicht setzen. Norm, Schraubentyp und Größe änderst du mit WizardHoleFeatureData2.ChangeStandard. Bei WizardHoleFeatureData2.NearSideCounterSink und WizardHoleFeatureData2.FarSideCounterSink widerspricht sich die Hilfe: Sie nennt die Eigenschaften nur lesbar, ihr Beispiel setzt sie aber.
Einheiten: Die Hilfeseiten nennen fast nie Einheiten. Ihr Beispiel „Create Holes Using Hole Wizard and Sketch Points“ rechnet Längen mit 1000 in Millimeter und Winkel mit 57,3 in Grad um. Längen sind also in Metern, Winkel im Bogenmaß, wie bei FeatureManager.HoleWizard5, wo die Hilfe das ausdrücklich sagt.
Eigenschaften und Methoden
Eigenschaften 59, davon 58 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AssemblyFeatureScope | Liest oder setzt, ob eine Bohrung in einer Baugruppe nur auf ausgewählte Komponenten wirkt. |
| AutoSelect | Liest oder setzt, ob eine Bohrung in einem Mehrkörperteil automatisch alle Körper trifft oder nur ausgewählte. |
| AutoSelectComponents | Liest oder setzt, ob eine Bohrung in einer Baugruppe automatisch alle betroffenen Komponenten trifft. |
| CosmeticThreadType | Liest oder setzt die Gewindedarstellung einer Gewinde- oder Rohrgewindebohrung: keine, mit oder ohne Beschriftung. |
| CounterBoreDepth | Liest oder setzt die Tiefe der Flachsenkung einer Bohrung aus dem Bohrungsassistenten, in Metern. |
| CounterBoreDiameter | Liest oder setzt den Durchmesser der Flachsenkung einer Bohrung aus dem Bohrungsassistenten, in Metern. |
| CounterDrillAngle | Liest oder setzt den Winkel der Ansenkung einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß. |
| CounterDrillDepth | Liest oder setzt die Tiefe der Ansenkung einer Bohrung aus dem Bohrungsassistenten, in Metern. |
| CounterDrillDiameter | Liest oder setzt den Durchmesser der Ansenkung einer Bohrung aus dem Bohrungsassistenten, in Metern. |
| CounterSinkAngle | Liest oder setzt den Winkel der Kegelsenkung einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß. |
| CounterSinkDiameter | Liest oder setzt den Durchmesser der Kegelsenkung einer Bohrung aus dem Bohrungsassistenten, in Metern. |
| Depth | Liest oder setzt die Tiefe einer Bohrung aus dem Bohrungsassistenten bei den älteren Bohrungsarten, in Metern. |
| Diameter | Liest oder setzt den Durchmesser einer Bohrung aus dem Bohrungsassistenten bei den älteren Bohrungsarten, in Metern. |
| DrillAngle | Liest oder setzt den Winkel der Bohrspitze einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß. |
| EndCondition | Liest oder setzt die Endbedingung einer Bohrung aus dem Bohrungsassistenten, etwa Blind oder Durch alles. |
| Face | Liefert die Fläche, bis zu der eine Bohrung aus dem Bohrungsassistenten reicht, bei Endbedingung „Bis Fläche“. |
| FarCounterSinkAngle | Liest oder setzt den Winkel der Kegelsenkung an der fernen Seite (unten) einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß. |
| FarCounterSinkDiameter | Liest oder setzt den Durchmesser der Kegelsenkung an der fernen Seite (unten) einer Bohrung aus dem Bohrungsassistenten, in Metern. |
| FarSideCounterSink | Liefert, ob bei einer Bohrung aus dem Bohrungsassistenten die Kegelsenkung an der fernen Seite eingeschaltet ist. Ob man sie setzen kann, ist in der Hilfe widersprüchlich. |
| FastenerSize | Liefert die Größe des Verbindungselements einer Bohrung aus dem Bohrungsassistenten, etwa „M6“. |
| FastenerType | veraltet ersetzt durch WizardHoleFeatureData2.FastenerType2 |
| FastenerType2 | Liefert den Typ des Verbindungselements einer Bohrung aus dem Bohrungsassistenten, etwa eine Sechskantschraube nach ISO. |
| FeatureScope | Liest oder setzt, ob eine Bohrung in einem Mehrkörperteil nur auf bestimmte Körper wirkt. |
| FeatureScopeBodies | Liest oder setzt die Körper eines Mehrkörperteils, auf die eine Bohrung wirkt. |
| HeadClearance | Liest oder setzt den Kopfabstand einer Bohrung aus dem Bohrungsassistenten, in Metern. |
| HeadClearanceType | Liefert, wie der Kopfabstand bei einer Kegelsenkung umgesetzt ist: größere Senkung oder zusätzlicher Absatz. |
| HoleDepth | Liest oder setzt die Tiefe eines Sacklochs aus dem Bohrungsassistenten, in Metern. |
| HoleDiameter | Liest oder setzt den Durchmesser eines Sacklochs aus dem Bohrungsassistenten, in Metern. |
| HoleFit | Liest oder setzt die Passung einer Bohrung mit Flach- oder Kegelsenkung: eng, normal oder lose. |
| Length | Liest oder setzt die Länge eines Langlochs aus dem Bohrungsassistenten, in Metern. |
| MajorDiameter | Liest oder setzt den großen Durchmesser einer kegeligen Bohrung (ältere Bohrungsart) aus dem Bohrungsassistenten, in Metern. |
| MidCounterSinkAngle | Liest oder setzt den Winkel der Kegelsenkung in der Mitte einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß. |
| MidCounterSinkDiameter | Liest oder setzt den Durchmesser der Kegelsenkung in der Mitte einer Bohrung aus dem Bohrungsassistenten, in Metern. |
| MinorDiameter | Liest oder setzt den kleinen Durchmesser einer kegeligen Bohrung (ältere Bohrungsart) aus dem Bohrungsassistenten, in Metern. |
| NearCounterSinkAngle | Liest oder setzt den Winkel der Kegelsenkung an der nahen Seite (oben) einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß. |
| NearCounterSinkDiameter | Liest oder setzt den Durchmesser der Kegelsenkung an der nahen Seite (oben) einer Bohrung aus dem Bohrungsassistenten, in Metern. |
| NearSideCounterSink | Liefert, ob bei einer Bohrung aus dem Bohrungsassistenten die Kegelsenkung an der nahen Seite eingeschaltet ist. Ob man sie setzen kann, ist in der Hilfe widersprüchlich. |
| OffsetDistance | Liest oder setzt den Abstand einer Bohrung aus dem Bohrungsassistenten zur gewählten Fläche oder Ebene. |
| PropagateFeatureToParts | Liest oder setzt, ob eine Bohrung in einer Baugruppe an die Teile weitergegeben wird, die sie trifft. |
| ReverseDirection | Liest oder setzt, ob die Richtung einer Bohrung aus dem Bohrungsassistenten umgekehrt ist. |
| Standard | Liefert die Norm einer Bohrung aus dem Bohrungsassistenten als Text, auch bei einer kopierten oder eigenen Norm. |
| Standard2 | Liefert die Norm einer Bohrung aus dem Bohrungsassistenten als Wert aus swWzdHoleStandards_e, bei eigener Norm -1. |
| TapDrillDepth | Liest oder setzt die Tiefe der Kernlochbohrung einer Gewindebohrung aus dem Bohrungsassistenten, in Metern. |
| TapDrillDiameter | Liest oder setzt den Durchmesser der Kernlochbohrung einer Gewindebohrung aus dem Bohrungsassistenten, in Metern. |
| TapType | Liest oder setzt die Art einer Helicoil-Gewindebohrung aus dem Bohrungsassistenten: Plug oder Bottom. |
| ThreadAngle | Liest oder setzt den Gewindewinkel einer Gewindebohrung aus dem Bohrungsassistenten, im Bogenmaß. |
| ThreadClass | Liest oder setzt die Gewindeklasse einer Gewindebohrung nach ANSI Inch: 1B, 2B oder 3B. |
| ThreadDepth | Liest oder setzt die Gewindetiefe einer Gewindebohrung aus dem Bohrungsassistenten, in Metern. |
| ThreadDiameter | Liest oder setzt den Gewindedurchmesser einer Gewindebohrung aus dem Bohrungsassistenten, in Metern. |
| ThreadEndCondition | Liest oder setzt die Endbedingung des Gewindes einer Gewindebohrung aus dem Bohrungsassistenten: Blind, durch alles oder bis zur nächsten. |
| ThruHoleDepth | Liest oder setzt die Tiefe einer durchgehenden Bohrung aus dem Bohrungsassistenten, in Metern. Setzen ist unzuverlässig. |
| ThruHoleDiameter | Liest oder setzt den Durchmesser einer durchgehenden Bohrung aus dem Bohrungsassistenten, in Metern. |
| ThruTapDrillDepth | Liest oder setzt die Tiefe der Kernlochbohrung einer durchgehenden Gewindebohrung aus dem Bohrungsassistenten, in Metern. Setzen ist unzuverlässig. |
| ThruTapDrillDiameter | Liest oder setzt den Durchmesser der Kernlochbohrung einer durchgehenden Gewindebohrung aus dem Bohrungsassistenten, in Metern. |
| Type | Liefert den genauen Typ einer Bohrung aus dem Bohrungsassistenten, etwa Sackloch oder durchgehende Gewindebohrung. |
| UnderHeadCounterSink | Liest oder setzt, ob eine Bohrung aus dem Bohrungsassistenten eine Kegelsenkung unter dem Kopf hat. |
| UnderHeadCounterSinkAngle | Liest oder setzt den Winkel der Kegelsenkung unter dem Kopf einer Bohrung aus dem Bohrungsassistenten. |
| UnderHeadCounterSinkDiameter | Liest oder setzt den Durchmesser der Kegelsenkung unter dem Kopf einer Bohrung aus dem Bohrungsassistenten. |
| Vertex | Liefert den Eckpunkt, bis zu dem eine Bohrung aus dem Bohrungsassistenten reicht, bei Endbedingung „Bis Eckpunkt“. |
Methoden 10, davon 10 beschrieben
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor die Bohrung zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen. |
| ChangeStandard | Ändert Norm, Typ des Verbindungselements und Größe einer Bohrung aus dem Bohrungsassistenten und damit alle Werte aus der Datenbank. |
| GetEndConditionReference | Liefert das Element, das die Endbedingung einer Bohrung aus dem Bohrungsassistenten festlegt, und seine Art. |
| GetFeatureScopeBodiesCount | Liefert die Zahl der Körper eines Mehrkörperteils, auf die eine Bohrung aus dem Bohrungsassistenten wirkt. |
| GetSketchPointCount | Liefert die Zahl der Skizzenpunkte, an denen eine Bohrung aus dem Bohrungsassistenten sitzt. |
| GetSketchPoints | Liefert die Skizzenpunkte, an denen eine Bohrung aus dem Bohrungsassistenten sitzt. |
| InitializeHole | Belegt eine neu angelegte Definition für eine Bohrung aus dem Bohrungsassistenten mit Art, Norm, Schraube, Größe und Endbedingung vor. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Bohrung nicht geändert hast. |
| RestoreDefaultValues | Setzt die Werte einer Bohrung oder eines Langlochs aus dem Bohrungsassistenten auf die Vorgaben zurück. |
| SetEndConditionReference | Setzt das Element, das die Endbedingung einer Bohrung aus dem Bohrungsassistenten festlegt, etwa eine Fläche oder einen Eckpunkt. |
Nicht aufgeführt sind 6 C++-Varianten (Namen mit I davor, zum Beispiel IAccessSelections). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IWizardHoleFeatureData2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.