Function ProObjectwindowMdlnameCreate
Description
Retrieves a window and attaches the object to it. If the window is already open with the object attached, the function returns the window identifier. If there is an empty window up, the function attaches the object to it. Otherwise, the function creates a new window and attaches the object to it.
NOTE:
This function should be used only when the application must display more than one object simultaneously. Under normal circumstances, use ProMdlDisplay() to show an object in the current or base window. This function should be used on model present in the session. Note: In Creo 3 this function does not support names longer than 80 characters. It will return PRO_TK_BAD_INPUTS for longer names. The support for ProMdlName will be added in a future release.
Replacement in Object TOOLKIT: |
Synopsis
#include <ProWindows.h>
ProObjectwindowMdlnameCreate | |
( ProMdlName object_name /* (In) The name of the object to be retrieved */ ProType object_type /* (In) */ int* p_window_id /* (Out) The window identifier in which the object was retrieved */ ) |
Returns
The function successfully retrieved the window and attached the object to it. | |
You specified an invalid object type. | |
Either you specified an invalid object name, or the window identifier is NULL. | |
The Creo Parametric user interface is not prepared to handle this request (because it is blocked by another process such as an OLE container activation). | |
The application is trying to open an embedded model (that is, a model representing a single body of a multi-body foreign object) in a separate window. This operation is not supported. |
Sample Code References
User Guide References