SolidWorksMakroprogrammierung

Methode · AdvancedSelectionCriteria

LoadCriteria-Methode (AdvancedSelectionCriteria)

Lädt eine Abfragedatei (XML oder ältere SQY) als aktuelle Liste der erweiterten Komponentenauswahl.

Syntax

Function LoadCriteria( _
   ByVal CriteriaFileName As String _
) As Boolean
bErfolg = swKrit.LoadCriteria("C:\Temp\Abfrage.xml")

Parameter

CriteriaFileNameStringByVal
Pfad und Name der Abfragedatei, *.xml oder eine ältere *.sqy-Datei.

Rückgabewert

True, wenn die Datei geladen wurde, sonst False. In SOLIDWORKS 2024 kam auch für eine Datei, die es nicht gibt, True (siehe Bemerkungen).

Beispiel

' swModel ist die Baugruppe (ModelDoc2), swKrit ihre erweiterte Komponentenauswahl (AdvancedSelectionCriteria).
swKrit.LoadCriteria "C:\Temp\Abfrage.xml"
If swKrit.GetItemCount > 0 Then                ' der Rückgabewert allein sagt nicht, ob etwas geladen wurde
    Debug.Print swKrit.GetItemCount & " Kriterien geladen"
    If swKrit.Select Then Debug.Print swModel.SelectionManager.GetSelectedObjectCount2(-1) & " Komponenten ausgewählt"
Else
    Debug.Print "Keine Kriterien geladen."
End If

Bemerkungen

Eine XML-Abfragedatei exportierst du im Dialog der erweiterten Komponentenauswahl (Standard-Symbolleiste, Advanced Select). Oder du schreibst sie selbst, etwa so wie im Hilfebeispiel:

<?xml version="1.0" encoding="UTF-8"?>
<SWQueryList>
<Query Name="InContextHasMate" Favourites_Index="1">
<Boolean Name="And" Category="In Context Relations" SubCategory="Has mate to part" Condition="=" Value="base plate-1@98food processor"/>
</Query>
</SWQueryList>
  • Category und SubCategory entsprechen im Dialog den Spalten Category1 und Category2. Die möglichen Werte stehen in der SOLIDWORKS-Hilfe unter „Search Criteria for Advanced Component Selection“.
  • Favourites_Index gibt an, an welcher Stelle die Abfrage am Ende der Auswahl-Symbolleiste erscheint. Das entspricht der Zeile im Register „Manage Searches“ des Dialogs.
  • Name im Element Boolean ist "And" (Vorgabe) oder "Or": Damit werden mehrere Boolean-Elemente einer Abfrage verknüpft.
  • Weitere Query- und Boolean-Elemente schränken die Abfrage weiter ein. Die Datei speicherst du mit der Endung .xml.

Danach wählst du mit AdvancedSelectionCriteria.Select die passenden Komponenten aus.

  • Eine selbst geschriebene Datei nach dem Muster oben mit Category="Custom Property" SubCategory="Lieferant" Condition="=" Value="Intern" ergab ein Kriterium. Select wählte die passende Komponente aus.
  • LoadCriteria ersetzt die vorhandenen Kriterien, es hängt nichts an.
  • Für eine Datei, die es nicht gibt, kam True, die Liste war danach leer. Prüfe darum AdvancedSelectionCriteria.GetItemCount wie im Beispiel.
  • Eine Datei aus AdvancedSelectionCriteria.SaveCriteria ergab 0 Kriterien, weil SOLIDWORKS 2024 dort kein XML schreibt (siehe dort).

Siehe auch

Verfügbarkeit

SOLIDWORKS 2006

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

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