SolidWorksMakroprogrammierung

Objekt · SldWorks

WizardHoleFeatureData2-Objekt

Die Feature-Daten einer Bohrung oder eines Langlochs aus dem Bohrungsassistenten: Typ, Norm, Schraube, Maße und Endbedingung.

Deklaration Dim x As SldWorks.WizardHoleFeatureData2 · in der englischen .NET-Hilfe: IWizardHoleFeatureData2

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

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 Sub

Bemerkungen

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

NameBeschreibung
AssemblyFeatureScopeLiest oder setzt, ob eine Bohrung in einer Baugruppe nur auf ausgewählte Komponenten wirkt.
AutoSelectLiest oder setzt, ob eine Bohrung in einem Mehrkörperteil automatisch alle Körper trifft oder nur ausgewählte.
AutoSelectComponentsLiest oder setzt, ob eine Bohrung in einer Baugruppe automatisch alle betroffenen Komponenten trifft.
CosmeticThreadTypeLiest oder setzt die Gewindedarstellung einer Gewinde- oder Rohrgewindebohrung: keine, mit oder ohne Beschriftung.
CounterBoreDepthLiest oder setzt die Tiefe der Flachsenkung einer Bohrung aus dem Bohrungsassistenten, in Metern.
CounterBoreDiameterLiest oder setzt den Durchmesser der Flachsenkung einer Bohrung aus dem Bohrungsassistenten, in Metern.
CounterDrillAngleLiest oder setzt den Winkel der Ansenkung einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß.
CounterDrillDepthLiest oder setzt die Tiefe der Ansenkung einer Bohrung aus dem Bohrungsassistenten, in Metern.
CounterDrillDiameterLiest oder setzt den Durchmesser der Ansenkung einer Bohrung aus dem Bohrungsassistenten, in Metern.
CounterSinkAngleLiest oder setzt den Winkel der Kegelsenkung einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß.
CounterSinkDiameterLiest oder setzt den Durchmesser der Kegelsenkung einer Bohrung aus dem Bohrungsassistenten, in Metern.
DepthLiest oder setzt die Tiefe einer Bohrung aus dem Bohrungsassistenten bei den älteren Bohrungsarten, in Metern.
DiameterLiest oder setzt den Durchmesser einer Bohrung aus dem Bohrungsassistenten bei den älteren Bohrungsarten, in Metern.
DrillAngleLiest oder setzt den Winkel der Bohrspitze einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß.
EndConditionLiest oder setzt die Endbedingung einer Bohrung aus dem Bohrungsassistenten, etwa Blind oder Durch alles.
FaceLiefert die Fläche, bis zu der eine Bohrung aus dem Bohrungsassistenten reicht, bei Endbedingung „Bis Fläche“.
FarCounterSinkAngleLiest oder setzt den Winkel der Kegelsenkung an der fernen Seite (unten) einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß.
FarCounterSinkDiameterLiest oder setzt den Durchmesser der Kegelsenkung an der fernen Seite (unten) einer Bohrung aus dem Bohrungsassistenten, in Metern.
FarSideCounterSinkLiefert, 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.
FastenerSizeLiefert die Größe des Verbindungselements einer Bohrung aus dem Bohrungsassistenten, etwa „M6“.
FastenerTypeveraltet ersetzt durch WizardHoleFeatureData2.FastenerType2
FastenerType2Liefert den Typ des Verbindungselements einer Bohrung aus dem Bohrungsassistenten, etwa eine Sechskantschraube nach ISO.
FeatureScopeLiest oder setzt, ob eine Bohrung in einem Mehrkörperteil nur auf bestimmte Körper wirkt.
FeatureScopeBodiesLiest oder setzt die Körper eines Mehrkörperteils, auf die eine Bohrung wirkt.
HeadClearanceLiest oder setzt den Kopfabstand einer Bohrung aus dem Bohrungsassistenten, in Metern.
HeadClearanceTypeLiefert, wie der Kopfabstand bei einer Kegelsenkung umgesetzt ist: größere Senkung oder zusätzlicher Absatz.
HoleDepthLiest oder setzt die Tiefe eines Sacklochs aus dem Bohrungsassistenten, in Metern.
HoleDiameterLiest oder setzt den Durchmesser eines Sacklochs aus dem Bohrungsassistenten, in Metern.
HoleFitLiest oder setzt die Passung einer Bohrung mit Flach- oder Kegelsenkung: eng, normal oder lose.
LengthLiest oder setzt die Länge eines Langlochs aus dem Bohrungsassistenten, in Metern.
MajorDiameterLiest oder setzt den großen Durchmesser einer kegeligen Bohrung (ältere Bohrungsart) aus dem Bohrungsassistenten, in Metern.
MidCounterSinkAngleLiest oder setzt den Winkel der Kegelsenkung in der Mitte einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß.
MidCounterSinkDiameterLiest oder setzt den Durchmesser der Kegelsenkung in der Mitte einer Bohrung aus dem Bohrungsassistenten, in Metern.
MinorDiameterLiest oder setzt den kleinen Durchmesser einer kegeligen Bohrung (ältere Bohrungsart) aus dem Bohrungsassistenten, in Metern.
NearCounterSinkAngleLiest oder setzt den Winkel der Kegelsenkung an der nahen Seite (oben) einer Bohrung aus dem Bohrungsassistenten, im Bogenmaß.
NearCounterSinkDiameterLiest oder setzt den Durchmesser der Kegelsenkung an der nahen Seite (oben) einer Bohrung aus dem Bohrungsassistenten, in Metern.
NearSideCounterSinkLiefert, 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.
OffsetDistanceLiest oder setzt den Abstand einer Bohrung aus dem Bohrungsassistenten zur gewählten Fläche oder Ebene.
PropagateFeatureToPartsLiest oder setzt, ob eine Bohrung in einer Baugruppe an die Teile weitergegeben wird, die sie trifft.
ReverseDirectionLiest oder setzt, ob die Richtung einer Bohrung aus dem Bohrungsassistenten umgekehrt ist.
StandardLiefert die Norm einer Bohrung aus dem Bohrungsassistenten als Text, auch bei einer kopierten oder eigenen Norm.
Standard2Liefert die Norm einer Bohrung aus dem Bohrungsassistenten als Wert aus swWzdHoleStandards_e, bei eigener Norm -1.
TapDrillDepthLiest oder setzt die Tiefe der Kernlochbohrung einer Gewindebohrung aus dem Bohrungsassistenten, in Metern.
TapDrillDiameterLiest oder setzt den Durchmesser der Kernlochbohrung einer Gewindebohrung aus dem Bohrungsassistenten, in Metern.
TapTypeLiest oder setzt die Art einer Helicoil-Gewindebohrung aus dem Bohrungsassistenten: Plug oder Bottom.
ThreadAngleLiest oder setzt den Gewindewinkel einer Gewindebohrung aus dem Bohrungsassistenten, im Bogenmaß.
ThreadClassLiest oder setzt die Gewindeklasse einer Gewindebohrung nach ANSI Inch: 1B, 2B oder 3B.
ThreadDepthLiest oder setzt die Gewindetiefe einer Gewindebohrung aus dem Bohrungsassistenten, in Metern.
ThreadDiameterLiest oder setzt den Gewindedurchmesser einer Gewindebohrung aus dem Bohrungsassistenten, in Metern.
ThreadEndConditionLiest oder setzt die Endbedingung des Gewindes einer Gewindebohrung aus dem Bohrungsassistenten: Blind, durch alles oder bis zur nächsten.
ThruHoleDepthLiest oder setzt die Tiefe einer durchgehenden Bohrung aus dem Bohrungsassistenten, in Metern. Setzen ist unzuverlässig.
ThruHoleDiameterLiest oder setzt den Durchmesser einer durchgehenden Bohrung aus dem Bohrungsassistenten, in Metern.
ThruTapDrillDepthLiest oder setzt die Tiefe der Kernlochbohrung einer durchgehenden Gewindebohrung aus dem Bohrungsassistenten, in Metern. Setzen ist unzuverlässig.
ThruTapDrillDiameterLiest oder setzt den Durchmesser der Kernlochbohrung einer durchgehenden Gewindebohrung aus dem Bohrungsassistenten, in Metern.
TypeLiefert den genauen Typ einer Bohrung aus dem Bohrungsassistenten, etwa Sackloch oder durchgehende Gewindebohrung.
UnderHeadCounterSinkLiest oder setzt, ob eine Bohrung aus dem Bohrungsassistenten eine Kegelsenkung unter dem Kopf hat.
UnderHeadCounterSinkAngleLiest oder setzt den Winkel der Kegelsenkung unter dem Kopf einer Bohrung aus dem Bohrungsassistenten.
UnderHeadCounterSinkDiameterLiest oder setzt den Durchmesser der Kegelsenkung unter dem Kopf einer Bohrung aus dem Bohrungsassistenten.
VertexLiefert den Eckpunkt, bis zu dem eine Bohrung aus dem Bohrungsassistenten reicht, bei Endbedingung „Bis Eckpunkt“.

Methoden 10, davon 10 beschrieben

NameBeschreibung
AccessSelectionsSetzt 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.
GetEndConditionReferenceLiefert das Element, das die Endbedingung einer Bohrung aus dem Bohrungsassistenten festlegt, und seine Art.
GetFeatureScopeBodiesCountLiefert die Zahl der Körper eines Mehrkörperteils, auf die eine Bohrung aus dem Bohrungsassistenten wirkt.
GetSketchPointCountLiefert die Zahl der Skizzenpunkte, an denen eine Bohrung aus dem Bohrungsassistenten sitzt.
GetSketchPointsLiefert die Skizzenpunkte, an denen eine Bohrung aus dem Bohrungsassistenten sitzt.
InitializeHoleBelegt eine neu angelegte Definition für eine Bohrung aus dem Bohrungsassistenten mit Art, Norm, Schraube, Größe und Endbedingung vor.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du die Bohrung nicht geändert hast.
RestoreDefaultValuesSetzt die Werte einer Bohrung oder eines Langlochs aus dem Bohrungsassistenten auf die Vorgaben zurück.
SetEndConditionReferenceSetzt 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.