AMembers Function |  |
-- todo --
Places the names of properties, procedures, and member objects for an object into a variable array.
Namespace: XSharp.VFP
Assembly: XSharp.VFP (in XSharp.VFP.dll) Version: 2.21
SyntaxFUNCTION AMembers( ArrayName, oObjectNameOrClassName, nArrayContentsID, cFlags ) AS USUAL CLIPPER
Parameters
- ArrayName (Optional)
- Type: Usual
Specifies the array into which the names of the member properties for oObjectName are placed. If you specify the name of an array that doesn't exist, the array is automatically created. If the array isn't large enough to contain all the names, X# automatically increases the size of the array. - oObjectNameOrClassName (Optional)
- Type: Usual
Specifies the object or X# class whose member properties are placed in the variable array specified with ArrayName. This can be any expression that evaluates to an object, such as an object reference, an object variable, or an object array element. - nArrayContentsID (Optional)
- Type: Usual
Specifies the contents of an array. - cFlags (Optional)
- Type: Usual
Specify the filtering applied to the array returned by the AMembers( ) function. cFlags will not function when AMembers( ) is passed a COM object (the value of ArrayContentsID is 3). Some flags are mutually exclusive so that if you use more than one cFlag, use them in the following groupings:1[P | H | G] [N | U] [C] [I | B] [R]
Return Value
Type: UsualNumeric
Remarks| Description | |||
|---|---|---|---|
| 0 | Specifies that the array contains a single column of property names. Omitting the nArrayContentsID parameter is the same as passing a 0. | ||
| 1 | Specifies that the array contains the names of the properties of the object or class, as well as the methods and member objects. The resulting array is two-dimensional with the second column specifying what type of member is listed in the first column. The possible values for the second column are Property, Event, Method, or Object. | ||
| 2 | Specifies that the array contains the names of objects that are members of a native X# object specified with oObjectName. The resulting array is one-dimensional. This option provides a method to determine the names of child objects in a container such as all Form objects in a form set or controls in a form. | ||
| 3 |
Specifies that the array contains information about one or more objects. You can pass an object reference to either a native X# object or to a COM object.
|
Note| Column | Description |
|---|---|
| 1 | Name of the event or method |
| 2 | Property type (for example, PROPERTYPUT, PROPERTYGET, PROPERTYPUTREF, METHOD) |
| 3 | Function signature (parameters and their types, and the function return type). This information is similar to the Quick Info text provided in IntelliSense expansion of a method. |
| 4 | Help string |
The tables below describe the valid values for cFlags.
| Value | Filter Flags |
|---|---|
| P | Protected properties, methods, or events |
| H | Hidden properties, methods, or events |
| G | Public properties, methods, or events |
| N | Native (Intrinsic) properties, methods, or events |
| U | User-Defined (Extrinsic) properties, methods, or events |
| C | Changed properties (but not changed array properties) |
| I | Inherited properties, methods, or events |
| B | Base properties, methods, or events (using the AddProperty method) |
| R | Read-Only Properties |
| Value | Special Flags |
|---|---|
| # | Adds a new column to the output array with the corresponding cFlags value. |
| + | Performs logical AND between filter flags. |
X#
1oExcel = CreateObject("excel.application") 2= AMembers(gaPropArray, oExcel, 3)
ExamplesX#
1Clear 2goForm1 = CreateObject("Form") // Creates a Form 3= AMembers(gaPropArray, goForm1, 1) // Array containing Form properties 4Display MEMORY LIKE gaPropArray // Display the Form properties
See Also