Objekt · SldWorks
TitleBlockTableFeature-Objekt
Das Feature einer Schriftfeldtabelle in einem Teil oder einer Baugruppe: der Eintrag im FeatureManager und die zugehörigen Tabellen.
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
TitleBlockTableAnnotation.TitleBlockTableFeature: das Feature einer Schriftfeldtabelle, etwa ausModelDocExtension.InsertTitleBlockTableSelectionMgr.GetSelectedObject6: wenn das Feature ausgewählt ist, etwa mitModelDocExtension.SelectByID2und dem TypTITLEBLOCKTABLEFEAT
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| GetFeature | Liefert das Feature der Schriftfeldtabelle im FeatureManager. |
| GetTableAnnotationCount | Liefert die Zahl der Schriftfeldtabellen, die zu diesem Feature gehören. |
| GetTableAnnotations | Liefert 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.