1 /* 2 * Copyright (C) 2009 Google Inc. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are 6 * met: 7 * 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above 11 * copyright notice, this list of conditions and the following disclaimer 12 * in the documentation and/or other materials provided with the 13 * distribution. 14 * * Neither the name of Google Inc. nor the names of its 15 * contributors may be used to endorse or promote products derived from 16 * this software without specific prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 */ 30 31 #ifndef WebWidgetClient_h 32 #define WebWidgetClient_h 33 34 #include "WebCommon.h" 35 #include "WebNavigationPolicy.h" 36 #include "WebRect.h" 37 #include "WebScreenInfo.h" 38 39 namespace WebKit { 40 41 class WebWidget; 42 struct WebCursorInfo; 43 44 class WebWidgetClient { 45 public: 46 // Called when a region of the WebWidget needs to be re-painted. didInvalidateRect(const WebRect &)47 virtual void didInvalidateRect(const WebRect&) { } 48 49 // Called when a region of the WebWidget, given by clipRect, should be 50 // scrolled by the specified dx and dy amounts. didScrollRect(int dx,int dy,const WebRect & clipRect)51 virtual void didScrollRect(int dx, int dy, const WebRect& clipRect) { } 52 53 // Called when the widget acquires or loses focus, respectively. didFocus()54 virtual void didFocus() { } didBlur()55 virtual void didBlur() { } 56 57 // Called when the cursor for the widget changes. didChangeCursor(const WebCursorInfo &)58 virtual void didChangeCursor(const WebCursorInfo&) { } 59 60 // Called when the widget should be closed. WebWidget::close() should 61 // be called asynchronously as a result of this notification. closeWidgetSoon()62 virtual void closeWidgetSoon() { } 63 64 // Called to show the widget according to the given policy. show(WebNavigationPolicy)65 virtual void show(WebNavigationPolicy) { } 66 67 // Called to block execution of the current thread until the widget is 68 // closed. runModal()69 virtual void runModal() { } 70 71 // Called to get/set the position of the widget in screen coordinates. windowRect()72 virtual WebRect windowRect() { return WebRect(); } setWindowRect(const WebRect &)73 virtual void setWindowRect(const WebRect&) { } 74 75 // Called to get the position of the resizer rect in window coordinates. windowResizerRect()76 virtual WebRect windowResizerRect() { return WebRect(); } 77 78 // Called to get the position of the root window containing the widget 79 // in screen coordinates. rootWindowRect()80 virtual WebRect rootWindowRect() { return WebRect(); } 81 82 // Called to query information about the screen where this widget is 83 // displayed. screenInfo()84 virtual WebScreenInfo screenInfo() { return WebScreenInfo(); } 85 86 protected: ~WebWidgetClient()87 ~WebWidgetClient() { } 88 }; 89 90 } // namespace WebKit 91 92 #endif 93