nca_java_set_area_class

Example: nca_java_set_area_classJava Object Functions

Sets the area class property for a Java object.

void nca_java_set_area_class( void * ReplyPropList );
ReplyPropList A list of reply properties.

The nca_java_set_area_class function sets the area class property, IXPROP_JAVA_AREA_CLASS (397), for a Java object.

This function is entered in the script when the server creates Java objects that have the property.

The ReplyPropList argument is two-dimensional array of strings . The first string in each dimension is the Java object's name, either the latest value of property IXPROP_TITLE (129) or the object's HandlerId value if no later property was specified for the object. The second string is the value of the IXPROP_JAVA_AREA_CLASS (397) property , sent to or specified by the server. The third string is the event name: the value of property IXPROP_JAVA_AREA_EVENT_NAME (399) that the recorded client application sent. The fourth string is the value that should be supplied. It consists of properties, IXPROP_JAVA_AREA_ARG_NAME (400) and IXPROP_JAVA_AREA_ARG_VALUE (401), separated with a double equality sign (==). If the properties are absent, pass an empty string.

Where the property has multiple values that must be set, use a parameter for the values rather than entering each value in a separate row of JavaClassProp. For example, this definition with multiple values for mGetProperty is invalid for use with nca_java_set_area_class:

char* JavaClassProp[][4] = {
	{ "GRID_BLOCK_GRID_ITEM_0",
		"oracle.apps.jtf.table.SpreadTableWrapper",
		"resourceRequest", "resources==[29]" },
	{ "GRID_BLOCK_GRID_ITEM_0",
		"oracle.apps.jtf.table.SpreadTableWrapper",
		"resourceRequest", "resources==[42]" },
	{ "GRID_BLOCK_GRID_ITEM_0",
		"oracle.apps.jtf.table.SpreadTableWrapper",
		"resourceRequest", "resources==[89]" },
	{ 0, 0, 0, 0 }

To pass multiple values of "resources", specify a parameter in the parameters table, named p_Resources in this example, and set the values. In this example, the values for p_Resources are "resources==[29]", "resources==[42]", and "resources==[89]". Define the parameter as sequential and to be modified each occurrence. Then use this declaration:

char* JavaClassProp[][4] = {
	{ "GRID_BLOCK_GRID_ITEM_0",
		"oracle.apps.jtf.table.SpreadTableWrapper",
		"resourceRequest", "{p_Resources}" },
	{ 0, 0, 0, 0 }

This and other nca_java functions can be sent to the server as a single packet by wrapping the set of nca_java calls with nca_step_begin and nca_step_end functions.

Return Values

Oracle NCA Error Codes

Parameterization

Parameterization is not available for this function.