Objekt · SldWorks
Component2-Objekt
Steht für eine Komponente in einer Baugruppe, also ein verbautes Teil oder eine Unterbaugruppe.
Beschreibung
Jeder Eintrag einer Baugruppe, der auf ein Teil oder eine Unterbaugruppe verweist, ist eine Komponente. Ist dieselbe Datei dreimal verbaut, gibt es drei Komponenten, etwa Welle-1, Welle-2 und Welle-3, aber nur ein Modell dahinter.
Die Komponente beschreibt das Teil so, wie es in der Baugruppe sitzt: Name im Baum, verwendete Konfiguration, unterdrückt oder nicht, Lage. Was in der Datei selbst steht, etwa Features oder Dateieigenschaften, liefert das ModelDoc2, das du mit Component2.GetModelDoc2 bekommst.
Die Angaben einer Komponente hängen von der aktiven Konfiguration der Baugruppe ab.
Zugriff
AssemblyDoc.GetComponents: alle Komponenten einer BaugruppeConfiguration.GetRootComponent3und danachComponent2.GetChildren: die Baugruppe Ebene für EbeneAssemblyDoc.GetComponentByName: eine Komponente über ihren NamenSelectionMgr.GetSelectedObject6: eine im FeatureManager angeklickte Komponente, TypswSelCOMPONENTS
Beispiel
' Zeigt Name, Datei und Konfiguration der im FeatureManager angeklickten Komponente.
' Vorbedingung: In einer Baugruppe ist im FeatureManager eine Komponente angeklickt.
' Ergebnis: Meldung mit den drei Angaben.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swSelMgr As SldWorks.SelectionMgr
Dim swComp As SldWorks.Component2
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swSelMgr = swModel.SelectionManager
If swSelMgr.GetSelectedObjectType3(1, -1) <> swSelCOMPONENTS Then
swApp.SendMsgToUser2 "Bitte eine Komponente im FeatureManager anklicken.", swMbWarning, swMbOk
Exit Sub
End If
Set swComp = swSelMgr.GetSelectedObject6(1, -1)
swApp.SendMsgToUser2 "Name: " & swComp.Name2 & vbCrLf & _
"Datei: " & swComp.GetPathName & vbCrLf & _
"Konfiguration: " & swComp.ReferencedConfiguration, swMbInformation, swMbOk
End SubBemerkungen
Unterdrückte und reduziert geladene Komponenten liefern nur einen Teil der Daten. Component2.GetModelDoc2 gibt dann unter Umständen Nothing zurück. Prüf den Zustand mit Component2.GetSuppression2, bevor du an das Modell gehst.
Name und Pfad gehen auch bei unterdrückten Komponenten. Component2.GetPathName liefert dann den Pfad, unter dem die Datei zuletzt gespeichert war.
Viele ältere Befehle wie Name, GetModelDoc oder GetSuppression sind veraltet. Ihre Nachfolger enden auf 2.
Eigenschaften und Methoden
Eigenschaften 19, davon 15 beschrieben, 4 veraltet
| Name | Beschreibung |
|---|---|
| ComponentReference | Liefert oder setzt die Komponentenreferenz, einen frei wählbaren Zusatz zum Namen einer Komponente. |
| CustomPropertyManager | Liefert den CustomPropertyManager mit den Eigenschaften einer Komponente in einer Konfiguration. |
| DisplayTitle | Liefert den Titel einer Komponente, wie er im FeatureManager steht. |
| ExcludeFromBOM | veraltet ersetzt durch Component2.GetExcludeFromBOM2 und Component2.SetExcludeFromBOM2 |
| IsGraphicsOnly | Liefert, ob eine Komponente nur als Grafik vorliegt. |
| IsSpeedPak | Liefert, ob die aktive Konfiguration einer Komponente eine SpeedPak-Konfiguration ist. |
| IsVirtual | Liefert, ob eine Komponente virtuell ist, also nur in der Baugruppe gespeichert. |
| MaterialPropertyValues | Liefert oder setzt Farbe und Lichteigenschaften einer Komponente in der aktiven Konfiguration. |
| Name | veraltet ersetzt durch Component2.Name2 |
| Name2 | Liefert oder ändert den Namen einer Komponente im Baum, etwa "Welle-1", bei Unterbaugruppen mit dem Pfad davor. |
| PresentationTransform | Liefert oder setzt eine Lage, in der eine Komponente nur angezeigt wird, ohne die Geometrie zu verschieben. |
| ReferencedConfiguration | Liefert oder ändert die Konfiguration, mit der eine Komponente in der Baugruppe verbaut ist. |
| ReferencedDisplayState | veraltet ersetzt durch Component2.ReferencedDisplayState2 |
| ReferencedDisplayState2 | Liefert oder setzt den Anzeigezustand, den eine Komponente nutzt. |
| Solving | Liefert, ob eine Unterbaugruppe starr oder flexibel gelöst wird. |
| Transform | veraltet ersetzt durch Component2.Transform2 |
| Transform2 | Liefert oder setzt die Lage einer Komponente in der Baugruppe. |
| UseNamedConfiguration | Liefert, ob eine Komponente eine fest angegebene Konfiguration nutzt oder die zuletzt aktive. |
| Visible | Liefert oder setzt, ob eine Komponente sichtbar oder ausgeblendet ist. |
Methoden 116, davon 94 beschrieben, 22 veraltet
| Name | Beschreibung |
|---|---|
| AddPropertyExtension | Hängt einen eigenen Wert (Zahl oder Text) an eine Komponente. |
| DeSelect | Hebt die Auswahl einer Komponente auf. |
| EnumBodies | veraltet ersetzt durch Component2.EnumBodies3 |
| EnumBodies2 | veraltet ersetzt durch Component2.EnumBodies3 |
| EnumBodies3 | Liefert die Körper einer Komponente als Aufzählung (EnumBodies2). |
| EnumRelatedBodies | Liefert die Körper der Referenzflächen einer Komponente als Aufzählung. |
| EnumSectionedBodies | Liefert die geschnittenen Körper einer Komponente in einer Schnittansicht als Aufzählung. |
| FeatureByName | Liefert ein Feature einer Komponente über seinen Namen. |
| FindAttribute | Sucht an einer Komponente ein Attribut mit einer bestimmten Definition. |
| FirstFeature | Liefert das erste Feature einer Komponente, als Start für das Durchlaufen ihres Feature-Baums. |
| GetBodies | veraltet ersetzt durch Component2.GetBodies3 |
| GetBodies2 | veraltet ersetzt durch Component2.GetBodies3 |
| GetBodies3 | Liefert die Körper einer Komponente als Array. |
| GetBody | Liefert den Körper einer Teil-Komponente, so wie er in dieser Baugruppe aussieht. |
| GetBox | Liefert einen Quader, der die Komponente umschließt. |
| GetChildren | Liefert die Komponenten eine Ebene unter einer Komponente, etwa die Teile einer Unterbaugruppe. |
| GetConfigurationCount | Liefert die Anzahl der Konfigurationen einer reduziert geladenen Baugruppen-Komponente. |
| GetConfigurationNames | Liefert die Namen der Konfigurationen einer reduziert geladenen Baugruppen-Komponente. |
| GetConstrainedStatus | Liefert, ob eine Komponente unter-, voll oder überbestimmt ist. |
| GetCorresponding | Liefert zu einem Objekt aus dem Modell der Komponente das passende Objekt in der Baugruppe. |
| GetCorrespondingEntity | Liefert zu einer Fläche, Kante oder Ecke aus dem Modell der Komponente die passende in der Baugruppe. |
| GetDecals | Liefert die Abziehbilder einer Komponente. |
| GetDecalsCount | Liefert die Anzahl der Abziehbilder einer Komponente. |
| GetDrawingComponent | Liefert zu einer Komponente die Zeichnungskomponente in einer Zeichenansicht. |
| GetExcludeFromBOM2 | Liefert, ob eine Komponente in den Stücklisten bestimmter Konfigurationen ausgeschlossen ist. |
| GetHiddenUnloadedChildrenCount | Liefert die Anzahl der ausgeblendeten Unterkomponenten, die beim selektiven Öffnen nicht geladen wurden. |
| GetID | Liefert die feste ID einer Komponente innerhalb ihrer Baugruppe. |
| GetImportedPath | Liefert den Pfad des importierten Modells einer Komponente. |
| GetMaterialIdName | Liefert den Materialnamen einer Komponente. |
| GetMaterialPropertyValues2 | Liefert Farbe und Lichteigenschaften einer Komponente in bestimmten Konfigurationen. |
| GetMaterialUserName | Liefert den sichtbaren Materialnamen einer Komponente. |
| GetMates | Liefert alle Verknüpfungen einer Komponente. |
| GetModelDoc | veraltet ersetzt durch Component2.GetModelDoc2 |
| GetModelDoc2 | Liefert das Modell hinter einer Komponente, also das Teil oder die Unterbaugruppe als ModelDoc2. |
| GetModelMaterialPropertyValues | Liefert Farbe und Lichteigenschaften einer reduziert geladenen Komponente in einer Konfiguration. |
| GetModelTexture | Liefert die Textur einer reduziert geladenen Komponente in einer Konfiguration. |
| GetParent | Liefert die übergeordnete Komponente, also die Unterbaugruppe, in der eine Komponente steckt. |
| GetPathName | Liefert die Datei einer Komponente mit vollem Pfad und Dateinamen. |
| GetPLMID | Liefert die ID einer Komponente auf der 3DEXPERIENCE-Plattform. |
| GetPropertyExtension | Liefert den mit AddPropertyExtension angehängten Wert einer Komponente. |
| GetReferencedDisplayStates | Liefert, welche Anzeigezustände der Komponente bestimmte Anzeigezustände der Baugruppe nutzen. |
| GetRemainingDOFs | Ohne Beschreibung in der Hilfe. Dem Namen nach: liefert die Freiheitsgrade, die einer Komponente noch bleiben. |
| GetRenderMaterials | veraltet ersetzt durch Component2.GetRenderMaterials2 |
| GetRenderMaterials2 | Liefert die Darstellungen (Appearances), die einer Komponente in bestimmten Anzeigezuständen zugewiesen sind. |
| GetRenderMaterialsCount | veraltet ersetzt durch Component2.GetRenderMaterialsCount2 |
| GetRenderMaterialsCount2 | Liefert die Anzahl der Darstellungen (Appearances) einer Komponente in bestimmten Anzeigezuständen. |
| GetRepresentationParent | Liefert die übergeordnete Konfiguration (Representation Parent) einer Komponente auf der 3DEXPERIENCE-Plattform. |
| GetSectionedBodies | Liefert die geschnittenen Körper einer Komponente in einer Schnittansicht. |
| GetSelectByIDString | Liefert den Namen einer Komponente so, wie SelectByID2 ihn erwartet. |
| GetSmartComponentData | Liefert Features, Komponenten und Referenzen einer Smart Component. |
| GetSpecificTransform | Liefert in einer Explosionsansicht wahlweise die zusammengebaute oder die explodierte Lage einer Komponente. |
| GetSuppression | veraltet ersetzt durch Component2.GetSuppression2 |
| GetSuppression2 | Liefert den Zustand einer Komponente: unterdrückt, reduziert oder aufgelöst. |
| GetTessNorms | Liefert die Normalen der Dreiecke, aus denen die schattierte Darstellung einer Komponente besteht. |
| GetTessTriangles | Liefert die Dreiecke, aus denen die schattierte Darstellung einer Komponente besteht. |
| GetTessTriStripEdges | Liefert die Kanten-IDs der Dreiecksstreifen einer Komponente. |
| GetTessTriStripNorms | Liefert die Normalen der Dreiecksstreifen einer Komponente. |
| GetTessTriStrips | Liefert die Eckpunkte der Dreiecksstreifen, aus denen die schattierte Darstellung einer Komponente besteht. |
| GetTexture | Liefert die Textur einer Komponente in einer Konfiguration. |
| GetTotalTransform | Liefert die Lage einer Komponente einschließlich einer Anzeige-Lage (PresentationTransform). |
| GetType | Liefert die Dokumentart einer reduziert geladenen Baugruppen-Komponente. |
| GetUnloadedComponentNames | Liefert Namen, Pfade, Konfigurationen und Gründe der nicht geladenen Unterkomponenten einer Komponente. |
| GetVisibility | Liefert, ob eine Komponente in bestimmten Konfigurationen sichtbar ist. |
| GetVisibilityInAsmDisplayStates | Liefert, ob eine Komponente in bestimmten Anzeigezuständen der Baugruppe sichtbar ist. |
| GetXform | veraltet ersetzt durch Component2.Transform2 |
| HasAssemblyFeatures | Liefert, ob eine Komponente in einer Konfiguration von Baugruppen-Features betroffen ist. |
| HasMaterialPropertyValues | Liefert, ob eine Komponente eine eigene Darstellung (Farbe) hat. |
| HasUnloadedComponents | Liefert, ob eine Komponente ausgeblendete oder unterdrückte Unterkomponenten hat, die nicht geladen sind. |
| IsDisplayDataOutOfDate | Liefert, ob die Darstellungsdaten einer reduzierten Komponente veraltet sind. |
| IsEnvelope | Liefert, ob eine Komponente eine Hüllkomponente (Envelope) ist. |
| IsFixed | Liefert, ob eine Komponente fixiert ist oder frei beweglich. |
| IsHidden | Liefert, ob eine Komponente ausgeblendet ist, wahlweise auch, ob sie unterdrückt ist. |
| IsLoaded | Liefert, ob eine Komponente geladen ist. |
| IsMirrored | Liefert, ob eine Komponente gespiegelt ist. |
| IsNameOverridden | Liefert, ob der Name einer Komponente vom Dateinamen abweicht, weil er überschrieben wurde. |
| IsPatternInstance | Liefert, ob eine Komponente zu einem Muster gehört. |
| IsRoot | Liefert, ob eine Komponente die Wurzelkomponente ist, also die Baugruppe ganz oben im FeatureManager. |
| IsSmartComponent | Liefert, ob eine Komponente eine Smart Component ist. |
| IsSuppressed | Liefert, ob eine Komponente unterdrückt ist. |
| ListExternalFileReferences | veraltet ersetzt durch Component2.ListExternalFileReferences2 |
| ListExternalFileReferences2 | Liefert die externen Referenzen einer Komponente mit ihrem Zustand. |
| ListExternalFileReferencesCount | Liefert die Anzahl der externen Referenzen einer Komponente. |
| MakeVirtual | veraltet ersetzt durch Component2.MakeVirtual2 |
| MakeVirtual2 | Macht eine Komponente virtuell: Sie wird in der Baugruppe gespeichert und von ihrer Datei gelöst. |
| RemoveMaterialProperty | veraltet ersetzt durch Component2.RemoveMaterialProperty2 |
| RemoveMaterialProperty2 | Entfernt die eigene Darstellung (Farbe) einer Komponente in bestimmten Konfigurationen. |
| RemovePresentationTransform | Entfernt die Anzeige-Lage (PresentationTransform) einer Komponente. |
| RemoveTexture | Entfernt die Textur einer Komponente in einer Konfiguration. |
| RemoveTextureByDisplayState | Entfernt die Textur einer Komponente in einem Anzeigezustand. |
| ReplaceReference | veraltet ersetzt durch AssemblyDoc.ReplaceComponents2 |
| ResetPropertyExtension | Löscht den mit AddPropertyExtension angehängten Wert einer Komponente. |
| SaveVirtualComponent | Speichert eine virtuelle Komponente in eine eigene Datei. |
| Select | veraltet ersetzt durch Component2.Select4 |
| Select2 | veraltet ersetzt durch Component2.Select4 |
| Select3 | veraltet ersetzt durch Component2.Select4 |
| Select4 | Wählt eine Komponente aus. |
| SelectByMark | veraltet ersetzt durch Component2.Select4 |
| SetCosmosWorksMaterial | Weist einer Komponente ein Material für die Simulation zu. |
| SetExcludeFromBOM2 | Schließt eine Komponente in bestimmten Konfigurationen aus der Stückliste aus oder nimmt sie wieder auf. |
| SetMaterialIdName | Setzt den Materialnamen einer Komponente. |
| SetMaterialPropertyValues2 | Setzt Farbe und Lichteigenschaften einer Komponente in bestimmten Konfigurationen. |
| SetMaterialUserName | Setzt den sichtbaren Materialnamen einer Komponente. |
| SetReferencedDisplayStates | Legt fest, welchen Anzeigezustand der Komponente bestimmte Anzeigezustände der Baugruppe nutzen. |
| SetSmartComponentData | Legt fest, welche Features und Komponenten einer Smart Component aktiv sind, und aktiviert die Smart Features. |
| SetSuppression | veraltet ersetzt durch Component2.SetSuppression2 |
| SetSuppression2 | Setzt den Zustand einer Komponente: unterdrückt, reduziert oder aufgelöst. |
| SetTexture | Weist einer Komponente in einer Konfiguration eine Textur zu. |
| SetTextureByDisplayState | Weist einer Komponente in einem Anzeigezustand eine Textur zu. |
| SetTransformAndSolve | veraltet ersetzt durch Component2.SetTransformAndSolve3 |
| SetTransformAndSolve2 | veraltet ersetzt durch Component2.SetTransformAndSolve3 |
| SetTransformAndSolve3 | Setzt die Lage einer Komponente und löst danach die Verknüpfungen. |
| SetVisibility | Blendet eine Komponente in bestimmten Konfigurationen ein oder aus. |
| SetVisibilityInAsmDisplayStates | Blendet eine Komponente in bestimmten Anzeigezuständen der Baugruppe ein oder aus. |
| SetXform | veraltet ersetzt durch Component2.Transform2 |
| SetXformAndSolve | veraltet ersetzt durch Component2.SetTransformAndSolve3 |
| UpdateExternalFileReferences | Bricht, sperrt oder entsperrt alle externen Referenzen einer Komponente. |
Nicht aufgeführt sind 31 C++-Varianten (Namen mit I davor, zum Beispiel IFindAttribute). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IComponent2 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.