Objekt · SldWorks
SafeArrayUtility-Objekt
Ein Hilfsobjekt für C++-Programme, das Werte in Variant-SafeArrays liest, schreibt und Objekt-Arrays packt oder entpackt.
Beschreibung
SafeArrayUtility liest und schreibt einzelne Werte in einem Variant-SafeArray, dessen Elemente alle denselben Datentyp haben. Es liefert die Zahl und den Datentyp der Elemente und packt native SOLIDWORKS-Objekte in ein Variant-SafeArray oder entpackt sie wieder. Es ersetzt die frühere SafeArray-Vorlagenklasse für C++-Projekte, alle Hilfebeispiele sind in C++. In VBA liest du Arrays direkt mit vWerte(i), das Objekt brauchst du dort kaum. Die Befehle gibt es seit SOLIDWORKS 2015.
Zugriff
Beispiel
' Gibt Zahl und Datentyp der Konfigurationsnamen aus und liest die Namen einzeln,
' wie das C++-Beispiel "Get Names of Configurations Using Variant".
' Vorbedingung: Ein Teil oder eine Baugruppe ist offen.
' Ergebnis: Die Namen stehen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swUtil As SldWorks.SafeArrayUtility
Dim vNamen As Variant
Dim nAnzahl As Long, nTyp As Long, i As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swUtil = swApp.GetSafeArrayUtility
vNamen = swModel.GetConfigurationNames
swUtil.GetInfo vNamen, nAnzahl, nTyp
Debug.Print nAnzahl & " Konfiguration(en), Datentyp " & nTyp & IIf(nTyp = swBstrArray, " (Zeichenketten)", "")
For i = 0 To nAnzahl - 1
Debug.Print " " & swUtil.GetBstr(vNamen, i) ' in VBA gleichwertig: vNamen(i)
Next i
End SubBemerkungen
Für C++ gedacht: Die Methoden arbeiten nur mit einfachen Zeigern und BSTRs, nicht mit Smart Pointern (IDispatchPtr, CComPtr) oder CComBSTR. SafeArrayUtility.PackVariant und SafeArrayUtility.UnPackVariant arbeiten mit Zeigern auf native Arrays und lassen sich in VBA nicht sinnvoll aufrufen.
Index: Ob der Index bei 0 beginnt, sagt die Hilfe nicht ausdrücklich. Die C++-Beispiele zählen von 0 bis zur Zahl der Elemente minus 1, und so ist es auch.
Datentypen: Die Werte für den Datentyp stehen in swSafeArrayType_e. Für 64-Bit-Zahlen und IUnknown-Objekte nennt die VBA-Syntax den Typ Unknown.
Eigenschaften und Methoden
Methoden 21, davon 21 beschrieben
| Name | Beschreibung |
|---|---|
| GetBoolean | Liest einen Wahrheitswert aus einem Variant-SafeArray mit Wahrheitswerten. |
| GetBstr | Liest eine Zeichenkette aus einem Variant-SafeArray mit Zeichenketten (BSTR). |
| GetByte | Liest ein Byte aus einem Variant-SafeArray mit Bytes. |
| GetDispatch | Liest ein Objekt aus einem Variant-SafeArray mit SOLIDWORKS-Objekten (Dispatch). |
| GetDouble | Liest eine Kommazahl aus einem Variant-SafeArray mit Kommazahlen (Double). |
| GetInfo | Liefert die Zahl der Elemente in einem Variant-SafeArray und ihren Datentyp. |
| GetLong | Liest eine ganze Zahl (Long) aus einem Variant-SafeArray mit Long-Werten. |
| GetLongLong | Liest eine 64-Bit-Ganzzahl aus einem Variant-SafeArray mit 64-Bit-Ganzzahlen (long long). |
| GetShort | Liest eine kurze Ganzzahl (Integer, 16 Bit) aus einem Variant-SafeArray mit solchen Werten. |
| GetUNKNOWN | Liest ein COM-Objekt (IUnknown) aus einem Variant-SafeArray mit solchen Objekten. |
| PackVariant | Packt ein natives Array gleichartiger SOLIDWORKS-Objekte in ein Variant-SafeArray, das du an Methoden übergibst, die ein solches Array erwarten. |
| PutBoolean | Schreibt einen Wahrheitswert in ein Variant-SafeArray mit Wahrheitswerten. |
| PutBstr | Schreibt eine Zeichenkette in ein Variant-SafeArray mit Zeichenketten (BSTR). |
| PutByte | Schreibt ein Byte in ein Variant-SafeArray mit Bytes. |
| PutDispatch | Schreibt ein SOLIDWORKS-Objekt (Dispatch) in ein Variant-SafeArray mit Objekten. |
| PutDouble | Schreibt eine Kommazahl in ein Variant-SafeArray mit Kommazahlen (Double). |
| PutLong | Schreibt eine ganze Zahl (Long) in ein Variant-SafeArray mit Long-Werten. |
| PutLongLong | Schreibt eine 64-Bit-Ganzzahl in ein Variant-SafeArray mit 64-Bit-Ganzzahlen (long long). |
| PutShort | Schreibt eine kurze Ganzzahl (Integer, 16 Bit) in ein Variant-SafeArray mit solchen Werten. |
| PutUNKNOWN | Schreibt ein COM-Objekt (IUnknown) in ein Variant-SafeArray mit solchen Objekten. |
| UnPackVariant | Entpackt ein gepacktes Variant-SafeArray in ein natives Array gleichartiger SOLIDWORKS-Objekte. |
Siehe auch
Englisches Original: ISafeArrayUtility in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.