Scripting: AddUserTab

AddUserTab

Introduced

v8.0 (2010)

Description

Adds a user tab to each object in the specified list. User tabs are lists of comma-separated strings, identical to user keywords, except that they are shown as tabs in the Material Manager. Presently, they are not used anywhere else in the software.

To replace an existing tab in the list, use the SetUserTab command instead.

Scripting Syntax

AddUserTab( [InputObjs], Keywords );

Parameters

Parameter	Type	Description
InputObjs	SelectionList or Selection	Default Value: If not specified, the current selection is used.
Keywords	String	User tabs to set, as a comma separated list

Examples

COM (C++) Example

NewScene
SICreateMaterial "$XSI_DSPRESETS\Shaders\Material\Phong.Preset", "Phong", , , False
SICreateMaterial "$XSI_DSPRESETS\Shaders\Material\Lambert.Preset", "Lambert", , , False
SICreateMaterial "$XSI_DSPRESETS\Shaders\Material\Blinn.Preset", "Blinn", , , False
SetUserTab "Sources.Materials.DefaultLib.Phong,Sources.Materials.DefaultLib.Lambert", "blue,orange"
AddUserTab "Sources.Materials.DefaultLib.Phong", "red,brown"
AddUserTab "Sources.Materials.DefaultLib.Blinn", "yellow,teal"
RemoveUserTab "Sources.Materials.DefaultLib.Phong,Sources.Materials.DefaultLib.cone,Sources.Materials.DefaultLib.torus","yellow,orange"
dim KeywordCollection 
set KeywordCollection = GetUserTab( "Sources.Materials.DefaultLib.Phong" )
for each keyword in KeywordCollection
LogMessage "Phong User Tabs:" & keyword
next
LogMessage "All User Tabs:"
set KeywordCollection = GetUserTab( "Sources.Materials.DefaultLib.Phong,Sources.Materials.DefaultLib.Lambert,Sources.Materials.DefaultLib.Blinn" )
for each keyword in KeywordCollection
LogMessage keyword
next