WCHILD( ) (Función)
Devuelve el número de ventanas secundarias de una ventana primaria o los nombres de las ventanas secundarias en el orden en el que están apiladas en la ventana primaria.
WCHILD([WindowName] [nChildWindow])
Valores devueltos
Character o Numeric
Parámetros
WindowName
Especifica una ventana distinta de la ventana de resultado activa cuyo número de ventanas secundarias devuelve WCHILD( ). Si solamente incluye un nombre de ventana sin la expresión numérica nChildWindow, devolverá el número de ventanas secundarias de la ventana especificada.Si incluye las dos expresiones, WindowName y nChildWindow, WCHILD( ) devolverá los nombres de las ventanas secundarias de la ventana especificada. Si incluye tanto WindowName como nChildWindow, separe WindowName de nChildWindow con una coma.
También puede incluir la cadena vacía en WindowName para especificar la ventana principal de Visual FoxPro.
nChildWindow
Especifica una expresión numérica incluida para devolver los nombres de las ventanas secundarias de la ventana de resultados activa en caso de que se omita WindowName.La expresión numérica nChildWindow puede ser 0 o cualquier valor positivo. Si nChildWindow es 0, se devolverá el nombre de la ventana secundaria de la parte inferior de la pila de ventanas secundarias de la ventana de resultados actual.
Si nChildWindow es un número positivo, WCHILD( ) devuelve el nombre de la siguiente ventana secundaria de la pila de ventanas. Si ejecuta WCHILD( ) otra vez con un número positivo, se devolverá el nombre de la siguiente ventana secundaria de la pila y así sucesivamente. Se devolverá la cadena vacía si se invoca WCHILD( ) más veces que el número de ventanas secundarias de la ventana primaria. Para obtener más información acerca de las pilas de ventanas, vea ACTIVATE WINDOW.
Nota En Visual FoxPro para Windows, si la ventana principal de Visual FoxPro está activa, todas las ventanas son secundarias de esta ventana principal de Visual FoxPro. En Visual FoxPro, las barras de herramientas que no estén acopladas en el borde de la ventana principal de Visual FoxPro son secundarias de dicha ventana. Al ejecutar un conjunto de funciones WCHILD( ) con números positivos, se devuelven los nombres de las ventanas y barras de herramientas activas.
Si incluye tanto WindowName como nChildWindow, separe WindowName de nChildWindow con una coma.
Observaciones
Puede crear una ventana (la ventana primaria) y colocar dentro otras ventanas (las ventanas secundarias). Al incluir la cláusula IN o IN WINDOW en DEFINE WINDOW se creará una ventana secundaria dentro de una ventana primaria. Una ventana secundaria creada y activada dentro de una ventana primaria no puede trasladarse fuera de la ventana primaria. Si se mueve la ventana primaria, la ventana secundaria se moverá con ella.
Si ejecuta WCHILD( ) sin ningún argumento, se devolverá el número de ventanas secundarias de la ventana de resultados actual.