Определяет, находится ли активное или заданное окно впереди всех остальных окон.

WONTOP([WindowName])

Parameters

WindowName

Задает имя окна, проверяемого функцией WONTOP( ). Можно задать имя пользовательского окна, созданного с помощью команды DEFINE WINDOW, или системного окна (окна команд, окна представления, окна просмотра и т.д.). Если аргумент WindowName опущен, WONTOP( ) возвращает имя окна, находящегося впереди всех окон. Также вы можете использовать пустую строку для WindowName, чтобы задать главное окно Visual FoxPro. Если на переднем плане находится окно отладки, окно трассировки или окно Command и вы не задали имени окна, функция WONTOP( ) возвращает пустую строку. В процессе отладки программы, использующей функцию WONTOP( ), на работу программу не влияет перевод этих системных окон на передний план.

Результат

Символьный или логический

Замечания

Функция WONTOP( ) возвращает значение "истина" (.T.), если заданное окно находится на переднем плане. Если окно находится не на переднем плане или не существует вообще, возвращается значение "ложь" (.F.).

По традиции предыдущих версий Visual FoxPro, окно Data Session всегда упоминалось как окно View. Дополнительно, управление этим окном осуществлялось, командами HIDE WINDOW, ACTIVATE WINDOW, WONTOP( ), также именует это окно как окно View. Visual FoxPro продолжает обращаться к окну View для функции WONTOP( ) .

Пример

В данном примере с помощью функции WONTOP( ) отображается имя окна переднего плана. Перед запуском этой программы откройте какие-либо системные окна (окна просмотра, окно представления и т.д.).

  Копировать код
IF NOT EMPTY(WONTOP( ))
   WAIT WINDOW 'Frontmost window: ' + WONTOP( )
ELSE
   WAIT WINDOW 'No windows are open'
ENDIF

Смотреть также