Интерфейс Form

Класс Form кроме свойств контейнера имеет методы и свойства окна верхнего уровня: параметры заголовка окна, иконка, параметры рамки, главное меню, задание кнопок для часто встречающихся событий (AcceptButton, CancelButton, HelpButton), доступ к компоненту, имеющему фокус ввода, методы минимизации, развертывания окна. Подробнее...

Граф наследования:Form:

Граф связей класса Form:

Полный список членов класса


Открытые члены
	Minimize (void)
	Метод минимизирует форму.
	Restore (void)
	Метод развертывает форму обратно из минимизированного состояния.
	Maximize (void)
	Метод разворачивает форму во весь экран.
	Close (void)
	Метод закрывает форму.
	ShowModal (void)
	Метод показывает форму на экране, запрещая доступ к остальным окнам программы пока эта форма не будет закрыта.
	MessageBox ([in] BSTR Text,[in, defaultvalue("")] BSTR Caption,[in, defaultvalue(0)] LONG Flags,[out, retval] LONG *pResult)
	Метод выводит на экран окно с сообщением, возможно стандартным изображением и несколькими кнопками.
	ColorDialog ([in, defaultvalue(0x00FFFFFF)] ULONG StartColor,[in, defaultvalue(CC_DEFAULT)] ULONG Flags,[out, retval] ULONG *pColor)
	Метод выводит на экран стандартное диалоговое окно выбора цвета.
	FontDialog ([in] IDispatch StartValue,[in, defaultvalue(CF_DEFAULT)] ULONG Flags,[out, retval] IDispatch *pResult)
	Метод выводит на экран стандартное окно выбора параметров шрифта.
	OpenDialog ([in] BSTR DefaultExt,[in] BSTR Filter,[in, defaultvalue("")] BSTR StartFile,[in, defaultvalue(OFN_OPENDEFAULT)] ULONG Flags,[out, retval] BSTR *pFileName)
	Метод выводит на экран стандартное диалоговое окно открытия файла.
	SaveDialog ([in] BSTR DefaultExt,[in] BSTR Filter,[in, defaultvalue("")] BSTR StartFile,[in, defaultvalue(OFN_SAVEDEFAULT)] ULONG Flags,[out, retval] BSTR *pFileName)
	Метод выводит на экран стандартное диалоговое окно выбора имени файла для сохранения документа, параметры идентичны параметрам метода OpenDialog.
	SelectFolderDialog ([in] BSTR Title,[in, defaultvalue(BIF_DEFAULT)] ULONG Flags,[out, retval] BSTR *pFolder)
	Метод выводит на экран стандартное диалоговое окно выбора каталога.
	PrintDialog ([in, defaultvalue(PD_DEFAULT)] ULONG Flags,[in, defaultvalue(0)] USHORT MinPage,[in, defaultvalue(0)] USHORT MaxPage,[out, retval] IDispatch **pResult)
	Метод выводит на экран стандартное диалоговое окно печати.
	PrinterSetupDialog ([in, defaultvalue(PD_DEFAULT)] ULONG Flags,[out, retval] IDispatch **pResult)
	Метод выводит на экран стандартное диалоговое окно настройки принтера.
	PageSetupDialog ([in, defaultvalue(PSD_DEFAULT)] ULONG Flags,[out, retval] IDispatch **pResult)
	Метод выводит на экран стандартное диалоговое окно настройки страницы для печати.
	CreateFindDialog ([in, defaultvalue("")] BSTR FindText,[in, defaultvalue(FR_DOWN)] ULONG Flags,[out, retval] IDispatch **pResult)
	Метод создает стандартный диалог поиска текста, диалог сразу становится виден на экране.
	CreateReplaceDialog ([in, defaultvalue("")] BSTR FindText,[in, defaultvalue("")] BSTR ReplaceText,[in, defaultvalue(FR_DOWN)] ULONG Flags,[out, retval] IDispatch **pResult)
	Метод создает стандартный диалог поиска\замены текста, диалог сразу становится виден на экране.
	CreateFontDialog ([out, retval] IDispatch **pResult)
	Метод создает стандартный диалог выбора шрифта.
	CreateColorDialog ([out, retval] IDispatch **pResult)
	Метод создает стандартный диалог выбора цвета.
	CreateOpenDialog ([out, retval] IDispatch **pResult)
	Метод создает стандартный диалог открытия файла.
	CreateSaveDialog ([out, retval] IDispatch **pResult)
	Метод создает стандартный диалог сохранения файла.
	CreateSelectFolderDialog ([out, retval] IDispatch **pResult)
	Метод создает стандартный диалог выбора каталога.
	CreateForm ([in] LONG Left,[in] LONG Top,[in] LONG Width,[in] LONG Height,[in, defaultvalue(WS_DEFAULT)] LONG Style,[out, retval] IDispatch **pControl)
	Метод создает дочернюю форму, его параметры идентичны параметрам метода CreateForm объекта WindowSystemObject.
	CreateDialogForm ([in] LONG Left,[in] LONG Top,[in] LONG Width,[in] LONG Height,[in, defaultvalue(WS_DIALOGDEFAULT)] LONG Style,[out, retval] IDispatch **pControl)
	Метод создает дочернюю диалоговую форму, его параметры идентичны параметрам метода CreateForm объекта WindowSystemObject, за исключением значения по умолчанию параметра Style, выбранного таким образом чтобы создаваемая форма не могла менять свой размер или быть минимизирована.
Свойства
VARIANT W	Icon `[]`
	Свойство позволяет загрузить иконку из файла и изменить иконку формы на нее.
IDispatch *RW	Menu `[]`
	Свойство содержит в себе объект Action который описывает главное меню формы, можно назначать как существующий объект так и создавать новый (новый объект автоматически создается при попытке чтения свойства).
VARIANT_BOOL RW	KeyPreview `[]`
	Свойство если оно имеет значение "TRUE" (по умолчанию) события OnKeyUp, OnKeyDown у формы возникают, когда имеет фокус ввода один из компонентов на форме, иначе – только если фокус ввода имеет сама форма.
VARIANT_BOOL RW	MaximizeBox `[]`
	Свойство определяет отображение кнопки максимизации окна.
VARIANT_BOOL RW	MinimizeBox `[]`
	Свойство определяет отображение кнопки минимизации окна.
VARIANT_BOOL RW	ControlBox `[]`
	Свойство определяет отображение системного меню формы и кнопок в заголовке формы.
VARIANT_BOOL RW	SizeGrip `[]`
	Свойство определяет возможность изменения размеров формы пользователем.
VARIANT_BOOL RW	TopMost `[]`
	Свойство определяет находится ли форма поверх всех остальных окон, по умолчанию "FALSE".
VARIANT_BOOL RW	ToolWindow `[]`
	Свойство определяет является ли форма инструментальным окном, инструментальное окно имеет меньший заголовок и не имеет системного меню.
VARIANT_BOOL RW	Caption `[]`
	Свойство определяет наличие у формы заголовка.
IDispatch *RW	AcceptButton `[]`
	Позволяет задать кнопку по умолчанию, событие OnClick у такой кнопки возникает когда форма активна и пользователь нажимает клавишу ENTER.
IDispatch *RW	CancelButton `[]`
	Позволяет задать кнопку отмены по умолчанию, событие OnClick у такой кнопки возникает когда форма активна и пользователь нажимает клавишу ESCAPE.
IDispatch *RW	HelpButton `[]`
	Позволяет задать кнопку справки по умолчанию, событие OnClick у такой кнопки возникает когда форма активна и пользователь нажимает клавишу F1.
IDispatch *RW	ActiveControl `[]`
	Свойство позволяет установить или обратиться к компоненту формы, имеющему фокус ввода.
VARIANT_BOOL RW	CanClose `[]`
	Свойство разрешает или запрещает закрытие формы, по умолчанию "FALSE", это свойство также можно менять во время события OnCloseQuery.
ULONG W	Region `[]`
	Свойство, определяющее регион видимости окна.
IDispatch *R	TaskBar `[]`
	Объект TaskBar.
VARIANT_BOOL RW	Active `[]`
	Принимает значение "TRUE", если форма активна.
VARIANT_BOOL RW	Foreground `[]`
	Принимает значение "TRUE", если форма является окном, с которым работает пользователь.
VARIANT W	OnCloseQuery `[]`
	Свойство позволяет задать обработчик события OnCloseQuery.
VARIANT W	OnClose `[]`
	Свойство позволяет задать обработчик события OnClose.
VARIANT W	OnActiveControlChange `[]`
	Свойство позволяет задать обработчик события OnActiveControlChange.
VARIANT W	OnHitTest `[]`
	Свойство позволяет задать обработчик события OnHitTest.
VARIANT W	OnHint `[]`
	Свойство позволяет задать обработчик события OnHint.
VARIANT W	OnMinimize `[]`
	Свойство позволяет задать обработчик события OnMinimize.
VARIANT W	OnMaximize `[]`
	Свойство позволяет задать обработчик события OnMaximize.
VARIANT W	OnRestore `[]`
	Свойство позволяет задать обработчик события OnRestore.
VARIANT W	OnCopyData `[]`
	Свойство позволяет задать обработчик события OnCopyData.
VARIANT W	OnActivate `[]`
	Свойство позволяет задать обработчик события OnCopyData.
VARIANT W	OnEnterSizeMove `[]`
	Свойство позволяет задать обработчик события OnEnterSizeMove.
VARIANT W	OnExitSizeMove `[]`
	Свойство позволяет задать обработчик события OnExitSizeMove.

Подробное описание

Форма имеет также методы вызова различных диалогов: выдача сообщения, выбор цвета, выбор параметров шрифта, открытие файла, сохранение файла, выбор каталога, диалоги печати, и т. д. Также форма имеет методы для создания дочерних форм.

Форма имеет дополнительные события группы FormEvents.

Форма имеет логическое свойство KeyPreview, если оно имеет значение "TRUE" (по умолчанию) события OnKeyUp, OnKeyDown у формы возникают, когда имеет фокус ввода один из компонентов на форме, иначе – только если фокус ввода имеет сама форма.

Методы

Close ( void )

Метод закрывает форму.

ColorDialog	(	[in, defaultvalue(0x00FFFFFF)] ULONG	StartColor,
		[in, defaultvalue(CC_DEFAULT)] ULONG	Flags,
		[out, retval] ULONG *	pColor
	)

Метод выводит на экран стандартное диалоговое окно выбора цвета.

Аргументы:

	StartColor	начальный цвет
	Flags	может быть комбинацией следующих значений: CC_FULLOPEN в диалоговом окне будут сразу разверуты элементы для выбора пользователем произвольноно цвета, если этот флаг не задан пользователь может впоследствии нажать кнопку Define Custom Color CC_PREVENTFULLOPEN запрещает кнопку Define Custom Color CC_SHOWHELP отображение кнопки Help CC_SOLIDCOLOR выбирать сплошной цвет CC_ANYCOLOR разрешить выбор несплошных цветов

Возвращаемые значения:

pColor

выбранный цвет, COLOR_NONE если пользователь отменил выбор цвета

Заметки:: больше информации о флагах можно узнать в описании функции ChooseColor в Microsoft Platform SDK.

CreateColorDialog ( [out, retval] IDispatch ** pResult )

Метод создает стандартный диалог выбора цвета.

Возвращаемые значения:

pResult

создаваемый объект ColorDialog.

Начиная с:: 1.1.5.

CreateDialogForm	(	[in] LONG	Left,
		[in] LONG	Top,
		[in] LONG	Width,
		[in] LONG	Height,
		[in, defaultvalue(WS_DIALOGDEFAULT)] LONG	Style,
		[out, retval] IDispatch **	pControl
	)

Метод создает дочернюю диалоговую форму, его параметры идентичны параметрам метода CreateForm объекта WindowSystemObject, за исключением значения по умолчанию параметра Style, выбранного таким образом чтобы создаваемая форма не могла менять свой размер или быть минимизирована.

Заметки:: дочерняя форма не отображается кнопкой на панели задач

CreateFindDialog	(	[in, defaultvalue("")] BSTR	FindText,
		[in, defaultvalue(FR_DOWN)] ULONG	Flags,
		[out, retval] IDispatch **	pResult
	)

Метод создает стандартный диалог поиска текста, диалог сразу становится виден на экране.

Аргументы:

	FindText	начальное значение текста для поиска
	Flags	может быть комбинацией следующих значений: FR_DOWN переключатель направления поиска Down - Вниз будет включен FR_WHOLEWORD переключатель Match Whole Word Only - Только слово целиком будет включен FR_MATCHCASE переключатель Match Case - С учетом регистра будет включен FR_SHOWHELP кнопка Help - справка будет видна FR_NOUPDOWN переключатели направления поиска будут заблокированы FR_NOMATCHCASE переключатель Match Case - С учетом регистра будет заблокирован FR_NOWHOLEWORD переключатель Match Whole Word Only - Только слово целиком будет заблокирован FR_HIDEUPDOWN переключатели направления поиска будут скрыты FR_HIDEMATCHCASE переключатель Match Case - С учетом регистра будет скрыт FR_HIDEWHOLEWORD переключатель Match Case - С учетом регистра будет скрыт

Возвращаемые значения:

pResult

создаваемый объект FindReplaceDialog.

CreateFontDialog ( [out, retval] IDispatch ** pResult )

Метод создает стандартный диалог выбора шрифта.

Возвращаемые значения:

pResult

создаваемый объект FontDialog.

Начиная с:: 1.1.5.

CreateForm	(	[in] LONG	Left,
		[in] LONG	Top,
		[in] LONG	Width,
		[in] LONG	Height,
		[in, defaultvalue(WS_DEFAULT)] LONG	Style,
		[out, retval] IDispatch **	pControl
	)

Метод создает дочернюю форму, его параметры идентичны параметрам метода CreateForm объекта WindowSystemObject.

Заметки:: дочерняя форма не отображается кнопкой на панели задач

CreateOpenDialog ( [out, retval] IDispatch ** pResult )

Метод создает стандартный диалог открытия файла.

Возвращаемые значения:

pResult

создаваемый объект FileOpenSaveDialog.

CreateReplaceDialog	(	[in, defaultvalue("")] BSTR	FindText,
		[in, defaultvalue("")] BSTR	ReplaceText,
		[in, defaultvalue(FR_DOWN)] ULONG	Flags,
		[out, retval] IDispatch **	pResult
	)

Метод создает стандартный диалог поиска\замены текста, диалог сразу становится виден на экране.

Аргументы:

	FindText	начальное значение текста для поиска
	ReplaceText	начальное значение текста для замены
	Flags	аналогичен параметру Flags метода CreateFindDialog.

Возвращаемые значения:

pResult

создаваемый объект FindReplaceDialog.

CreateSaveDialog ( [out, retval] IDispatch ** pResult )

Метод создает стандартный диалог сохранения файла.

Возвращаемые значения:

pResult

создаваемый объект FileOpenSaveDialog.

CreateSelectFolderDialog ( [out, retval] IDispatch ** pResult )

Метод создает стандартный диалог выбора каталога.

Возвращаемые значения:

pResult

создаваемый объект SelectFolderDialog.

FontDialog	(	[in] IDispatch *	StartValue,
		[in, defaultvalue(CF_DEFAULT)] ULONG	Flags,
		[out, retval] IDispatch **	pResult
	)

Метод выводит на экран стандартное окно выбора параметров шрифта.

Аргументы:

	StartValue	некоторый объект FontEx, определяющий начальный шрифт
	Flags	может быть комбинацией следующих значений: CF_SCREENFONTS показывает только шрифты поддерживаемые только экраном CF_PRINTERFONTS показывает только шрифты поддерживаемые только принтером CF_BOTH показывает шрифты, независимо от того поддерживаются они экраном или принтером CF_SHOWHELP показывает кнопку Help CF_EFFECTS будут видны компоненты для выбора опций шрифта, таких как подчеркивание, перечеркивание, цвет шрифта CF_APPLY будет отображена кнопка Apply CF_ANSIONLY, CF_SCRIPTSONLY CF_NOVECTORFONTS, CF_NOOEMFONTS запрещает выбор векторных шрифтов CF_FIXEDPITCHONLY показывает только моноширные шрифты CF_WYSIWYG показывает шрифты поддерживаемые экраном и принтером CF_FORCEFONTEXIST указывает вывод сообщения об ошибке в случае попытки выбора пользователем выбрать шрифт или его стиль которые не существуют CF_SCALABLEONLY показывает только масштабируемые шрифты CF_TTONLY показывает только шрифты TrueType CF_NOFACESEL запрет выделения имени шрифта в момент открытия окна CF_NOSTYLESEL запрет выделения стиля шрифта в момент открытия окна CF_NOSIZESEL запрещает выделение размера шрифта в момент открытия окна CF_NOVERTFONTS показывает только горизонтально ориентированные шрифты

Возвращаемые значения:

pResult

новый объект FontEx с выбранными параметрами

Заметки:: больше информации о флагах можно узнать в описании функции ChooseFont в Microsoft Platform SDK.

Maximize ( void )

Метод разворачивает форму во весь экран.

MessageBox	(	[in] BSTR	Text,
		[in, defaultvalue("")] BSTR	Caption,
		[in, defaultvalue(0)] LONG	Flags,
		[out, retval] LONG *	pResult
	)

Метод выводит на экран окно с сообщением, возможно стандартным изображением и несколькими кнопками.

Аргументы:

	Text	текст сообщения
	Caption	заголовок окна с сообщением
	Flags	может быть комбинацией следующих флагов:

для определения какие кнопки будут в окне нужно указать один из флагов:

MB_ABORTRETRYIGNORE в окне есть три кнопки Abort, Retry и Ignore
MB_HELP в окне есть кнопка Help
MB_OK в окне есть кнопка OK (по умолчанию)
MB_OKCANCEL в окне есть кнопки OK и Cancel
MB_RETRYCANCEL в окне есть кнопки Retry и Cancel
MB_YESNO в окне есть кнопки Yes и No
MB_YESNOCANCEL в окне есть три кнопки Yes, No и Cancel
MB_CANCELTRYCONTINUE в окне есть три кнопки Cancel, Try Again и Continue, этот флаг можно использовать только если программа будет использоваться на операционных системах Microsoft Windows 2000/ XP и далее.

Для отображения стандартного изображения в окне нужно указать одно из значений:

MB_ICONEXCLAMATION, MB_ICONWARNING восклицательный знак
MB_ICONINFORMATION, MB_ICONASTERISK маленькая буква i в круге
MB_ICONQUESTION знак вопроса
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND знак стоп Можно определить кнопку по умолчанию путем указания одного из флагов:
MB_DEFBUTTON1 первая кнопка - кнопка по умолчанию, этот флаг считается заданным по умолчанию
MB_DEFBUTTON2 вторая кнопка - кнопка по умолчанию
MB_DEFBUTTON3 третья кнопка - кнопка по умолчанию
MB_DEFBUTTON4 четвертая кнопка - кнопка по умолчанию

Можно указать дополнительные флаги, более полно смотрите описание функции MessageBox в Microsoft Platform SDK.

Возвращаемые значения:

pResult

метод возвращает информацию о том какая кнопка была нажата, если окно имеет кнопку Cancel то будет возвращено значение IDCANCEL в случае нажатия клавиши ESC, нет кнопки Cancel - нажатие ESC не имеет никакого эффекта. Каждой кнопке также соответствует свое значение, возвращаемое функцией при нажатии на эту кнопку:

IDABORT кнопка Abort
IDCANCEL кнопка Cancel
IDCONTINUE кнопка Continue
IDIGNORE кнопка Ignore
IDNO кнопка No
IDOK кнопка OK
IDRETRY кнопка Retry
IDTRYAGAIN кнопка Try Again
IDYES кнопка Yes

Minimize ( void )

Метод минимизирует форму.

OpenDialog	(	[in] BSTR	DefaultExt,
		[in] BSTR	Filter,
		[in, defaultvalue("")] BSTR	StartFile,
		[in, defaultvalue(OFN_OPENDEFAULT)] ULONG	Flags,
		[out, retval] BSTR *	pFileName
	)

Метод выводит на экран стандартное диалоговое окно открытия файла.

Аргументы:

	DefaultExt	расширение файла по умолчанию, оно добавляется к имени файла в случае если пользователь не указал никакого расширения, данная строка не должна содержать разделителя - “.”.
	Filter	фильтр для файлов, фильтр должен состоять пар строк, разделенных знаком “\|”, первая строка в паре описывает фильтр, вторая строка - маски файлов, разделенный знаком “;”, например “Text Files \|.txt;.doc\|All Files\|.”, не включайте пробелы в маски
	StartFile	начальный файл
	Flags	может быть как для диалогового окна открытия файла так и для диалога сохранения файла комбинацией следующих значений: OFN_READONLY устанавливает переключатель Read Only OFN_OVERWRITEPROMPT для диалогового окна сохранения файла устанавливает вывод предупреждающего диалога с запросом перезаписи файла в случае если файл с указанным именем существует OFN_HIDEREADONLY скрывает переключатель Read Only OFN_NOCHANGEDIR восстанавливает каталог в начальное значение если пользователь меняет каталог в процессе поиска файлов, не используется в операционных системах Windows NT 4.0/2000/XP. OFN_SHOWHELP показывает кнопку Help OFN_NOVALIDATE разрешает содержание неверных символов в имени файла, которое указывает пользователь OFN_ALLOWMULTISELECT разрешает выбирать несколько файлов OFN_PATHMUSTEXIST пользователь должен указывать существующий путь OFN_FILEMUSTEXIST пользователь может выбирать только существующие файлы OFN_CREATEPROMPT в случае если пользователь выбрал несуществующий файл производится запрос у пользователя на разрешение создать новый файл OFN_SHAREAWARE если происходит ошибка связанная с доступом к сети она игнорируется OFN_NOREADONLYRETURN открываемый файл не должен быть только для чтения OFN_NOTESTFILECREATE указывает что файл не должен создаваться до закрытия диалогового окна, когда этот флаг указан не производится проверок на возможность записи на диск, наличия свободного места. OFN_NONETWORKBUTTON прятает кнопку Network OFN_NOLONGNAMES для диалогов старого стиля указывает чтобы для файлов отображались короткие имена (в формате 8.3) OFN_NODEREFERENCELINKS если указан этот флаг то в случае выбора ярлыка (*.LNK) возвращается имя этого файла, иначе того файла, на который ссылается ярлык OFN_LONGNAMES для диалогов старого стиля указывает чтобы для файлов отображались длинные имена OFN_DONTADDTORECENT Windows 2000/XP: не добавляет ссылку на этот файл в папку ранее открытых документов OFN_FORCESHOWHIDDEN Windows 2000/XP: указывает чтобы системные и скрытые файлы всегда отображались

Возвращаемые значения:

pFileName

выбранное имя файла, пустая строка если пользователь отменил выбор файла

Заметки:: больше информации о флагах можно узнать в описании функции GetOpenFileName в Microsoft Platform SDK.

Пример (JScript):

o = new ActiveXObject("Scripting.WindowSystemObject")

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 500
f.ClientHeight = 300
f.CenterControl()
f.Text = "Text Editor"

edit = f.CreateEdit(0,0,0,0)
edit.Align = o.Translate("AL_CLIENT")
edit.HideSelection = false
edit.MultiLine = true
edit.ScrollBars = o.Translate("SS_BOTH")

fileMenu = f.Menu.Add("File")
fileMenu.Add("Open","CTRL+O").OnExecute = FileOpen

fileMenu.NewLine()
fileMenu.Add("Exit","ESC").OnExecute = CloseFormHandler

function FileOpen(sender)
{
        var fileName = f.OpenDialog("","Text Files (*.txt)|*.txt")
        if (fileName != "")
        {
                var fs = new ActiveXObject("Scripting.FileSystemObject")
                var file = fs.OpenTextFile(fileName,1,false)
                edit.Clear()
                edit.Text = file.ReadAll()
        }
}

f.Show()

o.Run()

function CloseFormHandler(sender)
{
        sender.Form.Close()
}

PageSetupDialog	(	[in, defaultvalue(PSD_DEFAULT)] ULONG	Flags,
		[out, retval] IDispatch **	pResult
	)

Метод выводит на экран стандартное диалоговое окно настройки страницы для печати.

Аргументы:

Flags

может быть комбинацией следующих значений:

PSD_INTHOUSANDTHSOFINCHES отступы измеряются в дюймах
PSD_INHUNDREDTHSOFMILLIMETERS отступы измеряются в миллиметрах
PSD_DISABLEMARGINS запрет компонентов для задания отступов
PSD_DISABLEPRINTER запрет кнопки Printer
PSD_NOWARNING запрет вывода предупреждений когда выбран принтер не по умолчанию
PSD_DISABLEORIENTATION запрет компонентов настройки ориентации бумаги
PSD_DISABLEPAPER запрет компонентов настройки параметров бумаги таких как размер листа
PSD_SHOWHELP показывает кнопку Help
PSD_NONETWORKBUTTON скрытие кнопки Network

Возвращаемые значения:

pResult

возвращает информацию о настройках печати в виде объекта PageSetupDialog в случае если пользователь нажал кнопку OK. В случае отмены возвращается NULL.

Заметки:: больше информации о флагах можно узнать в описании функции PageSetupDlg в Microsoft Platform SDK.

PrintDialog	(	[in, defaultvalue(PD_DEFAULT)] ULONG	Flags,
		[in, defaultvalue(0)] USHORT	MinPage,
		[in, defaultvalue(0)] USHORT	MaxPage,
		[out, retval] IDispatch **	pResult
	)

Метод выводит на экран стандартное диалоговое окно печати.

Аргументы:

	Flags	может быть комбинацией следующих значений: PD_ALLPAGES флаг указывает установку переключателя All PD_SELECTION флаг указывает установку переключателя Selection PD_PAGENUMS флаг указывает установку переключателя Pages PD_NOSELECTION запрет переключателя Selection PD_NOPAGENUMS запрет переключателя Pages PD_COLLATE установка переключателя Collate PD_PRINTTOFILE установка переключателя Print to File PD_NOWARNING запрет вывода предупреждений когда выбран принтер не по умолчанию PD_SHOWHELP показывает кнопку Help PD_USEDEVMODECOPIES, PD_USEDEVMODECOPIESANDCOLLATE указывает возможность печати копий PD_DISABLEPRINTTOFILE запрет переключателя Print to File PD_HIDEPRINTTOFILE скрытие переключателя Print to File PD_NONETWORKBUTTON скрытие кнопки Network
	MinPage	Определяет минимальное значение диапазона стриниц, указанного в компонентах редактирования From и To.
	MaxPage	Определяет максимальное значение диапазона стриниц, указанного в компонентах редактирования From и To. Если MinPage = MaxPage то компоненты From и To вместе с переключателем Pages будут запрещены.

Возвращаемые значения:

pResult

возвращает информацию о настройках печати в виде объекта PrintDialog в случае если пользователь нажал кнопку OK. В случае отмены печати возвращается NULL.

Заметки:: больше информации о флагах можно узнать в описании функции PrintDlg в Microsoft Platform SDK.

PrinterSetupDialog	(	[in, defaultvalue(PD_DEFAULT)] ULONG	Flags,
		[out, retval] IDispatch **	pResult
	)

Метод выводит на экран стандартное диалоговое окно настройки принтера.

Аргументы:

Flags

параметр идентичен параметру Flags метода PrintDialog.

Возвращаемые значения:

pResult

возвращает информацию о настройках печати в виде объекта PrintDialogBase в случае если пользователь нажал кнопку OK. В случае отмены возвращается NULL.

Restore ( void )

Метод развертывает форму обратно из минимизированного состояния.

SaveDialog	(	[in] BSTR	DefaultExt,
		[in] BSTR	Filter,
		[in, defaultvalue("")] BSTR	StartFile,
		[in, defaultvalue(OFN_SAVEDEFAULT)] ULONG	Flags,
		[out, retval] BSTR *	pFileName
	)

Метод выводит на экран стандартное диалоговое окно выбора имени файла для сохранения документа, параметры идентичны параметрам метода OpenDialog.

SelectFolderDialog	(	[in] BSTR	Title,
		[in, defaultvalue(BIF_DEFAULT)] ULONG	Flags,
		[out, retval] BSTR *	pFolder
	)

Метод выводит на экран стандартное диалоговое окно выбора каталога.

Аргументы:

	Title	заголовок диалогового окна
	Flags	может быть комбинацией следующих значений: BIF_RETURNONLYFSDIRS выбор только каталогов файловой системы BIF_DONTGOBELOWDOMAIN не включаются сетевые каталоги ниже уровня домена в диалоговом дереве каталогов BIF_EDITBOX отображение поля редактирования для имени каталога BIF_NEWDIALOGSTYLE новый стиль диалога (Windows 2000 / XP) BIF_USENEWUI просто комбинация BIF_NEWDIALOGSTYLE и BIF_EDITBOX BIF_BROWSEINCLUDEURLS диалог может отображать URL, BIF_USENEWUI и BIF_BROWSEINCLUDEFILES должны быть также установлены BIF_NONEWFOLDERBUTTON запрет включения кнопки New Folder BIF_BROWSEFORCOMPUTER выбор компьютеров BIF_BROWSEFORPRINTER выбор принтера BIF_BROWSEINCLUDEFILES отображение файлов вместе с каталогами

Возвращаемые значения:

pFolder

выбранный каталог, пустая строка в случае отмены пользователем выбора каталога

Заметки:: больше информации о флагах можно узнать в описании функции SHBrowseForFolder в Microsoft Platform SDK.
Если инициализация COM была произведена с флагом COINIT_MULTITHREADED (используется многопоточный апартамент), то этот метод может работать неправильно если используются флаг BIF_USENEWUI или BIF_NEWDIALOGSTYLE (из Microsoft Platform SDK).

ShowModal ( void )

Метод показывает форму на экране, запрещая доступ к остальным окнам программы пока эта форма не будет закрыта.

Полный список свойств

IDispatch* RW AcceptButton

Позволяет задать кнопку по умолчанию, событие OnClick у такой кнопки возникает когда форма активна и пользователь нажимает клавишу ENTER.

См. также:: Button::Default.

VARIANT_BOOL RW Active

Принимает значение "TRUE", если форма активна.

См. также:: WindowSystemObject::ActiveForm.
Form::OnActivate.

См. в MSDN:

GetActiveWindow.
SetActiveWindow.
Начиная с:
1.1.14.

IDispatch* RW ActiveControl

Свойство позволяет установить или обратиться к компоненту формы, имеющему фокус ввода.

IDispatch* RW CancelButton

Позволяет задать кнопку отмены по умолчанию, событие OnClick у такой кнопки возникает когда форма активна и пользователь нажимает клавишу ESCAPE.

См. также:: Button::Cancel.

VARIANT_BOOL RW CanClose

Свойство разрешает или запрещает закрытие формы, по умолчанию "FALSE", это свойство также можно менять во время события OnCloseQuery.

VARIANT_BOOL RW Caption

Свойство определяет наличие у формы заголовка.

VARIANT_BOOL RW ControlBox

Свойство определяет отображение системного меню формы и кнопок в заголовке формы.

VARIANT_BOOL RW Foreground

Принимает значение "TRUE", если форма является окном, с которым работает пользователь.

См. также:: WindowSystemObject::ForegroundForm.
Form::OnActivate.

См. в MSDN:

GetForegroundWindow.
SetForegroundWindow.
Начиная с:
1.1.14.

IDispatch* RW HelpButton

Позволяет задать кнопку справки по умолчанию, событие OnClick у такой кнопки возникает когда форма активна и пользователь нажимает клавишу F1.

VARIANT W Icon

Свойство позволяет загрузить иконку из файла и изменить иконку формы на нее.

Файл может быть исполняемым файлом, DLL или ICO файлом.

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

FileName может быть объектом, загруженным с помощью WindowSystemObject::LoadSysIcon или WindowSystemObject::LoadIcon.

Пример:

o = new ActiveXObject("Scripting.WindowSystemObject")

o.EnableVisualStyles = true

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 500
f.ClientHeight = 300
f.CenterControl()

f.Icon = "Shell32.dll,-16"

left = 10
for (i = 1; i<10; i++)
{
	image = f.DrawImage(left,10,0,0,o.LoadIcon("Shell32.dll,-"+i))
	left += image.Width
	left += 10
}

f.Show()

o.Run()

o = new ActiveXObject("Scripting.WindowSystemObject")

o.EnableVisualStyles = true

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 500
f.ClientHeight = 300
f.CenterControl()

f.Icon = o.LoadSysIcon(o.Translate("OIC_INFORMATION"))

icon = o.LoadSysIcon(o.Translate("OIC_INFORMATION"))

f.DrawImage(10,10,0,0,icon)

f.Show()

o.Run()

Аргументы:

FileName

файл или объект, из которого загружается иконка

VARIANT_BOOL RW KeyPreview

Свойство если оно имеет значение "TRUE" (по умолчанию) события OnKeyUp, OnKeyDown у формы возникают, когда имеет фокус ввода один из компонентов на форме, иначе – только если фокус ввода имеет сама форма.

VARIANT_BOOL RW MaximizeBox

Свойство определяет отображение кнопки максимизации окна.

IDispatch* RW Menu

Свойство содержит в себе объект Action который описывает главное меню формы, можно назначать как существующий объект так и создавать новый (новый объект автоматически создается при попытке чтения свойства).

Заметки:: главное меню формы не является компонентом и частью клиентской области формы, а реализуется автоматически операционной систеиой.

Пример (JScript):

o = new ActiveXObject("Scripting.WindowSystemObject")

o.EnableVisualStyles = true

f = o.CreateForm(0,0,0,0)

f.Text = "WSO"
f.ClientWidth = 200
f.ClientHeight = 100
f.CenterControl()

FileMenu = f.Menu.Add("File")

with (FileMenu.Add("Open","CTRL+O"))
{
        OnExecute = OpenFile
}

FileMenu.Add("-")

with (FileMenu.Add("Exit","ESC"))
{
        OnExecute = CloseForm
}

f.Show()

o.Run()


function CloseForm(Sender)
{
        f.Close()
}

function OpenFile(Sender)
{
        //Some code...
}

Результат:

VARIANT_BOOL RW MinimizeBox

Свойство определяет отображение кнопки минимизации окна.

VARIANT W OnActivate

Свойство позволяет задать обработчик события OnCopyData.

Начиная с:: 1.1.14.

VARIANT W OnActiveControlChange

Свойство позволяет задать обработчик события OnActiveControlChange.

VARIANT W OnClose

Свойство позволяет задать обработчик события OnClose.

VARIANT W OnCloseQuery

Свойство позволяет задать обработчик события OnCloseQuery.

VARIANT W OnCopyData

Свойство позволяет задать обработчик события OnCopyData.

Начиная с:: 1.1.9.

VARIANT W OnEnterSizeMove

Свойство позволяет задать обработчик события OnEnterSizeMove.

Начиная с:: 1.1.16.

VARIANT W OnExitSizeMove

Свойство позволяет задать обработчик события OnExitSizeMove.

Начиная с:: 1.1.16.

VARIANT W OnHint

Свойство позволяет задать обработчик события OnHint.

VARIANT W OnHitTest

Свойство позволяет задать обработчик события OnHitTest.

VARIANT W OnMaximize

Свойство позволяет задать обработчик события OnMaximize.

Начиная с:: 1.1.8.

VARIANT W OnMinimize

Свойство позволяет задать обработчик события OnMinimize.

Начиная с:: 1.1.8.

VARIANT W OnRestore

Свойство позволяет задать обработчик события OnRestore.

Начиная с:: 1.1.8.

ULONG W Region

Свойство, определяющее регион видимости окна.

С помощью задания региона можно получать окна различных форм. Регионы можно создавать с помощью методов объекта Regions.

Пример (JScript):

o = new ActiveXObject("Scripting.WindowSystemObject")
r = o.Regions

f = o.CreateForm(0,0,0,0)
f.SizeGrip = false
f.Caption = false
f.MaximizeBox = false
f.Text = "Region Demo"
f.ClientWidth = 150
f.ClientHeight = 150
f.CenterControl()

Region = r.CreatePolygonRgn(0,50,100,50,100,0,150,75,100,150,100,100,0,100,o.Translate("WINDING"))

f.Region = Region
f.Brush.Color = 0x000000FF
f.DrawRegion(0,0,Region)

f.Show()

o.Run()

Результат:

VARIANT_BOOL RW SizeGrip

Свойство определяет возможность изменения размеров формы пользователем.

IDispatch* R TaskBar

Объект TaskBar.

Начиная с:: 1.1.9.

VARIANT_BOOL RW ToolWindow

Свойство определяет является ли форма инструментальным окном, инструментальное окно имеет меньший заголовок и не имеет системного меню.

Пример (JScript):

o = new ActiveXObject("Scripting.WindowSystemObject")

o.EnableVisualStyles = true

f = o.CreateForm(0,0,0,0)

f.Text = "WSO"
f.ClientWidth = 200
f.ClientHeight = 100
f.CenterControl()
f.ToolWindow = true

f.Show()

o.Run()

Результат:

VARIANT_BOOL RW TopMost

Свойство определяет находится ли форма поверх всех остальных окон, по умолчанию "FALSE".

Документация по WSO 1.1. Последние изменения:Wed Aug 12 18:10:45 2015. (C) Веретенников А. Б. 2004-2015

Интерфейс Form

Открытые члены

Свойства

Подробное описание

Методы

Полный список свойств