Retrieves an attribute for a property, event, method, or object.
PEMSTATUS(oObjectName | cClassName, cProperty | cEvent | cMethod | cObject, nAttribute) |
Parameters
- oObjectName
- Specifies the object for which the property, event, method, or object attribute to return. oObjectName can be any expression that evaluates to an object, such as an object reference, an object memory variable, or an object array element. If oObjectName is a container object such as a form, you can determine attributes for objects in the container object.
- cClassName
- Specifies the class for which the property, event, or method attribute to return.
- cProperty
- Specifies the property for which the attribute to return.
- cEvent
- Specifies the event for which the attribute to return.
- cMethod
- Specifies the method for which the attribute to return.
- cObject
- Specifies the object for which the attribute to return. For example, you can use the AddObject method to add an object to a container object, and then use PEMSTATUS(В ) to return information about the object added to the container object.
- nAttribute
-
Specifies a numeric value that determines the property, event, or method attribute to return.
The following table lists the values for nAttribute and the corresponding property, event, or method attribute returned.
nAttribute Property, event, or method attribute 0
Changed.
If the property value, method, or event has changed, PEMSTATUS(В ) returns a logical True (.T.). Otherwise, PEMSTATUS(В ) returns logical False (.F.).
1
Read-only (properties only).
If the property is read-only, PEMSTATUS(В ) returns a logical True (.T.). Otherwise, PEMSTATUS(В ) returns a logical False (.F.).
2
Protected.
If the property, event, or method is protected, PEMSTATUS(В ) returns a logical True (.T.). Otherwise, PEMSTATUS(В ) returns a logical False (.F.).
3
Type.
PEMSTATUS(В ) returns a character string, for example, Property, Event, Method, or Object, indicating whether cProperty, cEvent,В cMethod or cObject is a property, event, method or object.
4
User-defined.
If the property, event, or method is a user-defined property, event, or method, PEMSTATUS(В ) returns a logical True (.T.). Otherwise, PEMSTATUS(В ) returns a logical False (.F.).
5
Defined property, event, method, or object.
If the property, event, method, or object exists for oObjectName or cClassName, PEMSTATUS(В ) returns a logical True (.T.). Otherwise, or for hidden native properties, PEMSTATUS(В ) returns a logical False (.F.).
6
Inherited property, event, method, or object.
If the property, event, method, or object for oObjectName or cClassName was inherited from another object or class, PEMSTATUS(В ) returns logical True (.T.). Otherwise, PEMSTATUS(В ) returns a logical False (.F.).
Return Value
Character or Logical. PEMSTATUS(В ) returns a character string or logical value for the attribute specified.
Remarks
PEMSTATUS(В ) does not detect for changes in specific array elements if the array is passed.