Hide Table of Contents
IAddDisplayStateSpecificRenderMaterial Method (IModelDocExtension)

Adds the specified material to the specified display states in the active configuration and returns the IDs assigned to that material.

.NET Syntax

Visual Basic (Declaration) 
Function IAddDisplayStateSpecificRenderMaterial( _
   ByVal PRenderMaterial As RenderMaterial, _
   ByVal DisplayStateOption As System.Integer, _
   ByVal DisplayStateCount As System.Integer, _
   ByRef DisplayStateNames As System.String, _
   ByRef PWMaterialId1 As System.Integer, _
   ByRef PWMaterialId2 As System.Integer _
) As System.Boolean
Visual Basic (Usage) 
Dim instance As IModelDocExtension
Dim PRenderMaterial As RenderMaterial
Dim DisplayStateOption As System.Integer
Dim DisplayStateCount As System.Integer
Dim DisplayStateNames As System.String
Dim PWMaterialId1 As System.Integer
Dim PWMaterialId2 As System.Integer
Dim value As System.Boolean
value = instance.IAddDisplayStateSpecificRenderMaterial(PRenderMaterial, DisplayStateOption, DisplayStateCount, DisplayStateNames, PWMaterialId1, PWMaterialId2)
System.bool IAddDisplayStateSpecificRenderMaterial( 
   RenderMaterial PRenderMaterial,
   System.int DisplayStateOption,
   System.int DisplayStateCount,
   ref System.string DisplayStateNames,
   out System.int PWMaterialId1,
   out System.int PWMaterialId2
System.bool IAddDisplayStateSpecificRenderMaterial( 
&   RenderMaterial^ PRenderMaterial,
&   System.int DisplayStateOption,
&   System.int DisplayStateCount,
&   System.String^% DisplayStateNames,
&   [Out] System.int PWMaterialId1,
&   [Out] System.int PWMaterialId2


Material to add
Display states as defined in swDisplayStateOpts_e
Number of display states (see Remarks)
  • in-process, unmanaged C++: Pointer to an array of the names of the display states to which to add material
  • VBA, VB.NET, C#, and C++/CLI: Not supported

See In-process Methods for details about this type of method. 

First ID of material
Second ID of material

Return Value

True if material is added, false if not


Before calling this method, call IConfiguration::GetDisplayStatesCount to get DisplayStateCount.

See Also


SOLIDWORKS 2011 FCS, Revision Number 19.0

Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

Subject:   Feedback on Help Topics
Page:   IAddDisplayStateSpecificRenderMaterial Method (IModelDocExtension)
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:


We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again

Web Help Content Version: API Help (English only) 2018 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.