@EGLProperty is a field-level
property for Rich UI widgets. It identifies EGL functions that get
and set the EGL field value when an EGL Rich UI application uses the
property.
You can use this property without specifying function names if
the names of the functions are specified with the word
get or
set followed
by the variable name. For example, if the variable is
UpperLimit and
the Rich UI Widget type includes functions named
getUpperLimit() and
setUpperLimit(),
you only need to add the complex property, as in this example:
UpperLimit INT { @EGLProperty{} };
The property fields in
@EGLProperty are
as follows:
- getMethod
- A string (enclosed in quotation marks) containing the name of
the get method for the specified variable (do not include parentheses).
The method has no parameters, and its return value has the same type
as the field.
- setMethod
- A string (enclosed in quotation marks) containing the name of
the set method for the specified variable (do not include parentheses).
The method has one parameter that has the same type as the field.
By convention the setMethod does not have a return value, but no error
condition results if the method returns a value.
To indicate that a field is read only or write only, you can specify
only one of the two property fields. If the Rich UI application tries
to read or write to a property for which the read or write is not
supported, an error occurs during EGL compilation.
For external-type widgets, the property equivalent to @EGLProperty is @JavaScriptProperty,
as described in “External type for JavaScript code.”