IPS_CreateCategory

 int IPS_CreateCategory ()

Returns

ID of the newly created category

Description

This command creates a new category. No parameters are required. After the commands execution, a new category appears in the category tree of IP Symcon. The category is intially named "Unnamed Object (ID: 12345)" or similar, depending on its ID. The command IPS_SetName can be used to provide a meaningful name to the new category.

If the category is meant to be a subcategory, it can be moved to its designated parent by using the command IPS_SetParent.

The function returns an ID that can clearly identify the generated category.

Example

// Create a new category called "Rain sensing"
$CatID = IPS_CreateCategory();       // Creating a Category
IPS_SetName($CatID, "Rain sensing"); // Category name