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