Extend WebSurroundingText to accept a WebRange.

public/web/WebFrame.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 456 matching lines @@
     virtual void moveCaretSelection(const WebPoint&) = 0;
 
     virtual bool setEditableSelectionOffsets(int start, int end) = 0;
     virtual bool setCompositionFromExistingText(int compositionStart, int compositionEnd, const WebVector<WebCompositionUnderline>& underlines) = 0;
     virtual void extendSelectionAndDelete(int before, int after) = 0;
 
     virtual void addStyleSheetByURL(const WebString& url) = 0;
 
     virtual void setCaretVisible(bool) = 0;
 
+    // Returns the text surrounding the selection with a maximum length of
+    // |maxLength|. |startOffset| and |endOffset| will be populated with
+    // respectively the start and end offset of the selection relatively to the
+    // returned text. If the selection is a caret, |startOffset| will be equal
+    // to |endOffset|.
+    // Note: the surrounding text length is |maxLength| which means that the
+    // returned text will be at max selectionLength + maxLength.
+    virtual WebString textSurroundingSelection(int maxLength, int* startOffset, int* endOffset) const = 0;

[Yuta Kitamura, 2014/06/06 02:20:08]

1. We usually use non-const references for output arguments,
   instead of non-const pointers.

2. I'm not sure why we need to add this method to WebFrame.
   Is there any reason you cannot extend WebSurroundingText
   interface?

+
     // Printing ------------------------------------------------------------
 
     // Reformats the WebFrame for printing. WebPrintParams specifies the printable
     // content size, paper size, printable area size, printer DPI and print
     // scaling option. If constrainToNode node is specified, then only the given node
     // is printed (for now only plugins are supported), instead of the entire frame.
     // Returns the number of pages that can be printed at the given
     // page size.
     virtual int printBegin(const WebPrintParams&, const WebNode& constrainToNode = WebNode()) = 0;
 
@@ skipping 205 matching lines @@
     WebPrivateOwnPtr<OpenedFrameTracker> m_openedFrameTracker;
 };
 
 #if BLINK_IMPLEMENTATION
 WebCore::Frame* toWebCoreFrame(WebFrame*);
 #endif
 
 } // namespace blink
 
 #endif