Objekt · SldWorks
AdvancedHoleElementData-Objekt
Die allgemeinen Daten eines Elements einer erweiterten Bohrung: Art, Norm, Größe, Durchmesser, Endbedingung und Beschriftung.
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
ModelDocExtension.CreateAdvancedHoleElementData: ein neues Element fürFeatureManager.AdvancedHole2AdvancedHoleFeatureData.GetNearSideElementsundAdvancedHoleFeatureData.GetFarSideElements: die Elemente einer vorhandenen erweiterten Bohrung (TypnameAdvHoleWzd, Daten ausFeature.GetDefinition)
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| BlindDepth | Liest oder setzt die Tiefe eines Elements einer erweiterten Bohrung bei der Endbedingung Blind, in Metern. |
| CalloutString | Liest oder setzt die eigene Bohrungsbeschriftung eines Elements einer erweiterten Bohrung. |
| Diameter | Liest oder setzt den Durchmesser eines Elements einer erweiterten Bohrung, in Metern. Gilt nur mit DiameterOverride. |
| DiameterOverride | Liest oder setzt, ob der Durchmesser eines Elements einer erweiterten Bohrung überschrieben wird. |
| ElementType | Liefert die Art eines Elements einer erweiterten Bohrung, etwa Flachsenkung oder Gewinde. |
| EndCondition | Liest oder setzt die Endbedingung eines Elements einer erweiterten Bohrung, etwa Blind oder Bis nächste. |
| FastenerType | Liest oder setzt den Typ des Verbindungselements für ein Element einer erweiterten Bohrung, etwa Sechskantschraube nach ISO. |
| OffsetDistance | Liest oder setzt den Abstand eines Elements einer erweiterten Bohrung bei der Endbedingung „Abstand von Fläche“. |
| OffsetReverseDirection | Liest oder setzt, ob bei „Abstand von Fläche“ der Abstand eines Elements einer erweiterten Bohrung in die Gegenrichtung zeigt. |
| Orientation | Liest oder setzt die Ausrichtung eines Elements einer erweiterten Bohrung, zur nahen oder zur fernen Seite. |
| SelectionEntity | Liest oder setzt die Fläche, Ebene, Kante oder den Eckpunkt, auf den sich die Endbedingung eines Elements einer erweiterten Bohrung bezieht. |
| Size | Liest oder setzt die Größe eines Elements einer erweiterten Bohrung, etwa „M8“ oder „#4-40“. |
| Standard | Liest 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.