Reverting 27711.

webkit/api/public/WebView.h

 /*
  * Copyright (C) 2009 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 19 matching lines @@
 
 #ifndef WebView_h
 #define WebView_h
 
 #include "WebDragOperation.h"
 #include "WebWidget.h"
 
 namespace WebKit {
     class WebDragData;
     class WebFrame;
+    class WebFrameClient;
     class WebSettings;
     class WebString;
     class WebViewClient;
     struct WebPoint;
 
     class WebView : public WebWidget {
     public:
-        WEBKIT_API WebView* create(WebViewClient*);
+        // Initialization ------------------------------------------------------
+
+        // FIXME enable this once WebViewDelegate has been eliminated.
+        //WEBKIT_API WebView* create(WebViewClient*);
+
+        // After creating a WebView, you should immediately call this method.
+        // You can optionally modify the settings before calling this method.
+        // The WebFrameClient will receive events for the main frame and any
+        // child frames.
+        virtual void initializeMainFrame(WebFrameClient*) = 0;
 
 
         // Options -------------------------------------------------------------
 
         // The returned pointer is valid for the lifetime of the WebView.
         virtual WebSettings* settings() = 0;
 
         // Corresponds to the encoding of the main frame.  Setting the page
         // encoding may cause the main frame to reload.
         virtual WebString pageEncoding() const = 0;
         virtual void setPageEncoding(const WebString&) = 0;
 
+        // Makes the WebView transparent.  This is useful if you want to have
+        // some custom background rendered behind it.
+        virtual bool isTransparent() const = 0;
+        virtual void setIsTransparent(bool) = 0;
+
+        // Controls whether pressing Tab key advances focus to links.
+        virtual bool tabsToLinks() const = 0;
+        virtual void setTabsToLinks(bool) = 0;
+
+        // Method that controls whether pressing Tab key cycles through page
+        // elements or inserts a '\t' char in the focused text area.
+        virtual bool tabKeyCyclesThroughElements() const = 0;
+        virtual void setTabKeyCyclesThroughElements(bool) = 0;
+
+        // Controls the WebView's active state, which may affect the rendering
+        // of elements on the page (i.e., tinting of input elements).
+        virtual bool isActive() const = 0;
+        virtual void setIsActive(bool) = 0;
+
 
         // Closing -------------------------------------------------------------
 
         // Runs beforeunload handlers for the current page, returning false if
         // any handler suppressed unloading.
         virtual bool dispatchBeforeUnloadEvent() = 0;
 
         // Runs unload handlers for the current page.
         virtual void dispatchUnloadEvent() = 0;
 
@@ skipping 69 matching lines @@
             WebDragOperationsMask operationsAllowed) = 0;
         virtual WebDragOperation dragTargetDragOver(
             const WebPoint& clientPoint, const WebPoint& screenPoint,
             WebDragOperationsMask operationsAllowed) = 0;
         virtual void dragTargetDragLeave() = 0;
         virtual void dragTargetDrop(
             const WebPoint& clientPoint, const WebPoint& screenPoint) = 0;
 
         virtual int dragIdentity() = 0;
 
+        // Helper method for drag and drop target operations: override the
+        // default drop effect with either a "copy" (accept true) or "none"
+        // (accept false) effect.  Return true on success.
+        virtual bool setDropEffect(bool accept) = 0;
+
 
         // Developer tools -----------------------------------------------------
 
         // Inspect a particular point in the WebView.  (x = -1 || y = -1) is a
         // special case, meaning inspect the current page and not a specific
         // point.
         virtual void inspectElementAt(const WebPoint&) = 0;
 
 
         // FIXME what about:
         // StoreFocusForFrame
         // DownloadImage
         // Get/SetDelegate
         // InsertText -> should move to WebTextInput
         // AutofillSuggestionsForNode
         // HideAutofillPopup
 
     protected:
         ~WebView() {}
     };
 
 } // namespace WebKit
 
 #endif