SolidWorksMakroprogrammierung

Methode · FeatureManager

HoleWizard5-Methode (FeatureManager)

Erzeugt eine Bohrung oder ein Langloch mit dem Bohrungsassistenten: Senkung, Bohrung, Gewinde nach Norm.

Syntax

Function HoleWizard5( _
   ByVal GenericHoleType As Long, _
   ByVal StandardIndex As Long, _
   ByVal FastenerTypeIndex As Long, _
   ByVal SSize As String, _
   ByVal EndType As Integer, _
   ByVal Diameter As Double, _
   ByVal Depth As Double, _
   ByVal Length As Double, _
   ByVal Value1 As Double, _
   ByVal Value2 As Double, _
   ByVal Value3 As Double, _
   ByVal Value4 As Double, _
   ByVal Value5 As Double, _
   ByVal Value6 As Double, _
   ByVal Value7 As Double, _
   ByVal Value8 As Double, _
   ByVal Value9 As Double, _
   ByVal Value10 As Double, _
   ByVal Value11 As Double, _
   ByVal Value12 As Double, _
   ByVal ThreadClass As String, _
   ByVal RevDir As Boolean, _
   ByVal FeatureScope As Boolean, _
   ByVal AutoSelect As Boolean, _
   ByVal AssemblyFeatureScope As Boolean, _
   ByVal AutoSelectComponents As Boolean, _
   ByVal PropagateFeatureToParts As Boolean _
) As Feature
Set swFeat = swFeatMgr.HoleWizard5(swWzdHole, swStandardISO, swStandardISODrillSizes, "Ø10.0", swEndCondThroughAll, _
        0.01, 0, -1, 1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, "", False, True, True, True, True, False)

Parameter

GenericHoleTypeLongByVal
Art der Bohrung oder des Langlochs, ein Wert aus swWzdGeneralHoleTypes_e, etwa swWzdHole (2), swWzdCounterBore (0) oder swWzdTap (4).
StandardIndexLongByVal
Norm, ein Wert aus swWzdHoleStandards_e, etwa swStandardISO (8) oder swStandardDIN (4).
FastenerTypeIndexLongByVal
Art des Befestigungselements, ein Wert aus swWzdHoleStandardFastenerTypes_e. Muss zur Norm und zur Art passen, sonst gibt es einen Fehler.
SSizeStringByVal
Größe als Text, genau wie im Bohrungsassistenten, etwa "M8". Muss zur Art des Befestigungselements passen.
EndTypeIntegerByVal
Endbedingung, ein Wert aus swEndConditions_e, etwa swEndCondBlind (0) oder swEndCondThroughAll (1).
DiameterDoubleByVal
Durchmesser der Bohrung in Metern.
DepthDoubleByVal
Tiefe in Metern.
LengthDoubleByVal
Nur bei Langlöchern: die Länge in Metern. Sonst -1, siehe Bemerkungen.
Value1DoubleByVal
Werte 1 bis 12: je nach Art der Bohrung unterschiedlich, siehe Bemerkungen. -1 heißt „nicht angegeben“.
Value2DoubleByVal
Wert 2.
Value3DoubleByVal
Wert 3.
Value4DoubleByVal
Wert 4.
Value5DoubleByVal
Wert 5.
Value6DoubleByVal
Wert 6.
Value7DoubleByVal
Wert 7.
Value8DoubleByVal
Wert 8.
Value9DoubleByVal
Wert 9.
Value10DoubleByVal
Wert 10.
Value11DoubleByVal
Wert 11.
Value12DoubleByVal
Wert 12.
ThreadClassStringByVal
Gewindeklasse "1B", "2B" oder "3B", nur bei ANSI Zoll. Sonst "".
RevDirBooleanByVal
True kehrt die Richtung der Bohrung um.
FeatureScopeBooleanByVal
True: das Feature wirkt nur auf bestimmte Körper.
AutoSelectBooleanByVal
True: SOLIDWORKS wählt die betroffenen Körper selbst.
AssemblyFeatureScopeBooleanByVal
Nur in Baugruppen: True, wenn das Feature nur auf ausgewählte Komponenten wirkt.
AutoSelectComponentsBooleanByVal
Nur in Baugruppen: True wählt alle betroffenen Komponenten automatisch.
PropagateFeatureToPartsBooleanByVal
Nur in Baugruppen: True überträgt das Feature in die Teile.

Rückgabewert

Das neue Feature.

Beispiel

' Setzt eine ISO-Bohrung mit 10 mm Durchmesser durch alles an die Stelle, an der ein Strahl die Fläche trifft.
' Vorbedingung: Ein Teil ist geöffnet. Bei x = 0, y = 0 liegt in z-Richtung eine ebene Fläche.
' Ergebnis:     Ein Bohrungsassistent-Feature.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    ' Strahl von z = 1 m in Richtung -z, die erste getroffene Fläche wird mit Markierung 0 gewählt
    If False = swModel.Extension.SelectByRay(0, 0, 1, 0, 0, -1, 0.0005, swSelFACES, False, 0, swSelectOptionDefault) Then
        swApp.SendMsgToUser2 "Keine Fläche getroffen.", swMbWarning, swMbOk
        Exit Sub
    End If

    Set swFeat = swModel.FeatureManager.HoleWizard5(swWzdHole, swStandardISO, swStandardISODrillSizes, "Ø10.0", _
        swEndCondThroughAll, 0.01, 0, -1, _
        swScrewClearanceNormal, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, _
        "", False, True, True, True, True, False)
    If swFeat Is Nothing Then swApp.SendMsgToUser2 "Bohrung nicht erzeugt.", swMbWarning, swMbOk
End Sub

Bemerkungen

Jede Stelle, an der eine Bohrung sitzen soll, wählst du vorher mit ModelDocExtension.SelectByRay und der Markierung 0 aus. Bei Endbedingung swEndCondUpToSelection (10) wählst du zusätzlich die Fläche oder den Eckpunkt mit der Markierung 2 aus.

Die Werte 1 bis 12 hängen von der Art ab:

  • Bohrung und gerades Langloch: Passung (swWzdHoleScrewClearanceTypes_e), Bohrspitzenwinkel, Durchmesser und Winkel der nahen Senkung, Durchmesser und Winkel der fernen Senkung, Abstand (nur bei swEndCondOffsetFromSurface), dann fünfmal -1.
  • Kegelsenkung: Durchmesser und Winkel der nahen Senkung, Kopfabstand, Passung, Bohrspitzenwinkel, Durchmesser und Winkel der fernen Senkung, Abstand, Art des Kopfabstands, dann dreimal -1.
  • Flachsenkung: Durchmesser und Tiefe der Flachsenkung, Kopfabstand, Passung, Bohrspitzenwinkel, nahe Senkung (Durchmesser, Winkel), Senkung unter dem Kopf (Durchmesser, Winkel), ferne Senkung (Durchmesser, Winkel), Abstand.
  • Gewinde und Rohrgewinde: Gewindetiefe, nahe Senkung (Durchmesser, Winkel), ferne Senkung (Durchmesser, Winkel), Bohrspitzenwinkel, Art des kosmetischen Gewindes, Endbedingung des Gewindes, Art des Helicoil-Gewindes, Abstand, dann zweimal -1.

Den Bohrspitzenwinkel gibt es nur, wenn die Bohrung nicht durch alles oder bis zur nächsten Fläche geht. Ohne Angabe nimmt SOLIDWORKS 118°. Die Passung gilt nur, wenn kein Durchmesser angegeben ist. Winkel sind im Bogenmaß, Längen in Metern.

Die Hilfe warnt vor dem Makrorekorder: Bei Gewinden zeichnet er Length nicht richtig auf (dort gehört eine -1 hin, und vor ThreadClass eine -1 weg), und „bis Fläche“, „bis Eckpunkt“ und „bis zur nächsten“ landen mit falschen Zahlen im Code. Nimm am besten nur „Blind“ oder „Durch alles“ auf. Den genauen Text für SSize dagegen liefert der Rekorder zuverlässig. Die Schreibweise "Ø10.0" im Beispiel ist so übernommen und kann je nach Norm abweichen.

Über eine Referenzebene als Ausgangsfläche entscheidet RevDir: Liegt das Material auf einer Seite der Ebene, ist es False. Liegt es auf beiden Seiten, ist es True, wenn das Material in Richtung der Normalen weiter von der Ebene entfernt ist. Vorgänger HoleWizard4 ist veraltet. Für gestapelte Bohrungen gibt es FeatureManager.AdvancedHole2.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2014

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

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