When you write a Rich UI widget (or an external-type widget, as described in another topic), you can ensure that widget-specific properties are in the Properties view whenever you use the EGL editor to create a widget of the new type. You make the properties available by setting @VEProperty for each widget field that you want to list in the Properties view. @VEProperty is useful only when the @VEWidget and @EGLProperty properties are set.
mySimpleProperty String {
@EGLProperty{},
@VEProperty{category = "Basic"}};
myChoiceProperty String{
@EGLProperty{},
@VEProperty{category = "Advanced",
propertyType = "choice",
choices = [
@VEPropertyChoice {displayName = "3D", id = "3"},
@VEPropertyChoice {displayName = "4D", id = "4"}
]}};
Not shown are the functions that get and set the EGL properties.
The categories in the Properties view are in reverse order of their initial reference in the Rich UI widget or external type. The last-specified category is listed first, and the categories that are available for all widgets are displayed last. Similarly, the properties in a given category are in reverse order of declaration in the Rich UI widget or external type.
Changes to @VEProperty are available to a file in the EGL editor only if you refresh the palette and the file. To refresh the palette, click the Refresh palette tool on the Design surface, as noted in “Using the tools on the Design surface.” To refresh the file, click the Refresh web page tool on the Preview tab, as noted in “Running a web application in the EGL Rich UI editor.”