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 BooleanbOk = 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.
UsePartPropsBooleanByValTrue: 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: " & bOkBemerkungen
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.