Frame

Иерархия наследования

                    IComponent

                    IControl

                    IFrame

                    Frame

Описание

Компонент Frame предназначен для отображения фрагмента дополнительной формы на текущей форме.

Работа с компонентом

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

При вставке компонента будет выдан запрос на выбор формы, которая в дальнейшем будет отображаться в области фрейма. Для изменения отображаемой формы необходимо определить значение свойства MetabaseObject. Доступ к параметрам формы, отображаемой во фрейме, осуществляется посредством свойства Form.

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

Во время выполнения формы игнорируются такие свойства компонента Frame, как Hint, Focused, Cursor, а также события. Если фокус находится у какого-либо компонента формы, отображаемой во фрейме, то будут срабатывать обработчики событий именно этого компонента/формы. Исключением является событие OnKeyPreview, которое наступает для всей иерархии компонентов, включая компонент Frame.

Пример

В режиме дизайна формы:

После запуска формы:

Свойства компонента Frame

  Имя свойства Краткое описание

Align

Свойство Align определяет выравнивание компонента в рамках содержащего его родительского компонента.

AllowDrag

Свойство AllowDrag определяет возможность взять у компонента перетаскиваемый объект.

AllowDrop

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

Anchors

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

Brush

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

ClientHeight

Свойство ClientHeight определяет высоту клиентской области компонента.

ClientWidth

Свойство ClientWidth определяет ширину клиентской области компонента.

Color

Свойство Color определяет цвет фона компонента.

Cursor

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

Enabled

Свойство Enabled определяет доступность компонента для пользователя.

Focused

Свойство Focused возвращает True, если фокус установлен на данном компоненте.

Font

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

Height

Свойство Height определяет высоту компонента в пикселях.

HelpContext

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

Hint

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

HintTimeout

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

Left

Свойство Left определяет координату левого края компонента в пикселях.

Parent

Свойство Parent определяет родительский компонент.

ParentColor

Свойство ParentColor определяет, будет ли для компонента заимствован цвет родительского компонента.

ParentFont

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

ParentShowHint

Свойство ParentShowHint определяет условие отображения всплывающей подсказки.

PopupMenu

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

Scrolls

Свойство Scrolls возвращает параметры полос прокрутки компонента.

ShowHint

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

TabOrder

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

TabStop

Свойство TabStop определяет признак необходимости компоненту получать фокус при нажатии кнопки «Tab».

Text

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

Top

Свойство Top определяет координату верхнего края компонента в пикселях.

Visible

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

Width

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

Методы компонента Frame

  Имя метода Краткое описание
Метод ClientToScreen преобразовывает координаты точки, указанные относительно системы координат компонента, в экранные координаты.
Метод DoDragDrop позволяет начать операцию перетаскивания.
Метод GetImage возвращает графическое изображение компонента со всеми дочерними компонентами.
Метод ScreenToClient преобразовывает экранные координаты точки в координаты, указываемые относительно системы координат компонента.
Метод SetFocus устанавливает фокус на данный компонент.

События компонента Frame

   Имя события Краткое описание

OnBeginDrag

Событие OnBeginDrag для компонента наступает, когда пользователь начинает перетаскивать объект от компонента.

OnClick

Событие OnClick наступает, если пользователь осуществил щелчок основной кнопкой мыши в области компонента.

OnControlMove

Событие OnControlMove наступает при перемещении компонента.

OnControlResize

Событие OnControlResize наступает при изменении размеров у компонента.

OnDblClick

Событие OnDblClick наступает, если пользователь осуществил двойной щелчок кнопкой мыши в области компонента.

OnDragDrop

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

OnDragEnter

Событие OnDragEnter наступает, когда перетаскиваемый объект входит в область данного компонента.

OnDragLeave

Событие OnDragLeave наступает, когда перетаскиваемый объект выходит за границы данного компонента.

OnDragOver

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

OnEnter

Событие OnEnter наступает в момент получения фокуса компонентом.

OnExit

Событие OnExit наступает в момент потери фокуса компонентом.

OnHScroll

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

OnKeyDown

Событие OnKeyDown наступает, если компонент находится в фокусе и производится нажатие клавиши на клавиатуре.

OnKeyPress

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

OnKeyPreview

Событие OnKeyPreview наступает перед каждым событием, связанным с нажатием клавиш.

OnKeyUp

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

OnMouseDown

Событие OnMouseDown наступает, если указатель находится в области компонента и была нажата любая кнопка мыши.

OnMouseEnter

Событие OnMouseEnter наступает в момент входа курсора мыши в область компонента.

OnMouseHover

Событие OnMouseHover наступает при задержке курсора мыши в области компонента.

OnMouseLeave

Событие OnMouseLeave наступает в момент выхода курсора мыши за пределы области компонента.

OnMouseMove

Событие OnMouseMove наступает при перемещении курсора мыши над компонентом.

OnMouseUp

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

OnMouseWheel

Событие OnMouseWheel наступает, если компонент находится в фокусе при вращении колеса мыши.

OnVScroll

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

См. также:

Стандартные компоненты