SolidWorksMakroprogrammierung

Objekt · SldWorks

RevisionTableAnnotation-Objekt

Eine Revisionstabelle in einer Zeichnung: Revisionen anhängen und löschen, Revisions-IDs, Revisionssymbole und benutzerdefinierte Spalten.

Deklaration Dim x As SldWorks.RevisionTableAnnotation · in der englischen .NET-Hilfe: IRevisionTableAnnotation

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

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 Sub

Bemerkungen

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

NameBeschreibung
CurrentRevisionLiefert die neueste Revision der Revisionstabelle.
RevisionTableFeatureLiefert das Feature der Revisionstabelle.

Methoden 12, davon 12 beschrieben

NameBeschreibung
AddRevisionHängt eine Revision an die Revisionstabelle an.
DeleteRevisionLöscht eine Revision aus der Revisionstabelle, auf Wunsch mit ihren Revisionssymbolen.
GetAllCustomPropertiesLiefert die Namen der Eigenschaften, mit denen du eine benutzerdefinierte Spalte der Revisionstabelle füllen kannst.
GetAllCustomPropertiesCountLiefert, wie viele Eigenschaften für eine benutzerdefinierte Spalte der Revisionstabelle zur Verfügung stehen.
GetColumnCustomPropertyLiefert die Eigenschaft, mit der eine benutzerdefinierte Spalte der Revisionstabelle gefüllt wird.
GetIdForRowNumberLiefert die Revisions-ID der Revision in einer Zeile der Revisionstabelle.
GetRevisionForIdLiefert den Text der Revision mit der angegebenen Revisions-ID.
GetRevisionSymbolCountLiefert die Zahl der Revisionssymbole, die zu einer Revision gehören.
GetRevisionSymbolsLiefert die Revisionssymbole, die zu einer Revision gehören.
GetRowNumberForIdLiefert die Zeile, in der die Revision mit der angegebenen Revisions-ID steht.
GetSheetLiefert das Zeichenblatt, auf dem die Revisionstabelle steht.
SetColumnCustomPropertyLegt 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.