diff options
author | corvid <corvid@lavabit.com> | 2009-11-30 23:54:41 +0000 |
---|---|---|
committer | corvid <corvid@lavabit.com> | 2009-11-30 23:54:41 +0000 |
commit | 509d61b3dc550f7cd724c0e0a7f981096f54568e (patch) | |
tree | ee83c67b9bd81a7ee91b12e89ccce62a358f3fc8 /doc/dw-layout-widgets.doc | |
parent | aa43a207ab512c09442a458b40759540323c35f9 (diff) |
documentation: no more multiple views
Diffstat (limited to 'doc/dw-layout-widgets.doc')
-rw-r--r-- | doc/dw-layout-widgets.doc | 21 |
1 files changed, 9 insertions, 12 deletions
diff --git a/doc/dw-layout-widgets.doc b/doc/dw-layout-widgets.doc index c2cafb2c..47e780aa 100644 --- a/doc/dw-layout-widgets.doc +++ b/doc/dw-layout-widgets.doc @@ -107,14 +107,11 @@ In two cases, a widget has to be drawn: </ol> In both cases, drawing is done by the implementation of -dw::core::Widget::draw. Generally, a widget draws into different views -(see \ref dw-layout-views), the view to draw into is passed as the -first argument. In the first case, only the view, which causes the -expose event, is passed, in the second case, dw::core::Widget::draw is -called multiple times, once for each view connected to the layout. +dw::core::Widget::draw, which draws into the view. + Each view provides some primitive methods for drawing, most should be -obvious. Notice that the views do not know anything about dillo +obvious. Note that the views do not know anything about dillo widgets, and so coordinates have to be passed as canvas coordinates. A widget may only draw in its own allocation. If this cannot be @@ -144,7 +141,7 @@ void Foo::draw (dw::core::View *view, dw::core::Rectangle *area) } \endcode -Clipping views are expensive, so they should be avoided, when possible. +Clipping views are expensive, so they should be avoided when possible. The second argument to dw::core::Widget::draw is the region, which has to be drawn. This may (but needs not) be used for optimization. @@ -169,9 +166,9 @@ dw-widget-sizes.) <h2>Mouse Events</h2> -A widget may process mouse events. The views (\ref dw-layout-views) -pass mouse events to the layout, which then passes them to the -widgtes. There are two kinds of mouse events: +A widget may process mouse events. The view (\ref dw-layout-views) +passes mouse events to the layout, which then passes them to the +widgets. There are two kinds of mouse events: <ul> <li>events returning bool, and @@ -221,9 +218,9 @@ in which the mouse pointer is now ("new widget"). The following paths are calculated: <ol> -<li> the path from the old widget to the nearest common anchestor of the old +<li> the path from the old widget to the nearest common ancestor of the old and the new widget, and -<li> the path from this anchestor to the new widget. +<li> the path from this ancestor to the new widget. </ol> For the widgets along these paths, dw::core::Widget::enterNotifyImpl |