SolidWorksMakroprogrammierung

Objekt · SldWorks

TitleBlockTableFeature-Objekt

Das Feature einer Schriftfeldtabelle in einem Teil oder einer Baugruppe: der Eintrag im FeatureManager und die zugehörigen Tabellen.

Deklaration Dim x As SldWorks.TitleBlockTableFeature · in der englischen .NET-Hilfe: ITitleBlockTableFeature

Beschreibung

TitleBlockTableFeature gibt Zugriff auf das Feature einer Schriftfeldtabelle (title block table). Solche Tabellen fügst du in Teile und Baugruppen ein. Das Feature steht im Ordner Tabellen des FeatureManagers und verbindet den Eintrag dort (Feature) mit den Tabellen im Grafikbereich (TitleBlockTableAnnotation). Die Befehle gibt es seit SOLIDWORKS 2010.

Zugriff

Beispiel

' Fügt eine Schriftfeldtabelle ein und gibt den Namen ihres Features und die
' Zahl seiner Tabellen aus.
' Vorbedingung: Ein Teil ist offen, die Vorlage unter sVorlage gibt es.
' Ergebnis:     Unter Tabellen steht ein neues Feature, die Angaben stehen im Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swSchriftfeld As SldWorks.TitleBlockTableAnnotation
    Dim swSfFeat As SldWorks.TitleBlockTableFeature
    Dim swTabelle As SldWorks.TableAnnotation
    Dim vTabellen As Variant
    Dim sVorlage As String
    Dim i As Long

    sVorlage = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\lang\english\connector-table.sldtbt"
    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    Set swSchriftfeld = swModel.Extension.InsertTitleBlockTable(sVorlage, 500, 500)
    If swSchriftfeld Is Nothing Then Exit Sub
    Set swSfFeat = swSchriftfeld.TitleBlockTableFeature

    Debug.Print "Feature: " & swSfFeat.GetFeature.Name
    Debug.Print swSfFeat.GetTableAnnotationCount & " Tabelle(n)"
    vTabellen = swSfFeat.GetTableAnnotations
    If IsArray(vTabellen) Then
        For i = 0 To UBound(vTabellen)
            Set swTabelle = vTabellen(i)                  ' dieselbe Tabelle, allgemeiner Typ
            Debug.Print "  Tabelle " & i + 1 & ": " & swTabelle.RowCount & " Zeilen"
        Next i
    End If
End Sub

Bemerkungen

Auswahl: Das Hilfebeispiel „Get Title Block Tables“ wählt das Feature mit ModelDocExtension.SelectByID2 und dem Typ TITLEBLOCKTABLEFEAT (swSelTITLEBLOCKTABLEFEAT) aus und weist das Ergebnis von SelectionMgr.GetSelectedObject6 direkt einer Variablen vom Typ TitleBlockTableFeature zu.

Tabellen: Eine Schriftfeldtabelle ist eine TableAnnotation mit dem Typ swTableAnnotation_TitleBlock (swTableAnnotationType_e). Das Hilfebeispiel weist eine ausgewählte Schriftfeldtabelle einer Variablen vom Typ TableAnnotation zu und prüft so den Typ. Zeilen, Spalten und Zellen liest du über TableAnnotation.

Ordner Tabellen: Das Hilfebeispiel weist darauf hin, dass das Feature unter Tabellen im FeatureManager eventuell ausgeblendet ist. Du blendest es mit einem Rechtsklick auf das Teil über die ausgeblendeten Elemente der Baumstruktur ein (Hidden Tree Items).

Vorlage: Die Vorlagen für Schriftfeldtabellen haben die Endung .sldtbt. Den Pfad im Beispiel nimmt das Hilfebeispiel, bei dir kann er anders sein. Die Lage 500, 500 stammt ebenfalls aus dem Hilfebeispiel. Die Einheit von X und Y nennt die Hilfe nicht.

Eigenschaften und Methoden

Methoden 3, davon 3 beschrieben

NameBeschreibung
GetFeatureLiefert das Feature der Schriftfeldtabelle im FeatureManager.
GetTableAnnotationCountLiefert die Zahl der Schriftfeldtabellen, die zu diesem Feature gehören.
GetTableAnnotationsLiefert die Schriftfeldtabellen, 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: ITitleBlockTableFeature in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

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