summaryrefslogtreecommitdiffstats
path: root/webkit/glue/webwidget.h
blob: 0788f2e42e724a0d471660577a9907a56412b5c4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
// Copyright (c) 2006-2008 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef WEBKIT_GLUE_WEBWIDGET_H__
#define WEBKIT_GLUE_WEBWIDGET_H__

#include "skia/ext/platform_canvas.h"

namespace gfx {
class Rect;
class Size;
}

class WebInputEvent;
class WebWidgetDelegate;

class WebWidget {
 public:
  WebWidget() {}

  // This method creates a WebWidget that is initially invisible and positioned
  // according to the given bounds relative to the specified parent window.
  // The caller is responsible for showing the WebWidget's view window (see
  // GetViewWindow) once it is ready to have the WebWidget appear on the screen.
  static WebWidget* Create(WebWidgetDelegate* delegate);

  // This method closes and deletes the WebWidget.
  virtual void Close() = 0;

  // Called to resize the WebWidget.
  virtual void Resize(const gfx::Size& new_size) = 0;

  // Returns the current size of the WebWidget.
  virtual gfx::Size GetSize() = 0;

  // Called to layout the WebWidget.  This MUST be called before Paint, and it
  // may result in calls to WebWidgetDelegate::DidInvalidateRect.
  virtual void Layout() = 0;

  // Called to paint the specified region of the WebWidget onto the given canvas.
  // You MUST call Layout before calling this method.  It is okay to call Paint
  // multiple times once Layout has been called, assuming no other changes are
  // made to the WebWidget (e.g., once events are processed, it should be assumed
  // that another call to Layout is warranted before painting again).
  virtual void Paint(skia::PlatformCanvas* canvas, const gfx::Rect& rect) = 0;

  // Called to inform the WebWidget of an input event.
  // Returns true if the event has been processed, false otherwise.
  virtual bool HandleInputEvent(const WebInputEvent* input_event) = 0;

  // Called to inform the WebWidget that mouse capture was lost.
  virtual void MouseCaptureLost() = 0;

  // Called to inform the WebWidget that it has gained or lost keyboard focus.
  virtual void SetFocus(bool enable) = 0;

  // Called to inform the webwidget of a composition event from IMM
  // (Input Method Manager).
  virtual bool ImeSetComposition(int string_type, int cursor_position,
                                 int target_start, int target_end,
                                 const std::wstring& ime_string) = 0;

  // Retrieve the status of this widget required by IME APIs.
  virtual bool ImeUpdateStatus(bool* enable_ime, gfx::Rect* caret_rect) = 0;

 protected:
  virtual ~WebWidget() {}

 private:
  DISALLOW_EVIL_CONSTRUCTORS(WebWidget);
};

#endif  // #ifndef WEBKIT_GLUE_WEBWIDGET_H__