SolidWorksMakroprogrammierung

Objekt · SldWorks

Component2-Objekt

Steht für eine Komponente in einer Baugruppe, also ein verbautes Teil oder eine Unterbaugruppe.

Deklaration Dim x As SldWorks.Component2 · in der englischen .NET-Hilfe: IComponent2

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

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 Sub

Bemerkungen

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

NameBeschreibung
ComponentReferenceLiefert oder setzt die Komponentenreferenz, einen frei wählbaren Zusatz zum Namen einer Komponente.
CustomPropertyManagerLiefert den CustomPropertyManager mit den Eigenschaften einer Komponente in einer Konfiguration.
DisplayTitleLiefert den Titel einer Komponente, wie er im FeatureManager steht.
ExcludeFromBOMveraltet ersetzt durch Component2.GetExcludeFromBOM2 und Component2.SetExcludeFromBOM2
IsGraphicsOnlyLiefert, ob eine Komponente nur als Grafik vorliegt.
IsSpeedPakLiefert, ob die aktive Konfiguration einer Komponente eine SpeedPak-Konfiguration ist.
IsVirtualLiefert, ob eine Komponente virtuell ist, also nur in der Baugruppe gespeichert.
MaterialPropertyValuesLiefert oder setzt Farbe und Lichteigenschaften einer Komponente in der aktiven Konfiguration.
Nameveraltet ersetzt durch Component2.Name2
Name2Liefert oder ändert den Namen einer Komponente im Baum, etwa "Welle-1", bei Unterbaugruppen mit dem Pfad davor.
PresentationTransformLiefert oder setzt eine Lage, in der eine Komponente nur angezeigt wird, ohne die Geometrie zu verschieben.
ReferencedConfigurationLiefert oder ändert die Konfiguration, mit der eine Komponente in der Baugruppe verbaut ist.
ReferencedDisplayStateveraltet ersetzt durch Component2.ReferencedDisplayState2
ReferencedDisplayState2Liefert oder setzt den Anzeigezustand, den eine Komponente nutzt.
SolvingLiefert, ob eine Unterbaugruppe starr oder flexibel gelöst wird.
Transformveraltet ersetzt durch Component2.Transform2
Transform2Liefert oder setzt die Lage einer Komponente in der Baugruppe.
UseNamedConfigurationLiefert, ob eine Komponente eine fest angegebene Konfiguration nutzt oder die zuletzt aktive.
VisibleLiefert oder setzt, ob eine Komponente sichtbar oder ausgeblendet ist.

Methoden 116, davon 94 beschrieben, 22 veraltet

NameBeschreibung
AddPropertyExtensionHängt einen eigenen Wert (Zahl oder Text) an eine Komponente.
DeSelectHebt die Auswahl einer Komponente auf.
EnumBodiesveraltet ersetzt durch Component2.EnumBodies3
EnumBodies2veraltet ersetzt durch Component2.EnumBodies3
EnumBodies3Liefert die Körper einer Komponente als Aufzählung (EnumBodies2).
EnumRelatedBodiesLiefert die Körper der Referenzflächen einer Komponente als Aufzählung.
EnumSectionedBodiesLiefert die geschnittenen Körper einer Komponente in einer Schnittansicht als Aufzählung.
FeatureByNameLiefert ein Feature einer Komponente über seinen Namen.
FindAttributeSucht an einer Komponente ein Attribut mit einer bestimmten Definition.
FirstFeatureLiefert das erste Feature einer Komponente, als Start für das Durchlaufen ihres Feature-Baums.
GetBodiesveraltet ersetzt durch Component2.GetBodies3
GetBodies2veraltet ersetzt durch Component2.GetBodies3
GetBodies3Liefert die Körper einer Komponente als Array.
GetBodyLiefert den Körper einer Teil-Komponente, so wie er in dieser Baugruppe aussieht.
GetBoxLiefert einen Quader, der die Komponente umschließt.
GetChildrenLiefert die Komponenten eine Ebene unter einer Komponente, etwa die Teile einer Unterbaugruppe.
GetConfigurationCountLiefert die Anzahl der Konfigurationen einer reduziert geladenen Baugruppen-Komponente.
GetConfigurationNamesLiefert die Namen der Konfigurationen einer reduziert geladenen Baugruppen-Komponente.
GetConstrainedStatusLiefert, ob eine Komponente unter-, voll oder überbestimmt ist.
GetCorrespondingLiefert zu einem Objekt aus dem Modell der Komponente das passende Objekt in der Baugruppe.
GetCorrespondingEntityLiefert zu einer Fläche, Kante oder Ecke aus dem Modell der Komponente die passende in der Baugruppe.
GetDecalsLiefert die Abziehbilder einer Komponente.
GetDecalsCountLiefert die Anzahl der Abziehbilder einer Komponente.
GetDrawingComponentLiefert zu einer Komponente die Zeichnungskomponente in einer Zeichenansicht.
GetExcludeFromBOM2Liefert, ob eine Komponente in den Stücklisten bestimmter Konfigurationen ausgeschlossen ist.
GetHiddenUnloadedChildrenCountLiefert die Anzahl der ausgeblendeten Unterkomponenten, die beim selektiven Öffnen nicht geladen wurden.
GetIDLiefert die feste ID einer Komponente innerhalb ihrer Baugruppe.
GetImportedPathLiefert den Pfad des importierten Modells einer Komponente.
GetMaterialIdNameLiefert den Materialnamen einer Komponente.
GetMaterialPropertyValues2Liefert Farbe und Lichteigenschaften einer Komponente in bestimmten Konfigurationen.
GetMaterialUserNameLiefert den sichtbaren Materialnamen einer Komponente.
GetMatesLiefert alle Verknüpfungen einer Komponente.
GetModelDocveraltet ersetzt durch Component2.GetModelDoc2
GetModelDoc2Liefert das Modell hinter einer Komponente, also das Teil oder die Unterbaugruppe als ModelDoc2.
GetModelMaterialPropertyValuesLiefert Farbe und Lichteigenschaften einer reduziert geladenen Komponente in einer Konfiguration.
GetModelTextureLiefert die Textur einer reduziert geladenen Komponente in einer Konfiguration.
GetParentLiefert die übergeordnete Komponente, also die Unterbaugruppe, in der eine Komponente steckt.
GetPathNameLiefert die Datei einer Komponente mit vollem Pfad und Dateinamen.
GetPLMIDLiefert die ID einer Komponente auf der 3DEXPERIENCE-Plattform.
GetPropertyExtensionLiefert den mit AddPropertyExtension angehängten Wert einer Komponente.
GetReferencedDisplayStatesLiefert, welche Anzeigezustände der Komponente bestimmte Anzeigezustände der Baugruppe nutzen.
GetRemainingDOFsOhne Beschreibung in der Hilfe. Dem Namen nach: liefert die Freiheitsgrade, die einer Komponente noch bleiben.
GetRenderMaterialsveraltet ersetzt durch Component2.GetRenderMaterials2
GetRenderMaterials2Liefert die Darstellungen (Appearances), die einer Komponente in bestimmten Anzeigezuständen zugewiesen sind.
GetRenderMaterialsCountveraltet ersetzt durch Component2.GetRenderMaterialsCount2
GetRenderMaterialsCount2Liefert die Anzahl der Darstellungen (Appearances) einer Komponente in bestimmten Anzeigezuständen.
GetRepresentationParentLiefert die übergeordnete Konfiguration (Representation Parent) einer Komponente auf der 3DEXPERIENCE-Plattform.
GetSectionedBodiesLiefert die geschnittenen Körper einer Komponente in einer Schnittansicht.
GetSelectByIDStringLiefert den Namen einer Komponente so, wie SelectByID2 ihn erwartet.
GetSmartComponentDataLiefert Features, Komponenten und Referenzen einer Smart Component.
GetSpecificTransformLiefert in einer Explosionsansicht wahlweise die zusammengebaute oder die explodierte Lage einer Komponente.
GetSuppressionveraltet ersetzt durch Component2.GetSuppression2
GetSuppression2Liefert den Zustand einer Komponente: unterdrückt, reduziert oder aufgelöst.
GetTessNormsLiefert die Normalen der Dreiecke, aus denen die schattierte Darstellung einer Komponente besteht.
GetTessTrianglesLiefert die Dreiecke, aus denen die schattierte Darstellung einer Komponente besteht.
GetTessTriStripEdgesLiefert die Kanten-IDs der Dreiecksstreifen einer Komponente.
GetTessTriStripNormsLiefert die Normalen der Dreiecksstreifen einer Komponente.
GetTessTriStripsLiefert die Eckpunkte der Dreiecksstreifen, aus denen die schattierte Darstellung einer Komponente besteht.
GetTextureLiefert die Textur einer Komponente in einer Konfiguration.
GetTotalTransformLiefert die Lage einer Komponente einschließlich einer Anzeige-Lage (PresentationTransform).
GetTypeLiefert die Dokumentart einer reduziert geladenen Baugruppen-Komponente.
GetUnloadedComponentNamesLiefert Namen, Pfade, Konfigurationen und Gründe der nicht geladenen Unterkomponenten einer Komponente.
GetVisibilityLiefert, ob eine Komponente in bestimmten Konfigurationen sichtbar ist.
GetVisibilityInAsmDisplayStatesLiefert, ob eine Komponente in bestimmten Anzeigezuständen der Baugruppe sichtbar ist.
GetXformveraltet ersetzt durch Component2.Transform2
HasAssemblyFeaturesLiefert, ob eine Komponente in einer Konfiguration von Baugruppen-Features betroffen ist.
HasMaterialPropertyValuesLiefert, ob eine Komponente eine eigene Darstellung (Farbe) hat.
HasUnloadedComponentsLiefert, ob eine Komponente ausgeblendete oder unterdrückte Unterkomponenten hat, die nicht geladen sind.
IsDisplayDataOutOfDateLiefert, ob die Darstellungsdaten einer reduzierten Komponente veraltet sind.
IsEnvelopeLiefert, ob eine Komponente eine Hüllkomponente (Envelope) ist.
IsFixedLiefert, ob eine Komponente fixiert ist oder frei beweglich.
IsHiddenLiefert, ob eine Komponente ausgeblendet ist, wahlweise auch, ob sie unterdrückt ist.
IsLoadedLiefert, ob eine Komponente geladen ist.
IsMirroredLiefert, ob eine Komponente gespiegelt ist.
IsNameOverriddenLiefert, ob der Name einer Komponente vom Dateinamen abweicht, weil er überschrieben wurde.
IsPatternInstanceLiefert, ob eine Komponente zu einem Muster gehört.
IsRootLiefert, ob eine Komponente die Wurzelkomponente ist, also die Baugruppe ganz oben im FeatureManager.
IsSmartComponentLiefert, ob eine Komponente eine Smart Component ist.
IsSuppressedLiefert, ob eine Komponente unterdrückt ist.
ListExternalFileReferencesveraltet ersetzt durch Component2.ListExternalFileReferences2
ListExternalFileReferences2Liefert die externen Referenzen einer Komponente mit ihrem Zustand.
ListExternalFileReferencesCountLiefert die Anzahl der externen Referenzen einer Komponente.
MakeVirtualveraltet ersetzt durch Component2.MakeVirtual2
MakeVirtual2Macht eine Komponente virtuell: Sie wird in der Baugruppe gespeichert und von ihrer Datei gelöst.
RemoveMaterialPropertyveraltet ersetzt durch Component2.RemoveMaterialProperty2
RemoveMaterialProperty2Entfernt die eigene Darstellung (Farbe) einer Komponente in bestimmten Konfigurationen.
RemovePresentationTransformEntfernt die Anzeige-Lage (PresentationTransform) einer Komponente.
RemoveTextureEntfernt die Textur einer Komponente in einer Konfiguration.
RemoveTextureByDisplayStateEntfernt die Textur einer Komponente in einem Anzeigezustand.
ReplaceReferenceveraltet ersetzt durch AssemblyDoc.ReplaceComponents2
ResetPropertyExtensionLöscht den mit AddPropertyExtension angehängten Wert einer Komponente.
SaveVirtualComponentSpeichert eine virtuelle Komponente in eine eigene Datei.
Selectveraltet ersetzt durch Component2.Select4
Select2veraltet ersetzt durch Component2.Select4
Select3veraltet ersetzt durch Component2.Select4
Select4Wählt eine Komponente aus.
SelectByMarkveraltet ersetzt durch Component2.Select4
SetCosmosWorksMaterialWeist einer Komponente ein Material für die Simulation zu.
SetExcludeFromBOM2Schließt eine Komponente in bestimmten Konfigurationen aus der Stückliste aus oder nimmt sie wieder auf.
SetMaterialIdNameSetzt den Materialnamen einer Komponente.
SetMaterialPropertyValues2Setzt Farbe und Lichteigenschaften einer Komponente in bestimmten Konfigurationen.
SetMaterialUserNameSetzt den sichtbaren Materialnamen einer Komponente.
SetReferencedDisplayStatesLegt fest, welchen Anzeigezustand der Komponente bestimmte Anzeigezustände der Baugruppe nutzen.
SetSmartComponentDataLegt fest, welche Features und Komponenten einer Smart Component aktiv sind, und aktiviert die Smart Features.
SetSuppressionveraltet ersetzt durch Component2.SetSuppression2
SetSuppression2Setzt den Zustand einer Komponente: unterdrückt, reduziert oder aufgelöst.
SetTextureWeist einer Komponente in einer Konfiguration eine Textur zu.
SetTextureByDisplayStateWeist einer Komponente in einem Anzeigezustand eine Textur zu.
SetTransformAndSolveveraltet ersetzt durch Component2.SetTransformAndSolve3
SetTransformAndSolve2veraltet ersetzt durch Component2.SetTransformAndSolve3
SetTransformAndSolve3Setzt die Lage einer Komponente und löst danach die Verknüpfungen.
SetVisibilityBlendet eine Komponente in bestimmten Konfigurationen ein oder aus.
SetVisibilityInAsmDisplayStatesBlendet eine Komponente in bestimmten Anzeigezuständen der Baugruppe ein oder aus.
SetXformveraltet ersetzt durch Component2.Transform2
SetXformAndSolveveraltet ersetzt durch Component2.SetTransformAndSolve3
UpdateExternalFileReferencesBricht, 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.