diff options
author | Johannes Hofmann <Johannes.Hofmann@gmx.de> | 2010-08-20 23:24:19 +0200 |
---|---|---|
committer | Johannes Hofmann <Johannes.Hofmann@gmx.de> | 2010-08-20 23:24:19 +0200 |
commit | f5c598b518d1f906148534d015f50075d3e8242d (patch) | |
tree | 21dd70add5b366c3dd80641b77f6b18e0baa009e /doc/dw-layout-widgets.doc | |
parent | e98d02a01ffeb18ede86af025e51ae1ec011c75a (diff) | |
parent | 5f0fc0e48b8cbee7e1795935da0abff6627fd498 (diff) |
merge
Diffstat (limited to 'doc/dw-layout-widgets.doc')
-rw-r--r-- | doc/dw-layout-widgets.doc | 27 |
1 files changed, 12 insertions, 15 deletions
diff --git a/doc/dw-layout-widgets.doc b/doc/dw-layout-widgets.doc index f5b0ed06..d488efd8 100644 --- a/doc/dw-layout-widgets.doc +++ b/doc/dw-layout-widgets.doc @@ -81,7 +81,7 @@ different situations: <ol> <li> Adding an anchor is inititiated by a specific widget method, e.g. dw::Textblock::addAnchor. Here, dw::core::Widget::addAnchor must be - called, + called, <li> Whenever the position of an anchor is changed, dw::core::Widget::changeAnchor is called (typically, this is done @@ -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 @@ -232,7 +229,7 @@ and dw::core::Widget::leaveNotifyImpl are called. <h3>Signals</h3> If a caller outside of the widget is interested in these events, he -can connect a dw::core::Widget::EventReceiver. For those events with a +can connect a dw::core::Layout::LinkReceiver. For those events with a boolean return value, the results of the signal emission is regarded, i.e. the delegation of an event to the parent of the widget can be stopped by a signal receiver returning true, even if the widget method @@ -267,4 +264,4 @@ background colors to parts of a widget (as dw::Table does for rows), it must call dw::core::Widget::setBgColor for the children inside this part. -*/
\ No newline at end of file +*/ |