summaryrefslogtreecommitdiff
path: root/docs/xml/corelib/fpg_widget.xml
blob: 0e0950f6595ac507b80bb7f958416b682d40dd7e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
<?xml version="1.0"?>
<fpdoc-descriptions>
<package name="fpGUI">
<module name="fpg_widget">
<short>The base class for all other GUI widgets</short>
<descr/>

<element name="TfpgWidget.SetPosition">
<short>Sets the position and size of the component</short>
<descr><printshort id="TfpgWidget.SetPosition"/>. 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.</descr>
<seealso>
<link id="fpg_base.TfpgWindowBase.UpdateWindowPosition">TfpgWindowBase.UpdateWindowPosition</link>
</seealso>
</element>

<element name="TfpgWidget.FormDesigner">
<short>If assigned, then this widget is being editing in the Form Designer</short>
</element>

<element name="TfpgWidget.Parent">
<short>An alias for Owner</short>
<descr>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.</descr>
</element>

<element name="TfpgWidget.IsContainer">
<short>Can this component managed child components</short>
<descr>This is mainly used in fpGUI UI Designer, to know if you can drop a widget inside another widget.</descr>
</element>

<element name="TfpgWidget.Focusable">
<short>This determines if the widget is allowed to received keyboard focus</short>
<descr><printshort id="TfpgWidget.Focusable"/>. No focus rectangle will be drawn, even
if the user clicks this component.</descr>
</element>

<element name="TfpgWidget.Anchors">
<short>Allows the component to resize or reposition based on its Parent.</short>
<descr><p>By default Anchors are set to Top Left.</p>
<remark>Anchoring only takes affect <i>after</i> 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 <i>not</i> be repositioned.</remark>
<p>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.</p>
</descr>
</element>

<element name="TfpgWidget.HandleLMouseUp">
<short>Occurs after the component processed the mouse button press event</short>
<descr><printshort id="TfpgWidget.HandleLMouseUp"/>. By default this method also
triggers the OnClick event, but this behaviour can be overridden by descendant
components.</descr>
</element>


</module>
</package>
</fpdoc-descriptions>