[Webkit-unassigned] [Bug 14726] New: [gtk] API design. Mapping the WebView delegates to signals.

[bugzilla-daemon at webkit.org]

http://bugs.webkit.org/show_bug.cgi?id=14726

           Summary: [gtk] API design. Mapping the WebView delegates to
                    signals.
           Product: WebKit
           Version: 522+ (nightly)
          Platform: Macintosh
        OS/Version: Mac OS X 10.4
            Status: NEW
          Severity: Normal
          Priority: P2
         Component: New Bugs
        AssignedTo: webkit-unassigned at lists.webkit.org
        ReportedBy: freyther at handhelds.org
OtherBugsDependingO 14725
             nThis:


It is important to design a suitable API for the WebKitGtk port. The primary
use case should be browsing and displaying content. The secondary use case will
be editing.

The API should follow WebView of the Mac/Windows port both in design and naming
of functions. We are free to name the methods slightly different and insert as
many '_' as we want.

WebView is using delegates. For the WebKitGtk port these will be mapped to
signals. For the informal signals the only decision we have to make is if we
want to allow having default handlers in the class of WebKitGtkPage and
WebKitGtkFrame.

For delegates like the WebPolicyDelegate we should not use signals with return
values but make the decisionListener some kind of GType (boxed,GObject...) that
gets passed to the handlers as part of the signal. The first one calling the
decisionListener makes the decision.

For delegates like the WebFrameLoadDelegate (responsible for assigning ids) we
should consider using return values or pass the 'result' as pointer in the
signal. The issue to be discussed is who should be able to stop the emission of
the signal, who should be able to make the decision. The first one returning a
result, the last one setting a result in the struct?


-- 
Configure bugmail: http://bugs.webkit.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.