Помещает объект ToolBar или объект Form вдоль бордюра главного окна Visual FoxPro или помещает объект Form внутри окон Visual FoxPro IDE или рядом с другими формами. Для использование метода Dock для форм, свойство формы Dockable должно быть установлено в 1. Имеется две версии синтаксиса.
Toolbar.Dock(nLocation [, X, Y]) Form.Dock(nLocation, [, oForm]) |
Параметры
- nLocation
-
Определяет место стыковки панели инструментов или формы.
В приведенной ниже таблице перечислены значения для nLocation.
nLocation Описание константа FoxPro.h –1
Расстыковывает панель инструментов или форму.
TOOL_NOTDOCKED
0
Помещает панель инструментов или форму вверху главного окна Visual FoxPro.
TOOL_TOP
1
Помещает панель инструментов или форму с левой стороны главного окна Visual FoxPro.
TOOL_LEFT
2
Помещает панель инструментов или форму с правой стороны главного окна Visual FoxPro.
TOOL_RIGHT
3
Помещает панель инструментов или форму внизу главного окна Visual FoxPro.
TOOL_BOTTOM
4
Стыкует форму с другим окном так что они перекрывают друг друга и переключатсья между ними можно с помощью закладок. (только для форм)
TOOL_TAB
- X, Y
-
Определяет горизонтальную и вертикальные координаты соответственно стыковочной позиции панели инструметов.
- oForm
-
Определяет объектную ссылку на другую форму для закладочной или линковочной стыковок.
Возвращаемое значение
Логический тип данных. Dock возвращает True (.T.) если предмет удалось состыковать. В противном случае, Dock возвращает False (.F.).
Примечания
Применяется к: Form Object | ToolBar Object
Visual FoxPro не поддерживает стыковку для форм top-level. Поэтому, Visual FoxPro сбрасывает свойство ShowWindow состыкованной формы, которое определяет - будет ли форма top-level формой и всегда по умолчанию устанавливает значение свойства в 0.
При вызове метода Dock происходят события Activate и Resize.
Вы не можете рекурсивно стыковать предметы. Например, вы не можете стыковать одну форму, пока стыкуется другая.
Для получения более подробной информации о стыковке панелей инструментов и форм, смотрите Как: стыковать панели инструментов и Как: стыковать формы.
Пример
Приведенный ниже пример использует функцию CREATEOBJECT( ) для создания формы, устанавливает свойства Dockable и Visible для чтобы форма была видимой и стыкуемой и использует метод Dock для стыковки формы к левой стороне главного окна Visual FoxPro.
![]() | |
---|---|
omyForm = CREATEOBJECT("Form") omyForm.Dockable = 1 omyForm.Visible = .T. omyForm.Dock(1) |