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

See Also

RemoveUserTab ClearUserTab GetUserTab SetUserTab AddUserKeyword RemoveUserKeyword ClearUserKeyword GetUserKeyword SetUserKeyword