Objekt · SldWorks
RevisionTableAnnotation-Objekt
Eine Revisionstabelle in einer Zeichnung: Revisionen anhängen und löschen, Revisions-IDs, Revisionssymbole und benutzerdefinierte Spalten.
Beschreibung
RevisionTableAnnotation gibt Zugriff auf eine Revisionstabelle. Jede Revision steht in einer Zeile und hat eine Revisions-ID, über die du ihre Zeile, ihren Text und ihre Revisionssymbole findest. Das Objekt ist von TableAnnotation abgeleitet. Zeilen, Spalten und Zellen liest und setzt du also über TableAnnotation, dieselbe Tabelle weist du dafür einfach einer Variablen des anderen Typs zu. Die meisten Befehle gibt es seit SOLIDWORKS 2004, die für benutzerdefinierte Spalten seit 2005.
Zugriff
Sheet.RevisionTable: die Revisionstabelle eines BlattsSheet.InsertRevisionTable2: fügt eine Revisionstabelle einRevisionTableFeature.GetTableAnnotations: die Tabellen eines Revisionstabellen-Features- Eine
TableAnnotationvom TypswTableAnnotation_RevisionBlock, einer Variablen vom Typ RevisionTableAnnotation zugewiesen
Beispiel
' Hängt an die Revisionstabelle des aktuellen Blatts die nächste Revision an
' (nach A kommt B), schreibt eine Beschreibung in ihre Zeile und listet alle Revisionen.
' Vorbedingung: Eine Zeichnung ist offen, das aktuelle Blatt hat eine Revisionstabelle
' mit dem Kopf oben und einer Spalte für die Beschreibung.
' Ergebnis: Die Tabelle hat eine Zeile mehr, die Revisionen stehen im Direktfenster.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDraw As SldWorks.DrawingDoc
Dim swRevTabelle As SldWorks.RevisionTableAnnotation
Dim swTabelle As SldWorks.TableAnnotation
Dim sNeu As String
Dim vDaten As Variant
Dim nStatus As Long
Dim nId As Long, nZeile As Long
Dim i As Long, j 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 ' dasselbe Dokument als DrawingDoc
Set swRevTabelle = swDraw.GetCurrentSheet.RevisionTable
If swRevTabelle Is Nothing Then Exit Sub
Set swTabelle = swRevTabelle ' dieselbe Tabelle, allgemeiner Typ
If swRevTabelle.CurrentRevision = "" Then
sNeu = "A"
Else
sNeu = Chr(Asc(swRevTabelle.CurrentRevision) + 1)
End If
nId = swRevTabelle.AddRevision(sNeu)
nZeile = swRevTabelle.GetRowNumberForId(nId)
For j = 0 To swTabelle.ColumnCount - 1
If swTabelle.GetColumnType3(j, False, vDaten, nStatus) = swRevisionTableColumnType_Description Then
swTabelle.Text2(nZeile, j, False) = "Per Makro eingetragen"
End If
Next j
For i = swTabelle.GetHeaderCount To swTabelle.RowCount - 1
nId = swRevTabelle.GetIdForRowNumber(i)
Debug.Print "Zeile " & i & ": Revision " & swRevTabelle.GetRevisionForId(nId) & _
", ID " & nId & ", " & swRevTabelle.GetRevisionSymbolCount(nId) & " Symbol(e)"
Next i
End SubBemerkungen
Revisions-ID: RevisionTableAnnotation.AddRevision liefert die ID der neuen Revision. Über TableAnnotation arbeitest du mit Zeilennummern. RevisionTableAnnotation.GetIdForRowNumber hilft dir dabei, von der Zeile zur ID zu kommen, RevisionTableAnnotation.GetRowNumberForId führt zurück. Was die ID sonst bedeutet und ob sie beim Löschen anderer Zeilen gleich bleibt, sagt die Hilfe nicht.
Hilfebeispiele: „Create Drawing Sheet Zones“ fügt mit Sheet.InsertRevisionTable2 eine Revisionstabelle ein, hängt mit AddRevision die Revision „A“ an und gibt RevisionTableAnnotation.CurrentRevision aus. „Get Revision Table“ holt die Tabelle mit Sheet.RevisionTable und liest alle Zellen über eine Variable vom Typ TableAnnotation.
Benutzerdefinierte Spalten: Mit RevisionTableAnnotation.SetColumnCustomProperty füllst du eine benutzerdefinierte Spalte mit einer Eigenschaft. Die Liste der verfügbaren Eigenschaften umfasst die Einträge der Dateiinformationen (file summary items) und die gesetzten benutzerdefinierten Dateieigenschaften. RevisionTableAnnotation.GetAllCustomProperties arbeitet nur mit Dokumenten, die mit SOLIDWORKS 2005 oder neuer angelegt oder gespeichert wurden.
Beispiel: Die nächste Revision bildet das Beispiel einfach aus dem nächsten Buchstaben. Ob AddRevision einen bestimmten Text erwartet oder die Einstellungen der Revisionstabelle beachtet, sagt die Hilfe nicht. Was GetIdForRowNumber für Kopfzeilen liefert, sagt sie auch nicht, das Beispiel überspringt sie deshalb.
Eigenschaften und Methoden
Eigenschaften 2, davon 2 beschrieben
| Name | Beschreibung |
|---|---|
| CurrentRevision | Liefert die neueste Revision der Revisionstabelle. |
| RevisionTableFeature | Liefert das Feature der Revisionstabelle. |
Methoden 12, davon 12 beschrieben
| Name | Beschreibung |
|---|---|
| AddRevision | Hängt eine Revision an die Revisionstabelle an. |
| DeleteRevision | Löscht eine Revision aus der Revisionstabelle, auf Wunsch mit ihren Revisionssymbolen. |
| GetAllCustomProperties | Liefert die Namen der Eigenschaften, mit denen du eine benutzerdefinierte Spalte der Revisionstabelle füllen kannst. |
| GetAllCustomPropertiesCount | Liefert, wie viele Eigenschaften für eine benutzerdefinierte Spalte der Revisionstabelle zur Verfügung stehen. |
| GetColumnCustomProperty | Liefert die Eigenschaft, mit der eine benutzerdefinierte Spalte der Revisionstabelle gefüllt wird. |
| GetIdForRowNumber | Liefert die Revisions-ID der Revision in einer Zeile der Revisionstabelle. |
| GetRevisionForId | Liefert den Text der Revision mit der angegebenen Revisions-ID. |
| GetRevisionSymbolCount | Liefert die Zahl der Revisionssymbole, die zu einer Revision gehören. |
| GetRevisionSymbols | Liefert die Revisionssymbole, die zu einer Revision gehören. |
| GetRowNumberForId | Liefert die Zeile, in der die Revision mit der angegebenen Revisions-ID steht. |
| GetSheet | Liefert das Zeichenblatt, auf dem die Revisionstabelle steht. |
| SetColumnCustomProperty | Legt fest, mit welcher Eigenschaft eine benutzerdefinierte Spalte der Revisionstabelle gefüllt wird. |
Nicht aufgeführt sind 2 C++-Varianten (Namen mit I davor, zum Beispiel IGetAllCustomProperties). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IRevisionTableAnnotation in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.