MAXScript Language Reference > 3ds Max Objects > Node : MAXWrapper > XRef Objects and Scenes >

# XRef_Material : Material

    XRef_Material - superclass: material; super-superclass:MAXWrapper - 5:5 - classID: #(657198411, 1126842699)

Instances of this class are used to XRef materials from external .MAX files.Available in 3ds Max 8 and higher.

Constructors:

    XRef_Material ... XRefmaterial ...

Properties:

    <XRef_Material>.nested BooleanClass default: false -- bool;

Contains true if the XRef material is nested, false otherwise.

Read-only.

    <XRef_Material>.srcFileName UndefinedClass default: undefined -- filename;

Contains the source file name.

Read-only.

    <XRef_Material>.srcItemName UndefinedClass default: undefined -- string;

Contains the name of the source item.

Read-only.

    <XRef_Material>.unresolved BooleanClass default: true -- bool;

Contains true if the XRef is unresolved, false otherwise.

Read-only.

    <XRef_Material>.xrefRecord UndefinedClass default: undefined -- Interface;

Contains the XRef record Interface.

Read-only.

XRef_Material interfaces:

    Interface:IXRefItem

Properties:

    Interface:IXRefItem

Properties:

    <XRef_Material>.srcFileName : filename : Read

Contains the source file name.

Read-only.

    <XRef_Material>.srcItemName : string : Read

Contains the name of the source item.

Read-only.

    <XRef_Material>.xrefRecord : Interface : Read

Contains the XRef record Interface.

Read-only.

    <XRef_Material>.unresolved : bool : Read

Contains true if the XRef is unresolved, false otherwise.

Read-only.

    <XRef_Material>.nested : bool : Read

Contains true if the XRef is nested, false otherwise.

Read-only.

Methods:

    <maxObject><XRef_Material>.GetSrcItem resolveNested:<bool>

    resolveNested default value: false

Returns the source item object of the XRef Material.

If the object is being referenced from nested files (in other words, the object is referenced from a Max file containing an XRef of the object from another file instead of the actual object) and resolveNested is set to true, nested XRef files will be resolved.

    <DWORD><XRef_Material>.GetParentItems <&maxObject array>parentItems

    parentItems is Out parameter

Returns an array of parent items in the by-reference Out parameter.

    <DWORD><XRef_Material>.GetRootItems <&maxObject array>rootItems

    rootItems is Out parameter

Returns an array of root items in the by-reference Out parameter.

    <DWORD><XRef_Material>.GetChildItems <&maxObject array>childItems

    childItems is Out parameter

Returns an array of child items in the by-reference Out parameter.

    <void><XRef_Material>.GetNodes <&node array>xrefNodes

    xrefNodes is Out parameter

Returns an array of XRef nodes in the by-reference Out parameter.

    Interface:IXRefMaterial

Methods:

    <material><XRef_Material>.GetSourceMaterial <bool>resolveNestedXRef

Returns the source material object. If resolveNestedXRef is set to true, nested XRef files will be resolved.