Resource Editor for Class Instances and Classes

The following sections describe the text fields displayed in the Resource Editor when you select a class instance or a class.

Resource Editor Text Fields for Class Instances

When updated for a class instance, the Resource Editor displays the following text fields:


Note: These text fields are automatically updated for the currently selected object, regardless of whether resource information has been updated.

Instance Name

Displays the class instance name, by default the UI Class Name, with the first letter of the name in lowercase.

Base Class

Displays the base name to which the C++ Source and Header suffixes will be appended. The File Base Name is set to the Class Name by default.

Derived Class

Displays the Builder Xcessory class name. By default, the Instance Name appended with Derived.


Note: Builder Xcessory generates and displays derived files only if you set Generate Derived Files on the Code Generation tab of the C++ Language Settings dialog. Refer to the section Toggle options for more information.

Note: Derived classes are provided for backward compatible code generation only. We do not recommend using Derived Classes unless you want backwards compatible code generation to Builder Xcessory versions previous to Builder Xcessory version 3.5.

Class Widget Resources

Below the text fields, the Resource Editor displays the Class Widget Resources. That is, any resources in a constituent widget of the class which have been set as Expose. These resources are identified as follows:

<widget instance name>.<resource name>

Example

For example, assume Class1 is composed of a main window with one child, a button box that has four push button children. In Classes View you set the backgrounds of the first two push buttons to red and blue, respectively, and set the button box's fill option to XiFill None. The resource setting of each resource is Code, but you also select Expose so that the values will be modifiable within a given instance of the class.

When you update the Resource Editor for class1, an instance of Class1, the following class widget resources are displayed:

Resource

Value

Setting

buttonBox.fillOption

XiFillNone

None

pushButton.background

red

None

pushButton1.background

blue

None


Note: Java class instances are the same as Motif class instances. However, the <resource-name> is replaced with the name of a Java class attribute.

Resource Editor Text Fields for Classes

In Classes View, when you select a class, the Resource Editor displays the following text fields:


Note: These text fields are always automatically updated for the currently selected widget, regardless of whether resource information has been updated.

Base Class

Name of currently selected Builder Xcessory class. Builder Xcessory enforces convention of single name with a capital letter.

Derived Class

Name of currently selected Builder Xcessory derived class. Builder Xcessory enforces convention of single name with a capital letter.

Builder Xcessory generates and displays derived files only if you set Generate Derived Files on the Code Generation tab of the C++ Language Settings dialog (from the Browser Options menu).


Note: Derived files are supported for C++ code generation option only as a backward compatibility option, and should not be used for new development.

Derived Class File

Base name to which the derived class C++ source and header files will be appended. The default value is the Derived Class. For example, files generated from Derived Class File "foo" will have the default names FooDerived.C (for the source file) and FooDerived.h (for the header file). By default, not displayed.


Note: Builder Xcessory generates and displays derived files only if you set Generate Derived Files on the Code Generation tab of the C++ Language Settings dialog (from the Browser Options menu).

 

Documentation: