This method inserts an object into a container control window (WC_CONTAINER). These container windows can be created by an application or by the system (such as those in folders and Settings notebooks). Objects inserted using this method automatically inherit the default Workplace Shell behavior, such as context menus, and drag and drop capabilities.
When an object is inserted into a container, the Workplace Shell adds a USAGE_RECORD item to the object's in-use list. There will be one USAGE_RECORD item for each view (container control window) that the object is inserted into. See wpAddToObjUseList for more information on an object's in-use list.
This method sends the CM_INSERTRECORD message to the container control window.
wpCnrRemoveObject should be called to remove each record before the container window is destroyed.
The OBJECT_FROM_PREC (prec) macro can be used to obtain a pointer to the object (WPObject *) associated with a given MINIRECORDCORE structure that was inserted using wpCnrInsertObject.
The USER_FROM_PREC(prec) macro can be used to access the application-definable 32-bit field within the MINIRECORDCORE structure created when an object is put into a list control using wpCnrInsertObject.