SolidWorksMakroprogrammierung

Methode · AdvancedSelectionCriteria

AddItem2-Methode (AdvancedSelectionCriteria)

Fügt der erweiterten Komponentenauswahl ein Kriterium hinzu, etwa „benutzerdefinierte Eigenschaft IsPeg = Yes“.

Syntax

Function AddItem2( _
   ByVal Category1 As String, _
   ByVal Category2 As String, _
   ByVal Condition As Long, _
   ByVal Value As String, _
   ByVal IsAnd As Boolean _
) As Long
nNummer = swKrit.AddItem2("Custom Property", "IsPeg", swAdvSelectType_Equals, "Yes", True)

Parameter

Category1StringByVal
Name der ersten Kategorie, etwa "Custom Property" (siehe Bemerkungen).
Category2StringByVal
Name der zweiten Kategorie, bei einer benutzerdefinierten Eigenschaft deren Name.
ConditionLongByVal
Die Bedingung als Wert aus swAdvSelectType_e, etwa swAdvSelectType_Equals.
ValueStringByVal
Der Wert, den die Bedingung prüft, als Text.
IsAndBooleanByVal
True: UND, das Kriterium muss zusätzlich zu den vorherigen erfüllt sein. False: ODER, es genügt auch allein (siehe Bemerkungen).

Rückgabewert

Der Index des neuen Kriteriums in der Liste. Das erste Kriterium lieferte 1, das zweite 2. Das ist die Nummer ab 1, also die Zahl der Kriterien danach. AdvancedSelectionCriteria.GetItem2 und AdvancedSelectionCriteria.DeleteItem zählen dagegen ab 0.

Beispiel

' swModel ist die Baugruppe (ModelDoc2), swAssy dieselbe als AssemblyDoc (Set swAssy = swModel).
Dim swKrit As SldWorks.AdvancedSelectionCriteria
Dim nNummer As Long
Set swKrit = swAssy.GetAdvancedSelection
nNummer = swKrit.AddItem2("Custom Property", "IsPeg", swAdvSelectType_Equals, "Yes", True)
If swKrit.Select Then Debug.Print swModel.SelectionManager.GetSelectedObjectCount2(-1) & " Komponenten ausgewählt"

Bemerkungen

Welche Werte für die Kategorien, die Bedingung und den Wert möglich sind, steht in der SOLIDWORKS-Hilfe unter „Assemblies > Basic Component Operations > Selecting Components > Advanced Component Selection > Search Criteria for Advanced Component Selection“. Die Werte im Beispiel stammen aus der Hilfe zu AdvancedSelectionCriteria.SaveCriteria. Die Hilfe nennt die Kategorien nur englisch. Ob eine deutsche SOLIDWORKS-Installation deutsche Namen erwartet, sagt sie nicht. Wie sich SOLIDWORKS 2024 mit deutscher Oberfläche verhält, steht bei AdvancedSelectionCriteria: Bei benutzerdefinierten Eigenschaften zählt nur Category2.

UND/ODER: In SOLIDWORKS 2024, mit den Kriterien „Lieferant = Extern“ und „Lieferant = Intern“: Hatte das zweite IsAnd = True, wählte Select nichts aus. Mit False wählte Select alle Komponenten mit einem der beiden Werte aus. Der Wert beim ersten Kriterium änderte nichts.

Nachdem du mehrere Kriterien hinzugefügt hast, speicherst du sie mit AdvancedSelectionCriteria.SaveCriteria und wählst die passenden Komponenten mit AdvancedSelectionCriteria.Select aus.

AddItem2 ersetzt das veraltete AdvancedSelectionCriteria.AddItem, das noch keine zweite Kategorie kannte.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2021

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

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