SolidWorksMakroprogrammierung

Objekt · SldWorks

SafeArrayUtility-Objekt

Ein Hilfsobjekt für C++-Programme, das Werte in Variant-SafeArrays liest, schreibt und Objekt-Arrays packt oder entpackt.

Deklaration Dim x As SldWorks.SafeArrayUtility · in der englischen .NET-Hilfe: ISafeArrayUtility

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 Sub

Bemerkungen

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

NameBeschreibung
GetBooleanLiest einen Wahrheitswert aus einem Variant-SafeArray mit Wahrheitswerten.
GetBstrLiest eine Zeichenkette aus einem Variant-SafeArray mit Zeichenketten (BSTR).
GetByteLiest ein Byte aus einem Variant-SafeArray mit Bytes.
GetDispatchLiest ein Objekt aus einem Variant-SafeArray mit SOLIDWORKS-Objekten (Dispatch).
GetDoubleLiest eine Kommazahl aus einem Variant-SafeArray mit Kommazahlen (Double).
GetInfoLiefert die Zahl der Elemente in einem Variant-SafeArray und ihren Datentyp.
GetLongLiest eine ganze Zahl (Long) aus einem Variant-SafeArray mit Long-Werten.
GetLongLongLiest eine 64-Bit-Ganzzahl aus einem Variant-SafeArray mit 64-Bit-Ganzzahlen (long long).
GetShortLiest eine kurze Ganzzahl (Integer, 16 Bit) aus einem Variant-SafeArray mit solchen Werten.
GetUNKNOWNLiest ein COM-Objekt (IUnknown) aus einem Variant-SafeArray mit solchen Objekten.
PackVariantPackt ein natives Array gleichartiger SOLIDWORKS-Objekte in ein Variant-SafeArray, das du an Methoden übergibst, die ein solches Array erwarten.
PutBooleanSchreibt einen Wahrheitswert in ein Variant-SafeArray mit Wahrheitswerten.
PutBstrSchreibt eine Zeichenkette in ein Variant-SafeArray mit Zeichenketten (BSTR).
PutByteSchreibt ein Byte in ein Variant-SafeArray mit Bytes.
PutDispatchSchreibt ein SOLIDWORKS-Objekt (Dispatch) in ein Variant-SafeArray mit Objekten.
PutDoubleSchreibt eine Kommazahl in ein Variant-SafeArray mit Kommazahlen (Double).
PutLongSchreibt eine ganze Zahl (Long) in ein Variant-SafeArray mit Long-Werten.
PutLongLongSchreibt eine 64-Bit-Ganzzahl in ein Variant-SafeArray mit 64-Bit-Ganzzahlen (long long).
PutShortSchreibt eine kurze Ganzzahl (Integer, 16 Bit) in ein Variant-SafeArray mit solchen Werten.
PutUNKNOWNSchreibt ein COM-Objekt (IUnknown) in ein Variant-SafeArray mit solchen Objekten.
UnPackVariantEntpackt 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.