xref: /aoo41x/main/toolkit/doc/layout/apinotes.txt (revision 0bdb6530)
1# *************************************************************
2#
3#  Licensed to the Apache Software Foundation (ASF) under one
4#  or more contributor license agreements.  See the NOTICE file
5#  distributed with this work for additional information
6#  regarding copyright ownership.  The ASF licenses this file
7#  to you under the Apache License, Version 2.0 (the
8#  "License"); you may not use this file except in compliance
9#  with the License.  You may obtain a copy of the License at
10#
11#    http://www.apache.org/licenses/LICENSE-2.0
12#
13#  Unless required by applicable law or agreed to in writing,
14#  software distributed under the License is distributed on an
15#  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16#  KIND, either express or implied.  See the License for the
17#  specific language governing permissions and limitations
18#  under the License.
19#
20# *************************************************************
21Notes on API wrapper pieces ...
22
23SvxZoomDialog::SvxZoomDialog( Window* pParent, const SfxItemSet& rCoreSet ) :
24	Dialog( pParent, SVX_RES( RID_SVXDLG_ZOOM ) ),
25
26What do we do ?
27	+ lots of potential VCL/Svx/Sfx etc. top-levels ...
28
29	+ Create the window & the 1st member: 'FooHandle' ?
30	    + Multiply inherited ?
31	+ object from where ?
32
33	+ Default:
34	    + a pseudo-Dialog / wrapper ...
35	    + load using layout (etc.)
36		+ register an SID table ?
37		    + necessary ?
38		+ SIDs ? - post it ...
39
40
41	+ [ Otherwise ... hook up via a helper /
42	    constructor member ... ]
43
44* Fixed:
45    + OKButton / CancelButton
46	+ don't chain to PushButton::Click
47	    + if there is no ClickHdl set ... [ !urgh! ...]
48
49    * FIXME:
50	other widgets ...
51	* How do we cope ? *
52	....
53	    + priorities ? Layout ?
54	    + de-coupling ?
55	    + native widgets ?
56	    + hmm...
57	+ custom widgets ?
58	    + 'OKButton' ... (?) :-)
59	    + 'CancelButton'
60	    + 'HelpButton' ...
61	+ a VCL hack ...
62	    + create an 'addLayout()' method ?
63	    + [ like cl's ? ]
64	+ implement this ...
65
66** Lifecycle ?
67    + how do we track the 'Impl'
68      vs. the pImpl vs. (etc.)
69	+ held by mutual references ?
70
71    + pointer to the widget itself passed in ?
72	+ MI ?
73    + when the widget dies - just NULL the
74      listener's back-ptr ?
75
76    + Locking [!?] - how / why / what / who ?
77	+ urgh ...
78	+ threading bits ...
79
80    + SID table (?) ...
81	+ [ necessary ? - just use the SID name as the XML attr ? ]
82	+ LAYOUT_ID(a) -> "#a" - stringified ...
83
84** FIXME:
85    + we need a decent MetricField implementation
86	+ it is more than a SpinField
87	+ need to move the 'Border' property down (etc.)
88	+ re-arrange the properties to be next to the impls.
89	  in awt ...
90
91    + fix the
92
93XCurrencyField (huh)
94    needs implementing for VCLXMetricField (non-existent) ...
95    copy the code from XCurrencyField ? make a sub-class there ?
96
97