## 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