Returns information on the current state of the toolbox.
GSErrCode ACAPI_Environment ( APIEnv_GetToolBoxInfoID, API_ToolBoxInfo* toolBoxInfo, bool enableHidden );
Parameters
- toolBoxInfo
- [out] Miscellaneous information on the toolbox.
- enableHidden
- [in] Include hidden tools from the toolbox as well. This parameter is optional; if you pass nullptr in the second parameter, it defaults to
false
.
Return Values
NoError
- The function has completed with success.
APIERR_BADPARS
tboxInfo
is nullptr.APIERR_MEMFULL
- Low memory condition.
For other common API errors see the API Errors document.
Remarks
You can query the current state of the toolbox with this function. It returns information on the different installed items (external tools, too), and the active toolbox item (the active tool).
The enableHidden
flag tells Archicad to include hidden toolbox items as well. These are the tools which don’t have any icon in the toolbox, though using them puts Archicad into a state which works as if you chose one of the ‘real’ tools. A good example of this is the Slab Accessory.
Example
ACAPI_Environment (APIEnv_GetToolBoxInfoID, &toolBoxInfo, (void *) (GS::UIntPtr) true);
Requirements
- Version: API 4.1 or later
- Header: APIdefs_Environment.h