Возвращает заголовок активного или заданного окна.
WTITLE([WindowName]) |
Параметры
- WindowName
-
Определяет имя окна, для которого функция WTITLE( ) возвращает заголовок. Заголовок окна определяется опцией TITLE, которая включена в команду создания пользовательского окна DEFINE WINDOW.
Когда вы используете команду типа BROWSE WINDOW... для открытия системного окна Browse в созданном ранее пользовательсеом окне, функция WTITLE( ) возвращает заголовок пользовательского окна, если окно Browse не имеет заголовкаe. WTITLE( ) возвращает заголовок системного окна Browse, если последнее имеет собственный заголовок.
Вы можете использовать пустую символьную строку в качестве параметра WindowName - для идентификации главного окна системы Visual FoxPro.
Возвращаемое значение
Символьного типа
Комментарии
WTITLE( ) обычно используется для определения заголовка окна, который размещается в верхней полосе рассматриваемого окна. Если параметр WindowName отсутствует, то возвращается заголовок активного в текущий момент окна. WTITLE( ) возвращает пустую строку, если открытими являются в текущий момент системные окна Debug, Trace или , Commnd, или, если вывод информации направлен в главное окно системы Visual FoxPro.
Имена Окон и их Заголовки. Имена ползовательских окон, системных окон, ToolBars (в Visual FoxPro), окна Browse назначаются в следующих случаях:
Для пользовательских оконопределяются соответствующие имена, указываемые в командах типа DEFINE WINDOW. Имеется некоторое различие между именем пользовательского окна и его заголовком. По-умолчанию, пользовательское окно не имеет заголовка. Если при создании окна используется опция задания заголовка TITLE, то данный заголовок появляется в верхней строке создаваемого пользовательского окна. Но данный заголовок не является именем данного окна.
По-умолчанию, каждое системное окно, как неотемлемая часть общего интерфейса системы Visual FoxPro, имеет собственное имя, совпадающее с заголовком данного окна. Явными примерами являются: окно Command, Data Session, Trace. В системе Visual FoxPro, каждая инструментальная панель (toolbar) имеет собственное стандартное имя.
Окно Программы или окно Редактирования, системное окно дизайнера Отчетов или Этикеток содержат в собственном заголовке имя редактируемого файла - программы или отчета.
Для системного окна Browse заголовок отределяется на основании порождающего окна. Имя и Заголовок системного окна Browse назначается тремя возможными способами: по-умолчанию - как имя соответствующего алиаса открытой таблицы данных, или наследуется от заголовка порождающего окна (если такое определено), или через соответствующую опцию команды Browse title... (если таковая определена).
По-умолчанию, системное окно Browse имеет имя, порождаемое алиасом соответствующей таблицы.
Для использования в языковых конструкциях имен системных окон или инструментальных панелей (toolbar) заключите их имена в двойные кавычки. Например, для скрытия системной инструментальной панели Report Controls toolbar, в Visual FoxPro, используйте следующую команду:
![]() | |
---|---|
HIDE WINDOW "Report Controls" |
Дополнительные рекомендации по использованию имен окон Если у вас нет уверенности в правильности наименования того или другого системного окна, откройте требуемое системное окно, имена открытых окон размещаются в нижней части соответствующего меню Window.
При выполнении команды BROWSE WINDOW WindowName в текущий момент существует два окна. Ситстемное окно Browse наследует атрибуты указанного пользовательского окна, но существует независимо отнего. Если имеется активное пользовательское окно, и выполняется команда BROWSE, без дополнительной опции WINDOW, тогда системное окно Browse принимает атрибуты текущего активного окна. Для отмены данных "наследующих" характеристик команды Browse используйте дополнительную опуию этой команды NORMAL .
Вы можете использовать сложные заголовки для окон, содержащие несколько слов, однако для имени окна используется только первое слово, часть заголовка, следующая за первым пробелом - игнорируется, данную особенность поведения необходимо использовать при использовании команд MOVE WINDOW, DEACTIVATE WINDOW, и функции WONTOP( ), нужно указывать только первое слово заголовка в качестве имени пользовательского окна.
Например, системное окно Browse, имеющее имя "Invoice Entry" может быть перемещено в другое место следующей командой:
![]() | |
---|---|
MOVE WINDOW invoice BY 1,1 |
Имена пользовательских окон не должны содержать пробелов, состоять из нескольких слов, однако окно Browse и другие системные окна могут иметь сложные имена, с пробелами.