SolidWorksMakroprogrammierung

Methode · HoleTable

AssignTagPrefix-Methode (HoleTable)

Gibt den eigenen Kennungen einer Bohrung oder aller Bohrungen gleicher Größe ein Präfix.

Syntax

Function AssignTagPrefix( _
   ByVal Index As Long, _
   ByVal TagPrefix As String, _
   ByVal ApplyTo As Long _
) As Boolean
bErfolg = swBohrTab.AssignTagPrefix(1, "AB", swHoleTableTagPrefixOption_OnlySpecifiedHole)

Parameter

IndexLongByVal
Der Index der Zeile, für die das Präfix gilt.
TagPrefixStringByVal
Das Präfix.
ApplyToLongByVal

Für welche Bohrungen das Präfix gilt, ein Wert aus swHoleTableTagPrefixApply_e:

  • swHoleTableTagPrefixApply_AllHolesOfSameSize (1): alle Bohrungen, die so groß sind wie die in der Zeile Index
  • swHoleTableTagPrefixOption_OnlySpecifiedHole (2): nur die Bohrung in der Zeile Index

Rückgabewert

True, wenn das Präfix zugewiesen wurde, sonst False.

Beispiel

' swBohrTab ist das Feature einer Bohrungstabelle (HoleTable), etwa aus HoleTableAnnotation.HoleTable.
If swBohrTab.TagStyle = swHoleTable_ManualTags Then
    If False = swBohrTab.AssignTagPrefix(1, "AB", swHoleTableTagPrefixOption_OnlySpecifiedHole) Then
        Debug.Print "Präfix nicht zugewiesen"
    End If
End If

Bemerkungen

Die Methode gilt nur, wenn HoleTable.TagStyle swHoleTable_ManualTags ist. Sie entspricht dem Dialog „Assign Tag Prefix“, den du per Rechtsklick auf eine Zeile mit einer eigenen Kennung öffnest.

Bekommt nur eine Bohrung das Präfix, werden die übrigen Bohrungen gleicher Größe neu nummeriert. Das Beispiel der Hilfe: Sechs Bohrungen in zwei Größen tragen AA1, AA2, AA3, AA4, BB1 und BB2. Die Zeile von AA1 bekommt nur für sich das Präfix „AB“. Danach heißen sie AB1, AA1, AA2, AA3, BB1 und BB2.

Im Text der Hilfe steht der Wert für nur eine Bohrung mit Apply statt Option im Namen. In swHoleTableTagPrefixApply_e heißt er swHoleTableTagPrefixOption_OnlySpecifiedHole; diesen Namen nimmst du im Makro.

Ob Index bei 0 beginnt und ob die Kopfzeile mitzählt, sagt die Hilfe nicht.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2019

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

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