Функция WCHILD( )

Возвращает число дочерних окон в родительском окне или имена дочерних окон в порядке их размещения в родительском окне.

Синтаксис

WCHILD([WindowName] [nChildWindow])

Параметры

WindowName

Задает окно (отличное от активного окна вывода), для которого функция WCHILD( ) возвращает число дочерних окон. Если задано имя окна без числового выражения nChildWindow, возвращается только число дочерних окон заданного окна.

Если задать оба аргумента, WindowName и nChildWindow, WCHILD( ) возвращает имена дочерних окон в заданном окне. Если вы задали оба аргумента, разделите их запятой.

Также вы можете использовать пустую строку для WindowName, чтобы задать главное окно Visual FoxPro.

nChildWindow

Задает числовое выражение, предписывающее возвратить имена дочерних окон в активном окне вывода, если опущен аргумент WindowName.

Числовое выражение nChildWindow может задавать 0 или произвольное положительное число. Если значение nChildWindow равно 0, возвращается имя дочернего окна со дна стека дочерних окон текущего окна вывода.

Если nChildWindow задает положительное число, функция WCHILD( ) возвращает имя следующего дочер его окна в стеке окон. Если вы снова выдадите WCHILD( ) с положительным чис ом, будет возвращено имя следующего дочернего окна из стека и т.д. Если число в зовов функции WCHILD( ) превысит количество дочерних окон в родительском окне, возвращается пустая строка. Подробнее о работе со стеком окон см. команду ACTIVATE WINDOW.

Замечание В Visual FoxPro, FoxPro для Windows и FoxPro для MS-DOS когда активно основ ое окно FoxPro, все окна являются дочерними по отношению к нему. В Visual FoxPro панели инструментов, не зафиксированные у границы основного окна FoxPro, яв яются его потомками. При выдаче серии функций WCHILD( ) с положительными числами возвращаются имена активных окон и панелей инструментов. В FoxPro для Macintosh дочерние окна основного окна Visual FoxPro образуются только при выдаче коман ы DEFINE WINDOW или ACTIVATE WINDOW с предложением IN SCREEN.

Если вы задали оба аргумента, WindowName и nChildWindow, разделите их запятой.

Результат

Символьный или Числовой

Комментарии

Вы можете создать окно и разместить внутри него другие окна; первое окно будет родительским, а находящиеся в нем дочерними. Чтобы создать дочернее окно внутри родительского, можно воспо ьзоваться командой DEFINE WINDOW с предложением IN или IN WINDOW. Дочернее окно, созданное и активизированное внутри родительского окна, не может быть выдвинуто за пределы последнего. При перемещении родительского окна дочернее окно движется вместе с ним.

Если выдать функцию WCHILD( ) без аргументов, возвращается число дочерних окон в активном окне вывода.