Directory Opus Manual

AddChildGroup

<object:TabGroup> or <string:name>

object:TabGroup

Adds a new tab group to the list of tab groups. You can either provide a TabGroup object or the name for the new group. If the operation succeeds a TabGroup object is returned which represents the new tab group. If the operation fails False is returned.

Save

none

none

Saves the tab group list and any changes you have made.
Note that this only saves changes made to the object it is called on, and each use of DOpus.TabGroups creates a new, independent object. Therefore, you should modify tab groups like this (JScript):

var tabGroups = DOpus.TabGroups;
var group = tabGroups.AddChildGroup("New Tab Group");
if (!group)
	DOpus.Output("Group already exists");
else {
	group.desc = "Example description";
	var tabs = group.tabs;
	tabs.AddTab("C:\\");
	tabGroups.Save();
}

And not like this:

// This will not work correctly.
var group = DOpus.TabGroups.AddChildGroup("New Tab Group");
if (!group)
	DOpus.Output("Group already exists");
else {
	group.desc = "Example description";
	group.tabs.AddTab("C:\\");
	DOpus.TabGroups.Save(); // <-- Incorrect
}

The second example will not work because the last line creates a second, unrelated snapshot of the current state, which is unaffected by the unsaved changes to the first snapshot, and then saves the second snapshot without making any changes to it.