Function SelectedFaceProperties( _
   ByVal RgbColor As Integer, _
   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

Dim instance As IModelDoc2
Dim RgbColor As Integer
Dim Ambient As Double
Dim Diffuse As Double
Dim Specular As Double
Dim Shininess As Double
Dim Transparency As Double
Dim Emission As Double
Dim UsePartProps As Boolean
Dim FaceName As String
Dim value As Boolean
 
value = instance.SelectedFaceProperties(RgbColor, Ambient, Diffuse, Specular, Shininess, Transparency, Emission, UsePartProps, FaceName)

bool SelectedFaceProperties( 
   int RgbColor,
   double Ambient,
   double Diffuse,
   double Specular,
   double Shininess,
   double Transparency,
   double Emission,
   bool UsePartProps,
   string FaceName
)

bool SelectedFaceProperties( 
&   int RgbColor,
&   double Ambient,
&   double Diffuse,
&   double Specular,
&   double Shininess,
&   double Transparency,
&   double Emission,
&   bool UsePartProps,
&   String^ FaceName
) 

Parameters

RgbColor

Face color

Ambient

Face ambient value; valid range is from 0 to 1

Diffuse

Face diffuse value; valid range is from 0 to 1

Specular

Face specular value; valid range is from 0 to 1

Shininess

Face shininess value; valid range is from 0 to 1

Transparency

Face transparency value; valid range is from 0 to 1

Emission

Face emission value; valid range is from 0 to 1

UsePartProps

True if the face inherits the Part properties, false if not

FaceName

Name of the face

Return Value

True if face properties successfully changed, false if not

You can use the FaceName argument to set the name for this face.

If the face has a name, then this method does not change the name and returns false. This behavior is intended to prevent a program from renaming a face that is referenced in some other location.

For example, if an assembly contains a mate to a face on a part, then a name is automatically assigned to that face. If you change that name, then there is no guarantee that the mate will still be valid. Therefore, when using entity names, you should first check to see if the entity is already named, and, if so, use the existing name. If no name exists for the face, then you can assign the face a name.