Creates a new Navigator View.

    GSErrCode ACAPI_Environment (
        API_NavigatorItem*     navigatorItem,
        API_NavigatorView*     navigatorView,
        const GS::Guid*         parentAndChildGuids



[in/out] The item used for creating the view; its guid member will be filled on output.
[out] The created view (unless the navigator item’s type is API_FolderNavItem).
This parameter is used, when one wants to create a new folder item on the view map, and in this case the navigatorView parameter can be nullptr. If you create an other type of element, then this parameter can be nullptr.
This is an array of two GS::Guids. The first guid is the guid of the node whereunder the new navitem will be placed (the “parent”). The second (the “child”) is whereafter the new item will be placed.


Return Values

The function has completed with success.
You will encounter with this return value, if something was wrong with the parameters, for example the item was nullptr, orin the parentAndChild array, the first guid is not the guid of the second’s father.

For other common API errors see the API Errors document.



This is an example for folder item creation, based on the Navigator_Test test addon.

API_NavigatorItem navItem = {};
navItem.mapId = API_PublicViewMap;
navItem.itemType = API_FolderNavItem;
CHCopyC ("This test folder is created through API.", navItem.name);

GS::Guid parentAndChild[2];
Int32 selected = DGTreeViewGetSelected (dialogID, NavTreeView, DG_TVI_ROOT);
Int32 selParent = DGTreeViewGetItem (dialogID, NavTreeView, selected, DG_TVG_PARENT);
parentAndChild[0] = APIGuid2GSGuid (NavigatorTestGlobals::Instance ().GetNavigatorItem (TruncateTo32Bit (DGTreeViewGetItemUserData (dialogID, NavTreeView, selParent))));
parentAndChild[1] = APIGuid2GSGuid (NavigatorTestGlobals::Instance ().GetNavigatorItem (TruncateTo32Bit (DGTreeViewGetItemUserData (dialogID, NavTreeView, selected))));

ACAPI_Environment (APIEnv_NewNavigatorViewID, &navItem, nullptr, &parentAndChild);



This function is a non-undoable data structure modifier function. See more details on this topic at Command Overview.



Version: API 13 or later
Header: APIdefs_Environment.h


See Also

API Functions