APIEnv_​DeleteNavigatorViewID

Deletes the given navigator view.

    GSErrCode ACAPI_Environment (
        APIEnv_DeleteNavigatorViewID,
        const API_Guid*     viewGuid,
        const bool*     silentMode
    );

 

Parameters

viewGuid
The unique identifier of the view.
silentMode
This parameter is used for turn on/off the warning messages comes from ARCHICAD during deleting a view.

 

Return Values

NoError
The function has completed with success.
APIERR_BADPARS
You will encounter with this return value, if something was wrong with the parameters.

For other common API errors see the API Errors document.

 

Example

This is an example for view deletion, based on the Navigator_Test test addon.


 Int32 selected = DGTreeViewGetSelected (dialogID, NavTreeView, DG_TVI_ROOT);
 if (DBERROR (selected == DG_TVI_NONE))
	    return;

 bool silentMode = true;
 API_Guid guid = NavigatorTestGlobals::Instance ().GetNavigatorItem ((UIndex) DGTreeViewGetItemUserData (dialogID, NavTreeView, selected));
 ACAPI_Environment (APIEnv_DeleteNavigatorViewID, &guid, &silentMode);

 

Remarks

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

 

Requirements

Version: API 17 or later
Header: APIdefs_Environment.h

 

See Also

ACAPI_Environment,
API Functions