| Object Class: _setAttributeValue |
Sets the value for a specific attribute on an
object
|
return = objectName._setAttributeValue( );
|
When
_setAttributeValue executes, it performs the following sequence of actions:
- Determines if requested attribute is defined; returns 2 if attribute
is undefined and processing ends.
- Determines if value matches the attribute's type; returns 3 if
it does not match and processing ends.
- Determines value of attribute metadata item EDITABLE; returns
5 if 'No' and processing ends.
- If attribute has a specified VALIDVALUES item, determines whether
value is found in list (or specified SLIST entry) or executes the SCL entry
defined for VALIDVALUES; returns 4 if value is not in VALIDVALUES.
Processing continues to setCAM.
- Executes setCAM if one is defined for the attribute; returns 7
if the CAM cannot execute, otherwise returns the value returned from the CAM.
- Sets the value for the attribute.
- Refreshes the region if object is a
visual control.
- If attribute metadata item SENDEVENT='Yes', _setAttributeValue:
- executes the _bAttributeChanged method at design time (if running
in a frame context)
- sends the 'attribute-name Changed'
event
- checks the Object Class: contentsUpdatedAttributes
attribute and sends the 'contents updated' event if the attribute is listed
If you add a setCAM to an attribute,
_setAttributeValue returns the
return value from your CAM as the value for rc.
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.
