SolidWorksMakroprogrammierung

Methode · AdvancedSelectionCriteria

GetItem2-Methode (AdvancedSelectionCriteria)

Liefert ein Kriterium der erweiterten Komponentenauswahl: Kategorien, Bedingung, Wert und UND/ODER.

Syntax

Function GetItem2( _
   ByVal Index As Long, _
   ByRef Category1 As String, _
   ByRef Category2 As String, _
   ByRef Condition As Long, _
   ByRef Value As String, _
   ByRef IsAnd As Boolean _
) As Long
nErg = swKrit.GetItem2(i, sKat1, sKat2, nBed, sWert, bUnd)

Parameter

IndexLongByVal
Nummer des Kriteriums, beginnend bei 0.
Category1StringByRef · Rückgabe
Gibt den Namen der ersten Kategorie zurück.
Category2StringByRef · Rückgabe
Gibt den Namen der zweiten Kategorie zurück.
ConditionLongByRef · Rückgabe
Gibt die Bedingung zurück, als Wert aus swAdvSelectType_e.
ValueStringByRef · Rückgabe
Gibt den Wert zurück, den die Bedingung prüft.
IsAndBooleanByRef · Rückgabe
Gibt True zurück, wenn alle Kriterien erfüllt sein müssen (UND), False, wenn dieses allein genügt (ODER). Bei Kriterien aus AddItem2 kommt in SOLIDWORKS 2024 immer False (siehe Bemerkungen).

Rückgabewert

Der übergebene Index, oder -1, wenn es das Kriterium nicht gibt.

Beispiel

' swKrit ist die erweiterte Komponentenauswahl (AdvancedSelectionCriteria), etwa aus AssemblyDoc.GetAdvancedSelection.
Dim sKat1 As String, sKat2 As String, sWert As String
Dim nBed As Long, bUnd As Boolean
Dim i As Long
For i = 0 To swKrit.GetItemCount - 1
    If swKrit.GetItem2(i, sKat1, sKat2, nBed, sWert, bUnd) > -1 Then
        Debug.Print i & ": " & sKat1 & ", " & sKat2 & ", Bedingung " & nBed & ", Wert " & sWert & ", UND " & bUnd
    End If
Next i

Bemerkungen

Vorher holst du mit AdvancedSelectionCriteria.GetItemCount die Zahl der Kriterien, um einen gültigen Index zu haben. Das Beispiel folgt dem Hilfebeispiel auf der Seite AdvancedSelectionCriteria.

Für Kriterien aus AdvancedSelectionCriteria.AddItem2 liefert IsAnd immer False, auch wenn sie mit True angelegt wurden; Select und SaveCriteria halten sich trotzdem an den angelegten Wert. Für ein Kriterium aus einer XML-Datei mit Name="And" (AdvancedSelectionCriteria.LoadCriteria) kommt True.

GetItem2 ersetzt das veraltete AdvancedSelectionCriteria.GetItem, das noch keine zweite Kategorie kannte.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2021

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

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