xref: /aoo41x/main/toolkit/doc/layout/apinotes.txt (revision cdf0e10c)
1Notes on API wrapper pieces ...
2
3SvxZoomDialog::SvxZoomDialog( Window* pParent, const SfxItemSet& rCoreSet ) :
4	Dialog( pParent, SVX_RES( RID_SVXDLG_ZOOM ) ),
5
6What do we do ?
7	+ lots of potential VCL/Svx/Sfx etc. top-levels ...
8
9	+ Create the window & the 1st member: 'FooHandle' ?
10	    + Multiply inherited ?
11	+ object from where ?
12
13	+ Default:
14	    + a pseudo-Dialog / wrapper ...
15	    + load using layout (etc.)
16		+ register an SID table ?
17		    + necessary ?
18		+ SIDs ? - post it ...
19
20
21	+ [ Otherwise ... hook up via a helper /
22	    constructor member ... ]
23
24* Fixed:
25    + OKButton / CancelButton
26	+ don't chain to PushButton::Click
27	    + if there is no ClickHdl set ... [ !urgh! ...]
28
29    * FIXME:
30	other widgets ...
31	* How do we cope ? *
32	....
33	    + priorities ? Layout ?
34	    + de-coupling ?
35	    + native widgets ?
36	    + hmm...
37	+ custom widgets ?
38	    + 'OKButton' ... (?) :-)
39	    + 'CancelButton'
40	    + 'HelpButton' ...
41	+ a VCL hack ...
42	    + create an 'addLayout()' method ?
43	    + [ like cl's ? ]
44	+ implement this ...
45
46** Lifecycle ?
47    + how do we track the 'Impl'
48      vs. the pImpl vs. (etc.)
49	+ held by mutual references ?
50
51    + pointer to the widget itself passed in ?
52	+ MI ?
53    + when the widget dies - just NULL the
54      listener's back-ptr ?
55
56    + Locking [!?] - how / why / what / who ?
57	+ urgh ...
58	+ threading bits ...
59
60    + SID table (?) ...
61	+ [ necessary ? - just use the SID name as the XML attr ? ]
62	+ LAYOUT_ID(a) -> "#a" - stringified ...
63
64** FIXME:
65    + we need a decent MetricField implementation
66	+ it is more than a SpinField
67	+ need to move the 'Border' property down (etc.)
68	+ re-arrange the properties to be next to the impls.
69	  in awt ...
70
71    + fix the
72
73XCurrencyField (huh)
74    needs implementing for VCLXMetricField (non-existent) ...
75    copy the code from XCurrencyField ? make a sub-class there ?
76
77