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