UpPreviousNext

Identifier Manager

Allows you to define, view, and manipulate identifiers available in your interface. Select Identifiers from the Browser Managers menu to display the Identifier Manager:

 

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 File Menu

Dismiss

Allows you to dismiss the Identifier Manager.

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 Manager Edit Menu

Cut

Cuts the currently selected identifier and places it in the identifier buffer, provided it is not referenced in the current interface.

Copy

Copies the currently selected identifier to the identifier buffer.

Paste

Pastes the contents of the identifier buffer.

Create Identifier

Creates a new identifier.

Edit Identifier

Displays the Identifier Editor for the currently selected identifier.

Identifier Editor

Select Edit Identifier from the Identifier Manager Edit menu to display the Identifier Editor:

 

Identifier Editor

Name

Specify the name of the identifier in the Name text field.

Type

Specify whether the Identifier Type is Predefined or User Defined using the toggle buttons to the right of the Type label.

· Predefined

Defined by default when Builder Xcessory starts up. Their UIL and C/C++ equivalents are listed in the Type Manager, and appear "locked" so that they may not be cut.

· User Defined

Appear unlocked in the Type Manager. A new type may be declared in the Identifier Editor by selecting the User Defined radio box and entering the new type in the Type text field. Builder Xcessory will prompt you for confirmation and then add the new type to the Type Manager.

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:

Asciz Table

Font

Single Float

Boolean

Font List

String

Color

Integer

String Table

Color Table

Integer Table

Translation Table

Compound String

Keysym

Undeclared

Float

Pixmap

None

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.

Create a text widget and update the Resource Editor.

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.
UpPreviousNext