From 8c2650fabb5f1edcbc4cfea08c8b8374f17f2776 Mon Sep 17 00:00:00 2001 From: Graeme Geldenhuys Date: Tue, 8 Jun 2010 12:39:06 +0200 Subject: Some new docs for fpg_widget.pas unit. Important point is the explanation for the Anchors property and how fpGUI uses it. --- docs/xml/corelib/fpg_widget.xml | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/xml/corelib/fpg_widget.xml b/docs/xml/corelib/fpg_widget.xml index 733de946..935054cf 100644 --- a/docs/xml/corelib/fpg_widget.xml +++ b/docs/xml/corelib/fpg_widget.xml @@ -1,7 +1,6 @@ - @@ -10,6 +9,32 @@ Sets the position and size of the component. Sets the position and size of the component. It also fires the Resize message. If you are setting up a component like a button on a form, you don't really want the resize event to fire for the button, before the form is displayed (visible). In that case, rather use the components Top, Left, Width and Height properties. + + If assigned, then this widget is being editing in the Form Designer + + + An alias for Owner. + Unlike Delphi or Lazarus, fpGUI treats Owner and Parent as the same thing. Owner or Parent manages the life of children, and the parent/child hierarchy defines the visual aspect as well. + + + Can this component managed child components. + This is mainly used in fpGUI UI Designer, to know if you can drop on widget inside another widget. + + + This determines if the widget is allowed to received keyboard focus. + + + Allows the component to resize or reposition based on its Parent. + +

By default Anchors are set to Top Left.

+

+ NOTE +

+

Anchoring only takes affect after the component is visible on the screen (when the component has a window handle assigned). So if you create a Button in the constructor and set its Anchor property to Bottom/Right, and then set the size of the Form, the Button will not be repositioned. +

+

This is by design. fpGUI allows you to setup a window layout without triggering unnecesary events as you set property values for each widget. Only when csLoading is not in ComponentState, then anchoring events will be triggered. This allows the developer or the fpGUI UI Designer to setup a window layout undisturbed.

+ + -- cgit v1.2.3-54-g00ecf