SolidWorksMakroprogrammierung

Objekt · SldWorks

LibraryFeatureData-Objekt

Die Feature-Daten eines Bibliotheks-Features: Bibliotheksteil, Konfiguration, Verknüpfung zum Bibliotheksteil, Platzierungsfläche, Bezüge und Bemaßungen.

Deklaration Dim x As SldWorks.LibraryFeatureData · in der englischen .NET-Hilfe: ILibraryFeatureData

Beschreibung

LibraryFeatureData gibt Zugriff auf die Daten eines Bibliotheks-Features. Ein Bibliotheks-Feature fügst du aus einem Bibliotheksteil (Datei .sldlfp, etwa aus der Konstruktionsbibliothek) in ein Teil ein. Es sitzt auf einer Fläche oder Ebene und wird über Bezüge und Positionsbemaßungen ausgerichtet. Die meisten Befehle gibt es seit SOLIDWORKS 2006.

Zugriff

Beispiel

' Gibt für jedes Bibliotheks-Feature des aktiven Teils Bibliotheksteil,
' Konfiguration, Verknüpfung, Platzierung, Bemaßungen und Bezüge aus.
' Vorbedingung: Ein Teil mit mindestens einem Bibliotheks-Feature ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster (Strg+G), das Teil bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swFeat As SldWorks.Feature
    Dim swDaten As SldWorks.LibraryFeatureData
    Dim swFlaeche As Object
    Dim nArt As Long
    Dim vNamen As Variant, vWerte As Variant
    Dim vBezuege As Variant, vTypen As Variant, vBezNamen As Variant
    Dim i As Long

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

    Set swFeat = swModel.FirstFeature
    Do While Not swFeat Is Nothing
        If swFeat.GetTypeName2 = "LibraryFeature" Then
            Set swDaten = swFeat.GetDefinition
            If swDaten.AccessSelections(swModel, Nothing) Then
                Debug.Print swFeat.Name & " aus " & swDaten.LibraryPart
                Debug.Print "  Konfiguration: " & swDaten.ConfigurationName & _
                            ", verknüpft: " & swDaten.LinkToLibraryPart
                Set swFlaeche = swDaten.GetPlacementPlane2(swLibFeatureData_PartRespect, nArt)
                Debug.Print "  Platziert auf Element vom Typ " & nArt & " (swSelectType_e)"

                vWerte = swDaten.GetDimensions(swLibFeatLocatingDimension, vNamen)
                If Not IsEmpty(vNamen) Then
                    For i = 0 To UBound(vNamen)
                        Debug.Print "  Position " & vNamen(i) & " = " & vWerte(i)
                    Next i
                End If
                vWerte = swDaten.GetDimensions(swLibFeatSizeDimension, vNamen)
                If Not IsEmpty(vNamen) Then
                    For i = 0 To UBound(vNamen)
                        Debug.Print "  Größe " & vNamen(i) & " = " & vWerte(i)
                    Next i
                End If

                vBezuege = swDaten.GetReferences3(swLibFeatureData_PartRespect, vTypen, vBezNamen)
                If Not IsEmpty(vTypen) Then
                    For i = 0 To UBound(vTypen)
                        Debug.Print "  Bezug " & vBezNamen(i) & ", Typ " & vTypen(i)
                    Next i
                End If
                swDaten.ReleaseSelectionAccess
            End If
        End If
        Set swFeat = swFeat.GetNextFeature
    Loop
End Sub

Bemerkungen

Hilfebeispiele: „Get Library Feature Data“ durchläuft den FeatureManager, ruft bei jedem Feature vom Typ LibraryFeature LibraryFeatureData.AccessSelections auf, liest Platzierung, Konfigurationen, Verknüpfung, Positions- und Größenbemaßungen und Bezüge, wählt Platzierung und Bezüge aus und gibt den Zugriff mit LibraryFeatureData.ReleaseSelectionAccess frei. „Create Library Feature With References“ legt ein Teil mit einem Quader an, füllt die Daten mit LibraryFeatureData.Initialize aus straight slot.sldlfp, setzt die Konfiguration, wählt die Fläche, legt das Feature an und setzt danach mit LibraryFeatureData.SetReferences zwei Kanten als Bezüge. Die Bezugstypen liest es dort noch mit dem veralteten GetReferences2.

Anlegen: Das Programmierhandbuch („Library Features and LibraryFeatureData Objects“) beschreibt dieses Vorgehen:

Ändern: Rufe erst LibraryFeatureData.AccessSelections auf und übernimm Änderungen mit Feature.ModifyDefinition. Ohne Änderung hebst du den Zustand mit LibraryFeatureData.ReleaseSelectionAccess auf.

Sicht: Bezüge und Platzierung liest du mit einem Wert aus swLibFeatureData_e, bezogen auf das Bibliotheks-Feature oder auf das Teil. Bemaßungen fragst du mit swLibFeatDimensionType_e getrennt nach Positions- und Größenbemaßungen ab.

Einheiten: In welcher Einheit die Bemaßungen kommen, sagt die Hilfe nicht. Die Bemaßungen sind in Meter (Konfiguration „12.2 X 24.4“ ergab Width 0,0122 und Length 0,0244, Lagemaß 0.03 setzte die Nut 30 mm von der Kante). Winkel sind vermutlich im Bogenmaß.

Eigenschaften und Methoden

Eigenschaften 4, davon 4 beschrieben

NameBeschreibung
ConfigurationNameLiest oder setzt den Namen der aktiven Konfiguration des Bibliotheksteils, die das Bibliotheks-Feature verwendet.
LibraryPartLiefert Pfad und Dateinamen des Bibliotheksteils, aus dem das Bibliotheks-Feature stammt.
LinkToLibraryPartLiest oder setzt, ob das Bibliotheks-Feature mit seinem Bibliotheksteil verknüpft ist.
OverrideDimensionLiest oder setzt, ob die vorhandenen Werte der Größenbemaßungen des Bibliotheks-Features überschrieben werden.

Methoden 16, davon 13 beschrieben, 3 veraltet

NameBeschreibung
AccessSelectionsSetzt das Modell vor das Bibliotheks-Feature zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen.
GetAllConfigurationNamesLiefert die Namen der Konfigurationen des Bibliotheksteils.
GetConfigurationCountLiefert die Zahl der Konfigurationen des Bibliotheksteils.
GetDimensionsLiefert Namen und Werte der Positions- oder Größenbemaßungen des Bibliotheks-Features.
GetDimensionsCountLiefert die Zahl der Positions- oder Größenbemaßungen des Bibliotheks-Features.
GetPlacementPlaneveraltet ersetzt durch LibraryFeatureData.GetPlacementPlane2
GetPlacementPlane2Liefert die Fläche oder Ebene, auf der das Bibliotheks-Feature platziert ist, und ihren Typ.
GetReferencesveraltet ersetzt durch LibraryFeatureData.GetReferences3
GetReferences2veraltet ersetzt durch LibraryFeatureData.GetReferences3
GetReferences3Liefert die Bezüge des Bibliotheks-Features mit ihren Typen und Namen.
GetReferencesCountLiefert die Zahl der Bezüge des Bibliotheks-Features.
InitializeFüllt neu erzeugte Daten eines Bibliotheks-Features mit einem Bibliotheksteil.
ReleaseSelectionAccessHebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Bibliotheks-Feature nicht geändert hast.
SetDimensionSetzt den Wert einer Positions- oder Größenbemaßung des Bibliotheks-Features.
SetPlacementPlaneSetzt die Fläche oder Ebene, auf der das Bibliotheks-Feature platziert wird.
SetReferencesSetzt die Bezüge, mit denen das Bibliotheks-Feature auf dem Teil ausgerichtet wird.

Nicht aufgeführt sind 6 C++-Varianten (Namen mit I davor, zum Beispiel IGetAllConfigurationNames). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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