SolidWorksMakroprogrammierung

Methode · GroundPlaneFeatureData

AccessSelections-Methode (GroundPlaneFeatureData)

Setzt das Modell vor die Bodenebene zurück, damit du die Auswahlen lesen und ändern kannst, die sie festlegen.

Syntax

Function AccessSelections( _
   ByVal TopDoc As Object, _
   ByVal Component As Object _
) As Boolean
bErfolg = swDaten.AccessSelections(swModel, Nothing)

Parameter

TopDocObjectByVal
Das oberste Dokument (ModelDoc2): das Teil, oder die Baugruppe, wenn du das Feature in einer Komponente änderst.
ComponentObjectByVal
Im Teil Nothing. In der Baugruppe die Komponente (Component2), in der du das Feature ändern willst.

Rückgabewert

True, wenn der Zugriff auf die Auswahlen geklappt hat, sonst False.

Beispiel

' swModel ist die Baugruppe (ModelDoc2), swFeat eine Bodenebene (Feature),
' swEbene die neue ebene Fläche (Face2), etwa aus der Auswahl.
' AccessSelections liefert bei Bodenebenen in SOLIDWORKS 2024 False, deshalb hängt das Ändern nicht davon ab.
Dim swDaten As SldWorks.GroundPlaneFeatureData
Dim bZugriff As Boolean
Set swDaten = swFeat.GetDefinition
bZugriff = swDaten.AccessSelections(swModel, Nothing)
swDaten.PlanarEntity = swEbene
If False = swFeat.ModifyDefinition(swDaten, swModel, Nothing) Then
    If bZugriff Then swDaten.ReleaseSelectionAccess
End If

Bemerkungen

Die Methode setzt das Modell in einen Rücksetz-Zustand (rollback), damit du an die Auswahlen kommst, die das Feature festlegen. Diesen Zustand musst du wieder aufheben: mit Feature.ModifyDefinition, wenn du das Feature geändert hast, sonst mit GroundPlaneFeatureData.ReleaseSelectionAccess. TopDoc und Component sind hier als Object deklariert. Das Hilfebeispiel ruft die Methode in der Baugruppe mit Nothing als Component auf, vermutlich weil die Bodenebene ein Feature der Baugruppe selbst ist.

Bei einer Bodenebene kann AccessSelections False liefern. Die Werte lassen sich trotzdem setzen und mit Feature.ModifyDefinition übernehmen, mach deine Änderung also nicht vom Rückgabewert abhängig.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2019

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

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