AINSTANCE( ) (Función)

Coloca todas las instancias de una clase en una matriz de variables y devuelve el número de instancias colocadas en la matriz.

AINSTANCE(ArrayName, cClassName)

Valores devueltos

Numeric

Parámetros

• ArrayName
  Especifica el nombre de la matriz en que se sitúan las instancias. Si la matriz que especifica no existe, Visual FoxPro la creará automáticamente. Si existe y no es suficientemente grande para dar cabida a todas las instancias, Visual FoxPro aumentará automáticamente su tamaño. Si la matriz es mayor de lo necesario, Visual FoxPro reducirá su tamaño. Si existe y AINSTANCE( ) devuelve 0 porque no encuentra ningún nombre, permanecerá sin cambios. Si la matriz no existe y AINSTANCE( ) devuelve 0, la matriz no se creará.

  Solamente se incluyen en la matriz las instancias de clase asignadas a variables y elementos de matriz con CREATEOBJECT( ) o NEWOBJECT( ).

• cClassName
  Especifica un nombre de clase de base de Visual FoxPro o un nombre de clase definida por el usuario. La tabla siguiente indica las clases de base de Visual FoxPro que se pueden especificar para cClassName:

  Nombres de clase de base
  ActiveDoc	Etiqueta
  CheckBox	Line
  Columna	ListBox
  ComboBox	OLEControl
  CommandButton	OLEBoundControl
  CommandGroup	OptionButton
  Contenedor	OptionGroup
  Control	Página
  Cursor	PageFrame
  Custom	ProjectHook
  DataEnvironment	Relation
  EditBox	Separator
  Formulario	Session
  FormSet	Shape
  Cuadrícula	Spinner
  Header	TextBox
  Hyperlink	Timer
  Imagen	ToolBar

Ejemplo

En el ejemplo siguiente, CREATEOBJECT( ) se utiliza para crear dos instancias de la clase de base Form de Visual FoxPro. AINSTANCE( ) se utiliza para crear una matriz denominada gaMyArray que contiene las referencias a variables (goINSTANCE1 y goINSTANCE2) para cada instancia de formulario. A continuación, se muestra el contenido de la matriz.

CLEAR ALL
goINSTANCE1 = CREATEOBJECT('Form')
goINSTANCE2 = CREATEOBJECT('Form')

CLEAR
? AINSTANCE(gaMyArray, 'Form')  && Returns 2, two form instances 
DISPLAY MEMORY LIKE gaMyArray  && Displays the references

Vea también

ADD CLASS | AMEMBERS( ) | CREATE CLASS | CREATE CLASSLIB | CREATEOBJECT( ) | DEFINE CLASS