toolkit/doc/layout/apinotes.txt

   1 Notes on API wrapper pieces ...
   2
   3 SvxZoomDialog::SvxZoomDialog( Window* pParent, const SfxItemSet& rCoreSet ) :
   4         Dialog( pParent, SVX_RES( RID_SVXDLG_ZOOM ) ),
   5
   6 What 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
  73 XCurrencyField (huh)
  74     needs implementing for VCLXMetricField (non-existent) ...
  75     copy the code from XCurrencyField ? make a sub-class there ?
  76