Интерфейс Docking

Предоставляет доступ к методам и настройкам многопанельного интерфейса для определенного компонента. Подробнее...

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

Открытые члены
	DockAsChild ([in] IDispatch *Control,[in] USHORT ControlAlign)
	Используется для перемещения компонента в текущий компонент при организации многопанельного интерфейса .
	DockAsNeighbour ([in] IDispatch *Control,[in, defaultvalue(AL_CLIENT)] USHORT ControlAlign)
	Используется для расположения компонента рядом с текущим компонентом при организации многопанельного интерфейса .
	UnDock ([in, defaultvalue(TRUE)] VARIANT_BOOL ControlVisible)
	Будет автоматически создана родительская форма, в которую будет помещен текущей компонент.
Свойства
BSTR RW	UniqueId []
	Задает уникальный идентификатор компонента.
VARIANT_BOOL RW	AllowDockAsChild []
	Если значение свойства = "FALSE" то пользователь не может перемещать компоненты в дочерние компоненты данного компонента.
VARIANT_BOOL RW	AllowDockAsNeighbour []
	Если значение свойства = "FALSE" то пользователь не может при перемещении компонентов, помещать их рядом с данным компонентом.
VARIANT_BOOL RW	DropTarget []
	Если "TRUE", то пользователь может поместить с помощью мышки (drag & drop) в текущий компонент другой компонент.
VARIANT_BOOL RW	AlwaysDockTab []
	Если "TRUE", то текущий компонент должен всегда содержаться в TabControl.
VARIANT_BOOL RW	AlwaysDockPage []
	Если "TRUE", то текущий компонент должен всегда содержаться в PageControl.
VARIANT_BOOL RW	DockToolWindow []
	Если "TRUE", то создаваемая методом UnDock форма будет иметь ToolWindow = "TRUE".
VARIANT_BOOL RW	AutoCreated []
	Если "TRUE", то компонент является созданным автоматически.
LONG RW	PageControlTag []
	Дополнительный параметр к AlwaysDockTab и AlwaysDockPage, который предназначен для того, чтобы различать разные виды компонентов одинакового типа.

---

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

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

Для получения данного объекта нужно использовать свойство компонента Docking.

Компонент должен быть Frame (CreateFrame).

---

Методы

DockAsChild	(	[in] IDispatch *	Control,
		[in] USHORT	ControlAlign
	)

Используется для перемещения компонента в текущий компонент при организации многопанельного интерфейса .

Аргументы:

	Control	Перемещаемый компонент.
	ControlAlign	требуемое положение компонента в родительском окне.

Параметр может принимать следующие значения:

• AL_LEFT Компонент находится слева в области родительского окна, его высота принимает максимальное возможное значение
• AL_RIGHT Компонент находится справа в области родительского окна, его высота принимает максимальное значение
• AL_TOP Компонент находится сверху в родительском окне, его длина принимает максимальное значение
• AL_BOTTOM Компонент находится снизу в родительском окне, его длина принимает максимальное значение
• AL_CLIENT Компонент занимает максимально возможную область в родительском окне, эта область ограничена компонентами со значением свойства Align: AL_LEFT, AL_TOP, AL_RIGHT, AL_BOTTOM

Если свойство перемещаемого компонента AlwaysDockTab = "TRUE" то внутри текущего компонента будет автоматически создан TabControl в качестве промежуточного контейнера для перемещаемого компонента.

Если свойство перемещаемого компонента AlwaysDockPage = "TRUE" то внутри текущего компонента будет автоматически создан PageControl в качестве промежуточного контейнера для перемещаемого компонента.

Начиная с:

1.1.15.

DockAsNeighbour	(	[in] IDispatch *	Control,
		[in, defaultvalue(AL_CLIENT)] USHORT	ControlAlign
	)

Используется для расположения компонента рядом с текущим компонентом при организации многопанельного интерфейса .

Аргументы:

	Control	Перемещаемый компонент.
	ControlAlign	требуемое положение компонента в родительском окне.

• Если ControlAlign = AL_CLIENT, то перемещаемый компонент и текущий компонент будут помещены в общий многостраничный компонент, TabControl или PageControl.

Если текущий компонент уже лежит внутри многостраничного контейнера, то будет создана новая закладка для перемещаемого компонента.

В противном случае будет создан новый многостраничный компонент, TabControl или PageControl. Перемещаемый компонент будет помещен на новую закладку. Текущий компонент будет перемещен на другую закладку.

• Если ControlAlign != AL_CLIENT (ControlAlign = AL_LEFT, AL_RIGHT, AL_TOP или AL_BOTTOM) для перемещаемого компонента и текущего компонента будет создан общий родительский Frame. Перемещаемый компонент и текущий компонент будут помещены в созданный Frame.

В этом случае свойство Align перемещаемого компонента будет равно ControlAlign. Свойство Align текущего компонента будет равно AL_CLIENT. Созданный Frame будет иметь значение свойства AutoSplit равное "TRUE", значение свойства AllowDockAsChild = "TRUE".

Заметки:

Нельзя переместить компонент рядом с другим компонентом, если целевой компонент является формой - Form.

Начиная с:

1.1.15.

UnDock

(

[in, defaultvalue(TRUE)] VARIANT_BOOL

ControlVisible

)

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

Начиная с:

1.1.15.

---

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

VARIANT_BOOL RW AllowDockAsChild

Если значение свойства = "FALSE" то пользователь не может перемещать компоненты в дочерние компоненты данного компонента.

Значение по умолчанию: "FALSE"..

Начиная с:

1.1.15.

VARIANT_BOOL RW AllowDockAsNeighbour

Если значение свойства = "FALSE" то пользователь не может при перемещении компонентов, помещать их рядом с данным компонентом.

Значение по умолчанию: "TRUE" для Frame.

Если компонент является формой, то свойство имеет значение "FALSE" и его нельзя изменить.

Начиная с:

1.1.15.

VARIANT_BOOL RW AlwaysDockPage

Если "TRUE", то текущий компонент должен всегда содержаться в PageControl.

Родительский PageControl создается автоматически.

Начиная с:

1.1.15.

VARIANT_BOOL RW AlwaysDockTab

Если "TRUE", то текущий компонент должен всегда содержаться в TabControl.

Родительский TabControl создается автоматически.

Начиная с:

1.1.15.

VARIANT_BOOL RW AutoCreated

Если "TRUE", то компонент является созданным автоматически.

Например, это TabControl, который был создан при перемещении какого-либо компонента поверх другого компонента (см. Многопанельный интерфейс).

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

Начиная с:

1.1.15.

VARIANT_BOOL RW DockToolWindow

Если "TRUE", то создаваемая методом UnDock форма будет иметь ToolWindow = "TRUE".

Начиная с:

1.1.15.

VARIANT_BOOL RW DropTarget

Если "TRUE", то пользователь может поместить с помощью мышки (drag & drop) в текущий компонент другой компонент.

Начиная с:

1.1.15.

LONG RW PageControlTag

Дополнительный параметр к AlwaysDockTab и AlwaysDockPage, который предназначен для того, чтобы различать разные виды компонентов одинакового типа.

По умолчанию 0.

Начиная с:

1.1.15.

BSTR RW UniqueId

Задает уникальный идентификатор компонента.

Конкретное значение может использоваться только для одного компонента.

Используется при вызове SaveLayout или LoadLayout.

Начиная с:

1.1.15.

---