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 BooleanbErfolg = swBohrTab.AssignTagPrefix(1, "AB", swHoleTableTagPrefixOption_OnlySpecifiedHole)Parameter
IndexLongByVal- Der Index der Zeile, für die das Präfix gilt.
TagPrefixStringByVal- Das Präfix.
ApplyToLongByValFü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 ZeileIndexswHoleTableTagPrefixOption_OnlySpecifiedHole(2): nur die Bohrung in der ZeileIndex
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 IfBemerkungen
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.