Creating and Assigning Identifiers

1. Open the alias file that you created.
2. (Optional) You can set options for new identifiers in advance. This will supply some of the information (e.g., starting value, prefix, include topic in ID name, assign skin) for you automatically as you create new identifiers. See Setting Identifier Options.
3. Do one of the following:

   • In the local toolbar of the Alias Editor click .

     OR

   • Right-click in the Identifiers side of the editor, and from the context menu select Auto Generate.

   The Generate Identifiers dialog opens.

4. In the Header area select one of the following, depending on whether you need to create a new header file or have an existing one you can select:

   • New from template This lets you choose either a factory template file or one of your own customized template files as a starting point. The new file will take on all of the settings contained in the template. If you want to use a factory template provided by Flare, expand the Factory Templates folder and click on a template file. If you want to use your own customized template file, expand the appropriate folder and click on a file. Click here to find out what templates are all about.

     After selecting a template, use the File Name field to enter a name for the new header file.

     Note: In some dialogs and wizards you can click the Manage Templates button if you want to open the Template Manager. This lets you manage any of your template files (e.g., add new templates, enter descriptions for templates). See Managing Templates.

   • Choose Existing This lets you choose an existing header file in your project. To use this option, click the drop-down field and select a header file.

5. (Optional) In the Identifier Options area, you can override any of the values that are already set in the Identifier Options dialog (see Step 2).

   • Starting value You can specify the starting value for identifiers that you create, with the value for additional identifiers being incremented automatically based on that starting value.

     

   • Prefix You can specify a prefix to be added at the beginning of each new identifier that you create (e.g., ID_, Dialog, Module1).

     

   • Include topic name in identifier name You can specify that new identifiers should automatically include the assigned topic in the name.

     

   • Capitalize identifier names You can specify that the name that is automatically added for new identifiers should have all caps.

     

   • Skins You can specify which skin should be assigned by default to new identifiers that are created. Of course, you can always manually select a different skin for any identifier, but when you first create a new identifier, it will initially be assigned to the default skin that you specified.

     

6. Click in the Generate Identifiers for field and select one of the following:

   • Unassigned topics only Select this if you already have some identifiers in the header file that are assigned to topics. New identifiers will be created only for topics in your project that are not yet assigned to an identifier.

     OR

   • All topics Select this if you want new identifiers to be created for all topics in your project, whether some topics are already assigned to new topics or not.
7. If you selected "All topics" in the previous step, click in the Existing Identifiers field and select one of the following:
   • Keep Select this if you want to keep the identifiers that you already have in the header file. As a result, you will have some topics that are assigned to multiple identifiers (the old identifier and the new one).
   • Delete Select this if you want to delete the existing identifiers in the header file, creating new ones instead. This way, you will not have any topics that are assigned to multiple identifiers.

8. Click Create.

   New rows are added in the Alias Editor with (instead of ) next to them. The green icon indicates that the identifiers are assigned to topics. If you have previously set identifier options (see Step 2), the identifier includes at least some of the appropriate information already.

9. (Optional) If you want a certain identifier to point to a specific bookmark or header in the assigned topic, do the following:
   1. Select the identifier row.
   2. Click (located above the identifier list).
   3. In the dialog that opens, select a bookmark or header.
   4. Click OK.

10. (Optional) If you want to change an identifier name, click twice in the Identifier cell and type the name (e.g., Properties_Dialog).

    Note: Make sure you use underscores between words because spaces are not allowed.

11. (Optional) If you want to change the skin associated with one or more identifiers, do the following:
    1. Select the identifier row(s). You can hold the SHIFT key to select a range, or you can hold the CTRL key to select individual items.
    2. Do one of the following:

       • Click the arrow in the Select skin button (located above the identifier list) and choose a skin from the drop-down.

         OR

       • Right-click somewhere in the list. From the context menu select Assign Skin and then from the submenu choose the name of the skin.

       

12. (Optional) If you want to change the numerical value for an identifier, click twice in the Value cell and type the new number.

    Note: You may need to use the horizontal scroll bar at the bottom of the editor to see this cell.

13. Press CTRL+S or click to save your work.

1. Open the alias file that you created.
2. (Optional) You can set options for new identifiers in advance. This will supply some of the information (e.g., starting value, prefix, include topic in ID name, assign skin) for you automatically as you create new identifiers. See Setting Identifier Options.

3. If you have more than one header file in your project, click the down arrow at the top-left side of the Alias Editor and select the header file for which you want to create identifiers. Otherwise, you can just leave "(all identifiers)" in the field.

   What if you have multiple header files in your project and you do not select a header file, leaving "(all identifiers)" shown in the drop-down field? In that case, the changes you made in the Alias Editor are applied to the primary header file that you have selected when setting identifier options. See Setting Identifier Options.

   

4. On the left side of the Alias Editor, select one or more identifiers that you want to assign to new identifiers.

   

   You can use the "multi-view" to locate topics. If you use the options to split the view into two halves, you can select multiple topics on the right side by holding down the SHIFT or CTRL keys as you click.

   

   	Shows all of the files in the project in a list in the area below. If you click the button again, it switches to a folder tree view. In the list, you can click the "File," "Type," or "Path" column headers to sort the list alphabetically by that column data.
   	Shows or hides the folders that the files are stored in.
   	Shows or hides the files. If you click this button when the "Show Folders" button is selected, the area splits into two halves. The folder is shown on the left side, and the files and subfolders within it are shown on the right.
   	If the "Show Files" button is the only one selected, you can click this button to move up one folder level.

5. Do one of the following:

   • Click (located above the file list).

     OR

   • Right-click on a topic on the left side of the editor, and from the context menu select Assign Topic to New Identifier.

   A new row is added with (instead of ) next to it. The green icon indicates that the identifier is assigned to a topic. If you have previously set identifier options (see Step 2), the identifier includes at least some of the appropriate information already.

6. (Optional) If you want the identifier to point to a specific bookmark or header in the topic, do the following:
   1. Select the identifier row.
   2. Click (located above the identifier list).
   3. In the dialog that opens, select a bookmark or header.
   4. Click OK.

7. (Optional) If you want to change the identifier name, click twice in the Identifier cell and type the name (e.g., Properties_Dialog).

   Note: Make sure you use underscores between words because spaces are not allowed.

8. (Optional) If you want to change the skin associated with one or more identifiers, do the following:
   1. Select the identifier row(s). You can hold the SHIFT key to select a range, or you can hold the CTRL key to select individual items.
   2. Do one of the following:

      • Click the arrow in the Select skin button (located above the identifier list) and choose a skin from the drop-down.

        OR

      • Right-click somewhere in the list. From the context menu select Assign Skin and then from the submenu choose the name of the skin.

      

9. (Optional) If you want to change the numerical value for the identifier, click twice in the Value cell and type the new number.

   Note: You may need to use the horizontal scroll bar at the bottom of the editor to see this cell.

10. Repeat these steps for each identifier that you want to add (each one to represent a different dialog or window in the software application).
11. Press CTRL+S or click to save your work.

1. Open the alias file that you created.

2. If you have more than one header file in your project, click the down arrow at the top-left side of the Alias Editor and select the header file for which you want to create identifiers. Otherwise, you can just leave "(all identifiers)" in the field.

   What if you have multiple header files in your project and you do not select a header file, leaving "(all identifiers)" shown in the drop-down field? In that case, the changes you made in the Alias Editor are applied to the primary header file that you have selected when setting identifier options. See Setting Identifier Options.

   

3. Do one of the following:

   • In the local toolbar click .

     OR

   • Right-click in the Identifiers side of the editor, and from the context menu select New Identifier.

   A new row is added with (instead of ) next to it. The yellow icon indicates that the identifier is not yet assigned to a topic. If you have previously set identifier options (see Step 2), the identifier includes at least some of the appropriate information already.

4. (Optional) If you want to change the identifier name, click twice in the Identifier cell and type the name (e.g., Properties_Dialog).

   Note: Make sure you use underscores between words because spaces are not allowed.

5. (Optional) If you want to change the skin associated with one or more identifiers, do the following:
   1. Select the identifier row(s). You can hold the SHIFT key to select a range, or you can hold the CTRL key to select individual items.
   2. Do one of the following:

      • Click the arrow in the Select skin button (located above the identifier list) and choose a skin from the drop-down.

        OR

      • Right-click somewhere in the list. From the context menu select Assign Skin and then from the submenu choose the name of the skin.

      

6. (Optional) If you want to change the numerical value for the identifier, click twice in the Value cell and type the new number.

   Note: You may need to use the horizontal scroll bar at the bottom of the editor to see this cell.

7. Repeat the these steps for each identifier that you want to add (each one to represent a different dialog or window in the software application).
8. Press CTRL+S or click to save your work.

1. Open the alias file that you created.
2. (Optional) If you want to see only the identifiers that are not yet assigned to topics, click in the local toolbar of the Alias Editor. This hides identifiers that are already assigned to topics in the editor until you click the button again.
3. On the right side of the Alias Editor, select an identifier that you want to assign to a topic.

4. On the left side of the Alias Editor, find a topic that you want to assign to the identifier that you selected in the previous step.

   

   You can use the "multi-view" to locate topics.

   

   	Shows all of the files in the project in a list in the area below. If you click the button again, it switches to a folder tree view. In the list, you can click the "File," "Type," or "Path" column headers to sort the list alphabetically by that column data.
   	Shows or hides the folders that the files are stored in.
   	Shows or hides the files. If you click this button when the "Show Folders" button is selected, the area splits into two halves. The folder is shown on the left side, and the files and subfolders within it are shown on the right.
   	If the "Show Files" button is the only one selected, you can click this button to move up one folder level.

5. Do one of the following:

   • Double-click the topic.

     OR

   • Click (located above the file list).

     OR

   • Right-click on the topic and from the context menu select Assign Topic to Selected Identifier.

   The topic name is added to the identifier row on the right side of the Alias Editor, and a green icon (instead of ) is displayed next to it. The green icon indicates that the identifier is assigned to a topic.

6. (Optional) If you want the identifier to point to a specific bookmark or header in the topic, do the following:
   1. Select the identifier row.
   2. Click (located above the identifier list).
   3. In the dialog that opens, select a bookmark or header.
   4. Click OK.
7. Press CTRL+S or click to save your work.

Following are explanations of the various buttons and context menu options in the Alias Editor, some of which have been included in the steps above.

New	Description
	Hide assigned identifiers This hides the identifiers that already have topics assigned to them. By doing this, you can concentrate solely on the identifiers that need topics assigned to them.
	Create new identifier Note: You can also perform this task by right-clicking in the Identifiers side of the editor, and from the context menu selecting New Identifier.
	Delete selected identifier Note: You can also perform this task by right-clicking in the Identifiers side of the editor, and from the context menu selecting Delete Identifier.
	Generate identifiers This lets you automatically generate new identifiers for all of the topics in your project. This is a good feature to use if you are creating identifiers in a header file for the first time. When you click this button, the Generate Identifiers dialog opens. In this dialog you can create a new header file or select an existing one. You can also see the identifier options—such as starting value, prefix, and skin—that will be applied to all of the new identifiers that are created. Note: You can also perform this task by right-clicking in the Identifiers side of the editor, and from the context menu selecting Auto Generate.
	Change identifier options This lets you specify options in advance for how new identifiers are created. See Setting Identifier Options. Note: You can also perform this task by right-clicking in the Identifiers side of the editor, and from the context menu selecting Options.
	Identifier warning This lets you see if there are any issues with identifiers in the editor, such as identifiers that are not yet assigned to topics.
	Previous warning This highlights the previous identifier in the list that has an issue.
	Next warning This highlights the next identifier in the list that has an issue.
	Assign topic to existing identifier Note: You can also perform this task by right-clicking on the topic, and from the context menu selecting Assign Topic to Selected Identifier.
	Create new identifier and assign topic to it at the same time Note: You can also perform this task by right-clicking on the topic, and from the context menu selecting Assign Topic to New Identifier.
	Open selected topic Note: You can also perform this task by right-clicking on the topic, and from the context menu selecting Open.
	Locate topic in header file This displays all header files where the selected topic is assigned to an identifier. Note: You can also perform this task by right-clicking on the topic, and from the context menu selecting Locate the Topic in Headers.
	Unassign topic from identifier Note: You can also perform this task by right-clicking in the Identifiers side of the editor, and from the context menu selecting Unassign Topic.
	Select bookmark in selected topic First you can select an identifier row that has already been assigned to a topic and then click this new button. A dialog opens, letting you select a bookmark within that topic. Note: You can also perform this task by right-clicking in the Identifiers side of the editor, and from the context menu selecting Select Bookmark.
	Select skin for identifier You can click the down arrow in the Select Skin button and choose the appropriate skin for the identifier.
	Not assigned This icon displays next to any identifiers that are not yet assigned to a topic.
	Assigned This icon displays next to any identifiers that have already been assigned to a topic.