Objekt · SldWorks
LibraryFeatureData-Objekt
Die Feature-Daten eines Bibliotheks-Features: Bibliotheksteil, Konfiguration, Verknüpfung zum Bibliotheksteil, Platzierungsfläche, Bezüge und Bemaßungen.
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
FeatureManager.CreateDefinitionmitswFmLibraryFeature: Daten für ein neues Bibliotheks-Feature, die du mitLibraryFeatureData.Initializefüllst und mitFeatureManager.CreateFeatureanlegstFeature.GetDefinition: aus einem vorhandenen Bibliotheks-Feature (TypnameLibraryFeature)
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 SubBemerkungen
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:
- Daten mit
FeatureManager.CreateDefinitionundswFmLibraryFeatureerzeugen. - Mit
LibraryFeatureData.Initializeund dem Bibliotheksteil füllen. Dabei wird die zuletzt aktive Konfiguration geöffnet. - Bei Bedarf eine andere Konfiguration aus
LibraryFeatureData.GetAllConfigurationNamesmitLibraryFeatureData.ConfigurationNamesetzen. Das initialisiert die Daten neu. - Mit
LibraryFeatureData.LinkToLibraryPartfestlegen, ob das Feature mit dem Bibliotheksteil verknüpft bleibt. - Die nötigen Bezugstypen mit
LibraryFeatureData.GetReferences3und die Positionsbemaßungen mitLibraryFeatureData.GetDimensionslesen. - Den Platz mit
ModelDocExtension.SelectByID2auswählen und das Feature mitFeatureManager.CreateFeatureanlegen.
Ä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
| Name | Beschreibung |
|---|---|
| ConfigurationName | Liest oder setzt den Namen der aktiven Konfiguration des Bibliotheksteils, die das Bibliotheks-Feature verwendet. |
| LibraryPart | Liefert Pfad und Dateinamen des Bibliotheksteils, aus dem das Bibliotheks-Feature stammt. |
| LinkToLibraryPart | Liest oder setzt, ob das Bibliotheks-Feature mit seinem Bibliotheksteil verknüpft ist. |
| OverrideDimension | Liest oder setzt, ob die vorhandenen Werte der Größenbemaßungen des Bibliotheks-Features überschrieben werden. |
Methoden 16, davon 13 beschrieben, 3 veraltet
| Name | Beschreibung |
|---|---|
| AccessSelections | Setzt das Modell vor das Bibliotheks-Feature zurück, damit du die Auswahlen lesen und ändern kannst, die es festlegen. |
| GetAllConfigurationNames | Liefert die Namen der Konfigurationen des Bibliotheksteils. |
| GetConfigurationCount | Liefert die Zahl der Konfigurationen des Bibliotheksteils. |
| GetDimensions | Liefert Namen und Werte der Positions- oder Größenbemaßungen des Bibliotheks-Features. |
| GetDimensionsCount | Liefert die Zahl der Positions- oder Größenbemaßungen des Bibliotheks-Features. |
| GetPlacementPlane | veraltet ersetzt durch LibraryFeatureData.GetPlacementPlane2 |
| GetPlacementPlane2 | Liefert die Fläche oder Ebene, auf der das Bibliotheks-Feature platziert ist, und ihren Typ. |
| GetReferences | veraltet ersetzt durch LibraryFeatureData.GetReferences3 |
| GetReferences2 | veraltet ersetzt durch LibraryFeatureData.GetReferences3 |
| GetReferences3 | Liefert die Bezüge des Bibliotheks-Features mit ihren Typen und Namen. |
| GetReferencesCount | Liefert die Zahl der Bezüge des Bibliotheks-Features. |
| Initialize | Füllt neu erzeugte Daten eines Bibliotheks-Features mit einem Bibliotheksteil. |
| ReleaseSelectionAccess | Hebt den Rücksetz-Zustand nach AccessSelections wieder auf, wenn du das Bibliotheks-Feature nicht geändert hast. |
| SetDimension | Setzt den Wert einer Positions- oder Größenbemaßung des Bibliotheks-Features. |
| SetPlacementPlane | Setzt die Fläche oder Ebene, auf der das Bibliotheks-Feature platziert wird. |
| SetReferences | Setzt 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.