SolidWorksMakroprogrammierung

Objekt · SldWorks

AdvancedHoleElementData-Objekt

Die allgemeinen Daten eines Elements einer erweiterten Bohrung: Art, Norm, Größe, Durchmesser, Endbedingung und Beschriftung.

Deklaration Dim x As SldWorks.AdvancedHoleElementData · in der englischen .NET-Hilfe: IAdvancedHoleElementData

Beschreibung

Eine erweiterte Bohrung (Advanced Hole) besteht aus Elementen, die von der nahen und von der fernen Seite aus gestapelt sind: Flachsenkung, Kegelsenkung, Bohrung, Gewinde oder kegeliges Gewinde. Jedes Element ist ein AdvancedHoleElementData-Objekt mit den Werten, die alle Arten haben. Die Werte, die nur zu einer Art gehören, liegen in Objekten, die AdvancedHoleElementData erweitern: CounterboreElementData, CountersinkElementData, StraightElementData, StraightTapElementData und TaperedTapElementData. In VBA weist du das Element dazu einer Variablen dieses Typs zu.

Zugriff

Beispiel

' Gibt Art, Norm, Größe, Durchmesser und Endbedingung aller Elemente aus.
' Vorbedingung: Ein Teil ist offen, eine erweiterte Bohrung ist im FeatureManager ausgewählt.
' Ergebnis:     Eine Zeile je Element im Direktfenster (Strg+G).
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 swDaten As SldWorks.AdvancedHoleFeatureData

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing 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 <> "AdvHoleWzd" Then
        Debug.Print "Keine erweiterte Bohrung ausgewählt."
        Exit Sub
    End If

    Set swDaten = swFeat.GetDefinition
    If False = swDaten.AccessSelections(swModel, Nothing) Then Exit Sub
    Ausgeben "Nahe Seite", swDaten.GetNearSideElements
    Ausgeben "Ferne Seite", swDaten.GetFarSideElements
    swDaten.ReleaseSelectionAccess
End Sub

Sub Ausgeben(ByVal sSeite As String, ByVal vElemente As Variant)
    Dim swElem As SldWorks.AdvancedHoleElementData
    Dim i As Long
    If Not IsArray(vElemente) Then Exit Sub
    For i = 0 To UBound(vElemente)
        Set swElem = vElemente(i)
        Debug.Print sSeite & " " & i + 1 & ": Art " & swElem.ElementType & ", Norm " & swElem.Standard & _
            ", Größe " & swElem.Size & ", Ø " & swElem.Diameter * 1000 & " mm, Endbedingung " & swElem.EndCondition
    Next i
End Sub

Bemerkungen

Neue Bohrung: Bei FeatureManager.AdvancedHole2 wählst du zuerst die nahe und die ferne Fläche aus. Dann legst du für jedes Element mit ModelDocExtension.CreateAdvancedHoleElementData ein Objekt an und setzt seine Werte. Die Elemente kommen je Seite in ein Array, von der Fläche nach innen, und gehen an AdvancedHole2.

Ändern: Das Hilfebeispiel „Create Advanced Hole Feature“ holt mit Feature.GetDefinition das AdvancedHoleFeatureData, ruft AdvancedHoleFeatureData.AccessSelections auf und liest die Elemente. Ein geändertes Array übergibt es mit AdvancedHoleFeatureData.SetNearSideElements und übernimmt alles mit Feature.ModifyDefinition. Ohne Änderung gibst du den Zugriff mit AdvancedHoleFeatureData.ReleaseSelectionAccess wieder frei, wie im Beispiel oben.

Wann ein Wert gilt: Viele Eigenschaften wirken nur unter Bedingungen. Endbedingung und Tiefe hängen von AdvancedHoleFeatureData.UseBaselineDimensions und vom EndConditionOverride des passenden Objekts ab. Der Durchmesser gilt nur mit DiameterOverride. Abstand, Richtung und Bezugselement gelten nur bei den passenden Endbedingungen, die Beschriftung nur mit AdvancedHoleFeatureData.CustomizeCallout. Die Ausrichtung gilt nicht für Bohrung und Gewinde. Einzelheiten stehen auf den Seiten der Eigenschaften.

Eigenschaften und Methoden

Eigenschaften 13, davon 13 beschrieben

NameBeschreibung
BlindDepthLiest oder setzt die Tiefe eines Elements einer erweiterten Bohrung bei der Endbedingung Blind, in Metern.
CalloutStringLiest oder setzt die eigene Bohrungsbeschriftung eines Elements einer erweiterten Bohrung.
DiameterLiest oder setzt den Durchmesser eines Elements einer erweiterten Bohrung, in Metern. Gilt nur mit DiameterOverride.
DiameterOverrideLiest oder setzt, ob der Durchmesser eines Elements einer erweiterten Bohrung überschrieben wird.
ElementTypeLiefert die Art eines Elements einer erweiterten Bohrung, etwa Flachsenkung oder Gewinde.
EndConditionLiest oder setzt die Endbedingung eines Elements einer erweiterten Bohrung, etwa Blind oder Bis nächste.
FastenerTypeLiest oder setzt den Typ des Verbindungselements für ein Element einer erweiterten Bohrung, etwa Sechskantschraube nach ISO.
OffsetDistanceLiest oder setzt den Abstand eines Elements einer erweiterten Bohrung bei der Endbedingung „Abstand von Fläche“.
OffsetReverseDirectionLiest oder setzt, ob bei „Abstand von Fläche“ der Abstand eines Elements einer erweiterten Bohrung in die Gegenrichtung zeigt.
OrientationLiest oder setzt die Ausrichtung eines Elements einer erweiterten Bohrung, zur nahen oder zur fernen Seite.
SelectionEntityLiest oder setzt die Fläche, Ebene, Kante oder den Eckpunkt, auf den sich die Endbedingung eines Elements einer erweiterten Bohrung bezieht.
SizeLiest oder setzt die Größe eines Elements einer erweiterten Bohrung, etwa „M8“ oder „#4-40“.
StandardLiest oder setzt die Norm eines Elements einer erweiterten Bohrung, etwa ISO oder ANSI Inch.

Siehe auch

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

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