Category Windows and views, Object ProAccessorywindow

Function ProAccessorywindowWithTreeMdlnameCreate


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. The window created is smaller than the one created by ProObjectwindowMdlnameCreate(). This window doesn't have the toolbar. It doesn't allow any options and has restricted options under Windows menu.

NOTE:

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: wfcWSession::CreateAccessorywindowWithTree
Synopsis
#include <ProWindows.h>
ProErrorProAccessorywindowWithTreeMdlnameCreate(
ProMdlName object_name
/* (In)
The name of the object to be retrieved
*/
ProType object_type
/* (In)
The type of the object (PRO_PART, PRO_ASSEMBLY, PRO_CATIA_PART, PRO_SW_ASSEM and so on)
*/
ProBoolean tree_flag
/* (In)
if PRO_B_TRUE enables model tree or disables otherwise.
*/
int* p_window_id
/* (Out)
The window identifier in which the object was retrieved
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully retrieved the window and attached the object to it.
PRO_TK_INVALID_TYPEYou specified an invalid object type.
PRO_TK_BAD_INPUTSEither you specified an invalid object name, or the window identifier is NULL.
PRO_TK_E_NOT_FOUNDThe 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.

Manual References:

  1. User Interface: Basic Graphics: Creating and Removing Windows
  2. Working with Multi-CAD Models Using Creo Unite: Working with Basic Graphics
  3. Working with Multi-CAD Models Using Creo Unite: Functions that Support Multi-CAD Assemblies
  4. Working with Multi-CAD Models Using Creo Unite: Superseded Functions
  5. Working with Multi-CAD Models Using Creo Unite: Restrictions on Character Length for Multi-CAD Functions

Sample Code References:

  1. pt_examples ( TestAsm.c )
  2. pt_examples ( TestDrwView.c )