Функция WTITLE( )

Возвращает заголовок, назначенный активному или заданному окну.

Синтаксис

WTITLE([WindowName])

Параметры

WindowName

Задает окно, заголовок которого возвращает функция WTITLE( ). Если вы указали имя пользовательского окна, созданного с помощью команды DEFINE WINDOW, возв ащается заголовок, присвоенный окну в предложении TITLE.

Когда вы выдаете команду BROWSE WINDOW, чтобы открыть окно просмотра в по ьзовательском окне, функция WTITLE( ) возвращает заголовок пользовательского окна, если у окна просмотра нет заголовка. Если заголовок у окна просмотра есть, WTITLE( ) возвращает этот заголовок.

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

Результат

Символьный

Имена и заголовки окон

Имена присваиваются пользовательским окнам, системным окнам, панелям инструме тов (в Visual FoxPro) и окнам просмотра следующим образом.

Пользовательским окнам имена присваиваются, когда они создаются по команде DEFINE WINDOW. Существует разница между именами пользовательских окон и их заго овками. По умолчанию у пользовательских окон не бывает заголовков. Если при созда ии окна включить предложение TITLE, то заданный заголовок будет изображен вдо ь верхней границы окна; но он не является именем окна.

По умолчанию каждое системное окно, которое является частью интерфейса Visual FoxPro, получает имя на основе заголовка окна. Примерами системных окон служат окно команд, окно представления и окно трассировки. В Visual FoxPro имя каждой панели инструментов получается из заголовка панели инструментов.

Окна программ, окна редактирования, окна конструктора этикеток и конструктора отчетов формируют имена по имени файла, который в них создается или модифици уется.

Окно просмотра выводит свое имя из заголовка окна. Имя и заголовок п исваиваются окну просмотра одним из трех способов: берется либо заголовок, принимаемый по умолчанию (псевдоним таблицы), либо заголовок окна (если он существует), либо заголовок окна просмотра (если он существует).

По умолчанию именем окна просмотра служит псевдоним таблицы.

Чтобы задать имена системного окна и панели инструментов в командах и фу кциях, заключите в кавычки все имя системного окна или панели инструментов. Наприме , чтобы скрыть панель инструментов Report Controls в Visual FoxPro, выполните с едующую команду:

HIDE WINDOW "Report Controls"

Дополнительные замечания об именах окон

Если вы не вполне уверены, какое имя присвоено тому или иному окну, взгляните а меню Window. В нижней части этого меню перечислены все имена окон.

Когда вы выдаете команду BROWSE WINDOW WindowName, образуются два окна. Окно просмотра это отдельно существующее окно, которое наследует все атрибуты заданного по ьзовательского окна. Если в момент выдачи BROWSE есть активное окно, а предложе ие WINDOW вы не включили, окно просмотра принимает атрибуты активного окна. Этот порядок можно изменить, задав в команде BROWSE предложение NORMAL.

В командах и функциях, использующих имена окон, таких как MOVE WINDOW, DEACTIVATE WINDOW и WONTOP( ), можно задавать имена окон с пробелами: для этого нужно задать связную часть имени, которая начинается с первого символа, отличного от пробела, и кончается последним символом, отличным от пробела.

Например, окно просмотра Invoice Entry можно переместить с помощью следующей команды:

MOVE WINDOW invoice BY 1,1

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

Комментарии

Функцию WTITLE( ) можно использовать для возвращения заголовка окна, который изображается на верхней границе окна. Если опустить аргумент WindowName, возвращается заголовок для активного окна. Если активно окно отладки, окно т ассировки или окно команд или если вывод направлен в основное окно Visual FoxPro, функция WTITLE( ) возвращает пустую строку.