Category Custom user interface, Object ProUIDialog

Function ProUIDialogCreate


Description
Loads a dialog from a resource file into memory. If the resource file name is NULL, creates an empty dialog.

Note: The dialog name specified in the resource file must match both 'resource' input argument and the name of the resource file without name suffix. 'session_dialog_name' input argument can be anything. It's important that Pro/TK apps a. use dialog resources whose resource names do not clash with PTC-defined resources b. use dialog instance (session) names which also do not clash with PTC-defined instance (session) names. The usual approach to ensure uniqueness in this context is to make sure both Dialog resource and instance (session) names make use of a prefix pertaining to the name of the Pro/TK app.

Synopsis
#include <ProUIDialog.h>
ProErrorProUIDialogCreate(
char* session_dialog_name
/* (In)
The name of the dialog
*/
char* resource
/* (In)
The name of the resource file
*/
)
Returns
PRO_TK_NO_ERRORThe function successfully loaded and displayed the dialog
PRO_TK_GENERAL_ERRORThe function failed

Manual References:

  1. User Interface: Dialogs: Dialog Operations
  2. User Interface: Dialogs: Dialog Operations
  3. User Interface: Dialogs: Syntax of Resource Files

Sample Code References:

  1. pt_examples ( TestUITable.c )
  2. pt_geardesign ( GearDesignUI.c )
  3. pt_install_cxx ( TestInstall.cxx )
  4. pt_install_test ( TestInstall.c )
  5. pt_mfg_proctable ( PTMfgProcTable.c )
  6. pt_userguide ( UgUIListImplement.c )
  7. pt_userguide ( UgUISlider.c )
  8. pt_userguide ( UgUITables.c )
  9. pt_userguide ( UgUITables.c )
  10. pt_userguide ( UgUITables.c )
  11. pt_userguide ( UgUITables.c )
  12. pt_userguide ( UgUIVisibility.c )
  13. pt_userguide ( UgUIYesnoDialog.c )
  14. pt_userguide ( UgUtilUI.c )