SolidWorksMakroprogrammierung

Methode · ModelDoc2

SelectedFaceProperties-Methode (ModelDoc2)

Setzt Farbe und Lichtwerte der ausgewählten Fläche und gibt ihr bei Bedarf einen Namen.

Syntax

Function SelectedFaceProperties( _
   ByVal RgbColor As Long, _
   ByVal Ambient As Double, _
   ByVal Diffuse As Double, _
   ByVal Specular As Double, _
   ByVal Shininess As Double, _
   ByVal Transparency As Double, _
   ByVal Emission As Double, _
   ByVal UsePartProps As Boolean, _
   ByVal FaceName As String _
) As Boolean
bOk = swModel.SelectedFaceProperties(RGB(255, 0, 0), 0.5, 0.8, 0.5, 0.3, 0, 0, False, "")

Parameter

RgbColorLongByVal
Farbe der Fläche.
AmbientDoubleByVal
Umgebungslicht, 0 bis 1.
DiffuseDoubleByVal
Diffus, größer 0 bis 1.
SpecularDoubleByVal
Glanz, größer 0 bis 1.
ShininessDoubleByVal
Glanzstärke, größer 0 bis 1.
TransparencyDoubleByVal
Transparenz, 0 bis 1.
EmissionDoubleByVal
Leuchten, 0 bis 1.
UsePartPropsBooleanByVal
True: Fläche übernimmt die Werte des Teils.
FaceNameStringByVal
Name für die Fläche.

Rückgabewert

True, wenn die Werte gesetzt wurden. False auch dann, wenn die Fläche schon einen Namen hat (siehe Bemerkungen).

Beispiel

' swModel ist ein Teil, in dem eine Fläche ausgewählt ist.
Dim bOk As Boolean
bOk = swModel.SelectedFaceProperties(RGB(255, 0, 0), 0.5, 0.8, 0.5, 0.3, 0, 0, False, "")
swModel.ActiveView.GraphicsRedraw Empty
Debug.Print "Gesetzt: " & bOk

Bemerkungen

Damit die Farbe sichtbar wird, müssen Diffus, Glanz und Glanzstärke größer als 0 sein, und der Grafikbereich muss neu gezeichnet werden. Die Hilfe beschreibt RgbColor nicht näher; RGB() aus VBA ist anzunehmen.

Hat die Fläche schon einen Namen, ändert der Befehl ihn nicht und liefert False, damit Bezüge (etwa Verknüpfungen) nicht kaputtgehen. Ob die Farbe in diesem Fall trotzdem gesetzt wird, sagt die Hilfe nicht.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001Plus

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

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