Запускает скомпилированную форму или набор форм, созданных в дизайнере форм.

DO FORM FormName | ? [NAME VarName [LINKED]] [WITH cParameterList]
   [TO VarName] [NOREAD] [NOSHOW]

Параметры

FormName

Указывает имя формы или набор форм для запуска.

?

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

NAME VarName [LINKED]

Определяет переменную или элемент массива, из которых вы можете обращаться к форме или набору форм. Если вы укажите переменную, которая еще не существует, то Microsoft Visual FoxPro автоматически создаст ее. Если вы укажите элемент массива, то в этом случае, массив должен существовать до выдачи команды DO FORM. Если переменная или массив, указанные вами, уже существуют, то их содержимое будет переписано новым.

Если вы опустите опцию NAME, Visual FoxPro создаст переменную объектного типа с тем же самым именем, которое имеет файл формы или набора форм.

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

WITH cParameterList

Определяет параметры, посылаемые форме или набору форм.

Если запущен набор форм, параметры передаются в метод Init набора форм, если свойство WindowType набора форм установлено в значение ModeLess (0) или Modal (1). В случае, если значение свойства WindowType набора форм установлено в Read (2) или ReadModal (3), то параметры посылаются в метод Load набора форм.

TO VarName

Указывает переменную для хранения значения, возвращаемого формой. Если переменная еще не существует, Visual FoxPro автоматически создаст ее. Используйте команду RETURN в процедуре события Unload формы для указания возвращаемого значения. Если вы не указали возвращаемое значение, то будет возвращено дефолтное true (.T.). Если вы используете TO, то свойство формы WindowType должно быть установлено в 1 (Modal). Если процедура события Init формы возвращает .F., экземпляр формы не будет создан,и процедура события Unload не вернет значения в VarName.

NOREAD

Определяет, что форма будет создана и отображена, хотя элементы управления будут заблокированы до выпуска команды READ. NOREAD игнорируется, если свойства объекта набора форм WindowType установлено в 2 (Read).

NOSHOW

Определяет, что метод формы Show не будет вызван при запуске формы. Когда вы включаете ключевое слово NOSHOW и запускаете форму, форма остается невидимой до тех пор, пока свойство формы Visible не будет установлено в true (.T.) или не будет вызвать метод формы Show.

Примечания

Пример

Приведенный ниже пример запускает пример - Swatch.scx.

	Скопировать код
DO FORM (HOME(2) + 'Solution\Controls\Timer\Swatch.scx')

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