4.1.3.15 Specifying Tab (Page) Captions, IDs, and Names

If you are creating a tabbed dialog (or a wizard) the fourth page of the Origin Dialog AppWizard will allow you to add however many tabs (or pages) your dialog will contain. The AppWizard automatically adds two tabs (or pages) to your dialog because presumably you will want at least two tabs (pages) otherwise you would probably have created a simple dialog project. The AppWizard also allows you to add additional tabs (pages) by entering the information below and then clicking the Add button.

Specifying Tab (Page) Captions, IDs, and Names image137.gif

  1. Enter the desired caption for the new tab (page) in the Caption text box. The caption displays as the title of the tab (page).
  2. Enter a resource ID string for the new tab (page) in the Resource ID text box. The resource ID string will be added to the Symbol header file as a #define directive. The Origin Dialog AppWizard will automatically set the correct numeric ID value in the #define directive. You need only specify the resource ID string. For a tab (page), use the notation: IDD_STRING where IDD_ is literal and STRING can be any letters or numbers. You can type the characters in uppercase, lowercase, or mixed case. The AppWizard and Visual C++ will maintain the case of the characters that you enter.
  3. Enter the desired Origin C name for the new tab (page) in the Origin C Name text box. The text that you enter in the Origin C Name text box is the name you will use to communicate with the tab (page) inside your Origin C program in Origin. The Origin Dialog AppWizard will automatically define an Origin C Dialog derived class for each tab (page) based on the text that you enter for it in the Resource ID and Origin C Name text boxes. This name can not contain spaces. It is also case-sensitive.


In addition to adding tabs (pages) the fourth page of the AppWizard allows you to change the order of existing tabs (pages) by selecting them in the list and then clicking the Up or Down buttons. Tabs (pages) can also be deleted by selecting them in the list and clicking the Remove button. Once a tab (page) is added it can not be edited. Tabs (pages) can only be edited by removing and then re-adding them as desired.

After entering the above tab (page) related information click the Finish button to close the AppWizard and open the New Project Information dialog. Peruse the information in the New Project Information dialog and then click OK to create you dialog resource and Visual C++ project.