Возвращает заголовок активного или заданного окна.

WTITLE([WindowName])

Параметры

WindowName

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

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

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

Expand imageВозвращаемое значение

Символьного типа

Expand imageКомментарии

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, используйте следующую команду:

  CopyCode imageКопировать Код
HIDE WINDOW "Report Controls"

Дополнительные рекомендации по использованию имен окон   Если у вас нет уверенности в правильности наименования того или другого системного окна, откройте требуемое системное окно, имена открытых окон размещаются в нижней части соответствующего меню Window.

При выполнении команды BROWSE WINDOW WindowName в текущий момент существует два окна. Ситстемное окно Browse наследует атрибуты указанного пользовательского окна, но существует независимо отнего. Если имеется активное пользовательское окно, и выполняется команда BROWSE, без дополнительной опции WINDOW, тогда системное окно Browse принимает атрибуты текущего активного окна. Для отмены данных "наследующих" характеристик команды Browse используйте дополнительную опуию этой команды NORMAL .

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

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

  CopyCode imageКопировать Код
MOVE WINDOW invoice BY 1,1

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

Expand imageСм. также