| OLD | NEW |
| 1 // Copyright (c) 2006-2008 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2006-2008 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef WEBKIT_GLUE_WEBFRAME_H_ | 5 #ifndef WEBKIT_GLUE_WEBFRAME_H_ |
| 6 #define WEBKIT_GLUE_WEBFRAME_H_ | 6 #define WEBKIT_GLUE_WEBFRAME_H_ |
| 7 | 7 |
| 8 #include "base/scoped_ptr.h" | 8 #include "base/scoped_ptr.h" |
| 9 #include "googleurl/src/gurl.h" | 9 #include "googleurl/src/gurl.h" |
| 10 #include "skia/ext/bitmap_platform_device.h" | 10 #include "skia/ext/bitmap_platform_device.h" |
| (...skipping 146 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 157 virtual void StopLoading() = 0; | 157 virtual void StopLoading() = 0; |
| 158 | 158 |
| 159 // Returns the frame that opened this frame, or NULL if this window has no | 159 // Returns the frame that opened this frame, or NULL if this window has no |
| 160 // opener. | 160 // opener. |
| 161 virtual WebFrame* GetOpener() const = 0; | 161 virtual WebFrame* GetOpener() const = 0; |
| 162 | 162 |
| 163 // Returns the frame containing this frame, or NULL of this is a top level | 163 // Returns the frame containing this frame, or NULL of this is a top level |
| 164 // frame with no parent. | 164 // frame with no parent. |
| 165 virtual WebFrame* GetParent() const = 0; | 165 virtual WebFrame* GetParent() const = 0; |
| 166 | 166 |
| 167 // Returns the top-most frame in the frame hierarchy containing this frame. |
| 168 virtual WebFrame* GetTop() const = 0; |
| 169 |
| 167 // Returns the child frame with the given xpath. | 170 // Returns the child frame with the given xpath. |
| 168 // The document of this frame is used as the context node. | 171 // The document of this frame is used as the context node. |
| 169 // The xpath may need a recursive traversal if non-trivial | 172 // The xpath may need a recursive traversal if non-trivial |
| 170 // A non-trivial xpath will contain a combination of xpaths | 173 // A non-trivial xpath will contain a combination of xpaths |
| 171 // (delimited by '\n') leading to an inner subframe. | 174 // (delimited by '\n') leading to an inner subframe. |
| 172 // | 175 // |
| 173 // Example: /html/body/iframe/\n/html/body/div/iframe/\n/frameset/frame[0] | 176 // Example: /html/body/iframe/\n/html/body/div/iframe/\n/frameset/frame[0] |
| 174 // can be broken into 3 xpaths | 177 // can be broken into 3 xpaths |
| 175 // /html/body/iframe evaluates to an iframe within the root frame | 178 // /html/body/iframe evaluates to an iframe within the root frame |
| 176 // /html/body/div/iframe evaluates to an iframe within the level-1 iframe | 179 // /html/body/div/iframe evaluates to an iframe within the level-1 iframe |
| 177 // /frameset/frame[0] evaluates to first frame within the level-2 iframe | 180 // /frameset/frame[0] evaluates to first frame within the level-2 iframe |
| 178 virtual WebFrame* GetChildFrame(const std::wstring& xpath) const = 0; | 181 virtual WebFrame* GetChildFrame(const std::wstring& xpath) const = 0; |
| 179 | 182 |
| 180 // Returns a pointer to the WebView that contains this WebFrame. This | 183 // Returns a pointer to the WebView that contains this WebFrame. This |
| 181 // pointer is not AddRef'd and is only valid for the lifetime of the WebFrame | 184 // pointer is not AddRef'd and is only valid for the lifetime of the WebFrame |
| 182 // unless it is AddRef'd separately by the caller. | 185 // unless it is AddRef'd separately by the caller. |
| 183 virtual WebView* GetView() const = 0; | 186 virtual WebView* GetView() const = 0; |
| 184 | 187 |
| 188 // Returns the serialization of the frame's security origin. |
| 189 virtual std::string GetSecurityOrigin() const = 0; |
| 190 |
| 185 // Fills the contents of this frame into the given string. If the text is | 191 // Fills the contents of this frame into the given string. If the text is |
| 186 // longer than max_chars, it will be clipped to that length. Warning: this | 192 // longer than max_chars, it will be clipped to that length. Warning: this |
| 187 // function may be slow depending on the number of characters retrieved and | 193 // function may be slow depending on the number of characters retrieved and |
| 188 // page complexity. For a typically sized page, expect it to take on the | 194 // page complexity. For a typically sized page, expect it to take on the |
| 189 // order of milliseconds. | 195 // order of milliseconds. |
| 190 // | 196 // |
| 191 // If there is room, subframe text will be recursively appended. Each frame | 197 // If there is room, subframe text will be recursively appended. Each frame |
| 192 // will be separated by an empty line. | 198 // will be separated by an empty line. |
| 193 virtual void GetContentAsPlainText(int max_chars, | 199 virtual void GetContentAsPlainText(int max_chars, |
| 194 std::wstring* text) const = 0; | 200 std::wstring* text) const = 0; |
| (...skipping 179 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 374 virtual int PendingFrameUnloadEventCount() const = 0; | 380 virtual int PendingFrameUnloadEventCount() const = 0; |
| 375 | 381 |
| 376 protected: | 382 protected: |
| 377 virtual ~WebFrame() {} | 383 virtual ~WebFrame() {} |
| 378 | 384 |
| 379 private: | 385 private: |
| 380 DISALLOW_COPY_AND_ASSIGN(WebFrame); | 386 DISALLOW_COPY_AND_ASSIGN(WebFrame); |
| 381 }; | 387 }; |
| 382 | 388 |
| 383 #endif // WEBKIT_GLUE_WEBFRAME_H_ | 389 #endif // WEBKIT_GLUE_WEBFRAME_H_ |
| OLD | NEW |