SolidWorksMakroprogrammierung

Objekt · SldWorks

GeneralTableFeature-Objekt

Das Feature einer allgemeinen Tabelle: der Eintrag im FeatureManager und die zugehörigen Tabellen.

Deklaration Dim x As SldWorks.GeneralTableFeature · in der englischen .NET-Hilfe: IGeneralTableFeature

Beschreibung

GeneralTableFeature gibt Zugriff auf das Feature einer allgemeinen Tabelle (general table), also einer Tabelle, die du frei mit Text füllst. Das Feature steht im FeatureManager der Zeichnung und verbindet den Eintrag dort (Feature) mit den Tabellen auf dem Blatt (GeneralTableAnnotation). Die Befehle gibt es seit SOLIDWORKS 2006.

Zugriff

So bekommst du das Objekt:

Beispiel

' Fügt in die aktive Zeichnung eine allgemeine Tabelle mit 2 Zeilen und 2 Spalten ein
' und gibt den Namen ihres Features und die Daten seiner Tabellen aus.
' Vorbedingung: Eine Zeichnung ist offen.
' Ergebnis:     Die Tabelle steht auf dem Blatt, die Angaben stehen im
'               Direktfenster (Strg+G).
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swDraw As SldWorks.DrawingDoc
    Dim swTabelle As SldWorks.TableAnnotation
    Dim swTabFeat As SldWorks.GeneralTableFeature
    Dim vTabellen As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocDRAWING Then Exit Sub
    Set swDraw = swModel

    Set swTabelle = swDraw.InsertTableAnnotation2(False, 0.03, 0.13, swBOMConfigurationAnchor_TopLeft, "", 2, 2)
    If swTabelle Is Nothing Then Exit Sub
    Set swTabFeat = swTabelle.GeneralTableFeature
    If swTabFeat Is Nothing Then Exit Sub

    Debug.Print "Feature: " & swTabFeat.GetFeature.Name
    Debug.Print swTabFeat.GetTableAnnotationCount & " Tabelle(n)"
    vTabellen = swTabFeat.GetTableAnnotations
    If IsArray(vTabellen) Then
        For i = 0 To UBound(vTabellen)
            Set swTabelle = vTabellen(i)
            Debug.Print "  Tabelle " & i + 1 & ": " & swTabelle.RowCount & " Zeilen, " & _
                swTabelle.ColumnCount & " Spalten, verankert: " & swTabelle.Anchored
        Next i
    End If
End Sub

Bemerkungen

Hilfebeispiele: „Get General Table Feature“ fügt mit DrawingDoc.InsertTableAnnotation2 eine Tabelle ein, wählt das Feature mit ModelDocExtension.SelectByID2 als "General Table1" und Typ GENERALTABLEFEAT aus und weist das Ergebnis von SelectionMgr.GetSelectedObject6 direkt einer Variablen vom Typ GeneralTableFeature zu. Dann gibt es den Namen des Features und für jede Tabelle Verankerung, Ankertyp, Spalten- und Zeilenzahl aus. „Hide and Show Row“ holt die erste Tabelle des ausgewählten Features und blendet mit TableAnnotation.RowHidden ihre dritte Zeile aus und wieder ein.

Tabellen: GeneralTableFeature.GetTableAnnotations liefert allgemeine Tabellen. Beide Hilfebeispiele weisen sie einer Variablen vom Typ TableAnnotation zu und lesen darüber Zeilen und Spalten. Eine allgemeine Tabelle hat den Typ swTableAnnotation_General (swTableAnnotationType_e). Sortieren kannst du sie über GeneralTableAnnotation.

Vorlage: Eine Vorlage für allgemeine Tabellen hat die Endung .sldtbt. SOLIDWORKS liefert für allgemeine Tabellen keine Vorlagen mit. Ohne Vorlage übergibst du bei DrawingDoc.InsertTableAnnotation2 einen leeren Text, so im Hilfebeispiel. Die Lage im Beispiel oben ist in Metern, die Werte sind nur ein Vorschlag.

In Teilen und Baugruppen: Eine allgemeine Tabelle fügst du dort mit ModelDocExtension.InsertGeneralTableAnnotation ein. Ob ihr Feature dort ebenfalls eine GeneralTableFeature ist, sagt die Hilfe nicht. Sie nennt den Zugriff über die Auswahl nur für den FeatureManager der Zeichnung.

Eigenschaften und Methoden

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetFeatureLiefert das Feature der allgemeinen Tabelle im FeatureManager.
GetTableAnnotationCountLiefert die Zahl der Tabellen, die zu diesem Feature gehören.
GetTableAnnotationsLiefert die Tabellen, die zu diesem Feature gehören.

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

Siehe auch

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

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