FavoriteMaterials.itemByName Method

Parent Object: FavoriteMaterials
Defined in namespace "adsk::core" and the header file is <Core/Materials/FavoriteMaterials.h>

Description

Returns the specified Material using the name as seen in the user interface. This often isn't a reliable way of accessing a specific material because materials are not required to be unique.

"favoriteMaterials_var" is a variable referencing a FavoriteMaterials object.returnValue = favoriteMaterials_var.itemByName(name)

"favoriteMaterials_var" is a variable referencing a FavoriteMaterials object.

#include <Core/Materials/FavoriteMaterials.h>

returnValue = favoriteMaterials_var->itemByName(name);

Return Value

Type	Description
Material	Returns the specified material or null if there isn't a matching name.

Parameters

Name	Type	Description
name	string	The name of the material to return,.

Version

Introduced in version August 2014