Allows you to define, view, and manipulate identifiers available in your interface. Select Identifiers from the Browser Managers menu to display the Identifier Manager:
Using identifiers
The Identifier Manager allows you to create and edit the list of identifiers associated with a given interface. You can use these identifiers as follows:
· Parameters in callbacks accessible through the Callback Editor
· Parameters in the creation routine
· Variables which are defined at run-time
When you specify a new identifier in the Identifier Manager, Callback Editor, or Creation Routine dialog, Builder Xcessory adds the new identifier to the Identifier Manager.
Identifier Manager File Menu
Select File from the Identifier Manager menu bar (with the mouse or with a mnemonic) to display the Identifier Manager File menu:
Identifier Manager Edit Menu
Select Edit from the Identifier Manager menu bar, with the mouse or with a mnemonic, to display the Identifier Manager Edit menu:
Identifier Editor
Select Edit Identifier from the Identifier Manager Edit menu to display the Identifier Editor:
Type
Specify whether the Identifier Type is Predefined or User Defined using the toggle buttons to the right of the Type label.
Output File Option Menu
The Output File Option Menu allows you to specify the file to which the identifier will be written when Builder Xcessory generates UIL. See File Placement for more detailed information.
Click the arrow button to the right of the Type text field to view all types which are either Predefined or User Defined (depending on the toggle setting).
Predefined types
The following table lists Predefined types:
The equivalent C data types are listed in the Type Manager.
Note: Identifiers cannot be type None.
User-defined types
The User-defined types are all types which you have specified in the Type Manager, Procedure Manager, Callback Editor, or Creation Routine dialog.
Identifiers of type Undeclared or of any user-defined type may be used for resources that have either a type of XtPointer or no obvious type (for example, XmNcolormap or XmNscreen).
Referencing identifiers in the Resource Editor
You can enter an identifier name of the appropriate type in a resource's text field, or choose one from the Ident pop-up list on the resource placement options menu, in the Resource Editor. See Resource Editor for more detailed information on the Resource Editor.
Note: Identifiers are not evaluated within the Builder Xcessory. The widget with a modified resource value retains its last resource value within the Builder Xcessory.
The identifier name is output as the resource value in the Builder Xcessory's generated code. You are responsible for assigning a valid value to the identifier elsewhere in your application code before your application attempts to evaluate the identifier at run-time.
When an identifier is referenced in the Builder Xcessory, you cannot cut the identifier from the Identifier Manager.
Referencing identifiers in styles
You can use an identifier as part of a style definition by entering the identifier name in the appropriate text field on the Style Editor. The identifier will remain un-evaluated. No value will be assigned to the widget resources affected by the style within the Builder Xcessory, but output code will reflect the correct value. See Styles for more detailed information.
Referencing identifiers in Extended Editors
You can select an identifier from any of the Builder Xcessory's extended editors. Selecting the Identifier radio button displays a combination box which contains the names of all identifiers of the appropriate type. Refer to Extended Editors for more detailed information about extended editors.
Example
This example describes how to apply an identifier to the value resource of a text widget instance in your interface.
Creating the identifier
To create the identifier, perform the following steps:
1. Select Identifiers from the Browser Managers menu.
2. Select Create Identifier from the Identifier Manager Edit menu.
3. double-click on the new identifier to bring up the Identifier Editor.
4. In the Identifier Editor, change the name of the identifier to "my_value" (without quotation marks).
5. Change the type of the identifier to the predefined type Compound String.
6. Click the Apply button on the Identifier Editor to update the identifier. Notice that the changes are displayed in the Identifier Manager.
Setting the value resource to the identifier
Set the value resource of this widget to the identifier in one of the following ways:
· Click on the resource placement options menu to the right of the value resource text field, and select my_value.
· Use the following procedure:
1. Click the (...) button to the right of the value resource to display the Compound String Editor.
2. Click the Ident toggle to the right of Resource Placement at the bottom of the Compound String Editor. This updates the dialog to contain a text field and an arrow button.
3. Click the arrow button to the right of the Identifier Name text field to view all existing identifiers. Select my_value and click the Apply button at the bottom of this dialog.
· Enter my_value into the value resource text field on the Resource Editor and click OK.
These methods all assign the identifier name to the text widget's value resource in the code generated by the Builder Xcessory.
Note: The value within the Builder Xcessory does not change.