ui/base/clipboard/scoped_clipboard_writer.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // This file declares the ScopedClipboardWriter class, a wrapper around
   6 // the Clipboard class which simplifies writing data to the system clipboard.
   7 // Upon deletion the class atomically writes all data to |clipboard_|,
   8 // avoiding any potential race condition with other processes that are also
   9 // writing to the system clipboard.
  10
  11 #ifndef UI_BASE_CLIPBOARD_SCOPED_CLIPBOARD_WRITER_H_
  12 #define UI_BASE_CLIPBOARD_SCOPED_CLIPBOARD_WRITER_H_
  13
  14 #include <string>
  15
  16 #include "base/strings/string16.h"
  17 #include "ui/base/clipboard/clipboard.h"
  18 #include "ui/base/ui_base_export.h"
  19
  20 class Pickle;
  21
  22 namespace ui {
  23
  24 // This class is a wrapper for |Clipboard| that handles packing data
  25 // into a Clipboard::ObjectMap.
  26 class UI_BASE_EXPORT ScopedClipboardWriter {
  27  public:
  28   // Create an instance that is a simple wrapper around clipboard.
  29   ScopedClipboardWriter(Clipboard* clipboard, ClipboardType type);
  30
  31   ~ScopedClipboardWriter();
  32
  33   // Converts |text| to UTF-8 and adds it to the clipboard.
  34   void WriteText(const base::string16& text);
  35
  36   // Converts the text of the URL to UTF-8 and adds it to the clipboard, then
  37   // notifies the Clipboard that we just wrote a URL.
  38   void WriteURL(const base::string16& text);
  39
  40   // Adds HTML to the clipboard.  The url parameter is optional, but especially
  41   // useful if the HTML fragment contains relative links.
  42   void WriteHTML(const base::string16& markup, const std::string& source_url);
  43
  44   // Adds RTF to the clipboard.
  45   void WriteRTF(const std::string& rtf_data);
  46
  47   // Adds a bookmark to the clipboard.
  48   void WriteBookmark(const base::string16& bookmark_title,
  49                      const std::string& url);
  50
  51   // Adds an html hyperlink (<a href>) to the clipboard. |anchor_text| and
  52   // |url| will be escaped as needed.
  53   void WriteHyperlink(const base::string16& anchor_text,
  54                       const std::string& url);
  55
  56   // Used by WebKit to determine whether WebKit wrote the clipboard last
  57   void WriteWebSmartPaste();
  58
  59   // Adds arbitrary pickled data to clipboard.
  60   void WritePickledData(const Pickle& pickle,
  61                         const Clipboard::FormatType& format);
  62
  63   // Removes all objects that would be written to the clipboard.
  64   void Reset();
  65
  66  protected:
  67   // Converts |text| to UTF-8 and adds it to the clipboard.  If it's a URL, we
  68   // also notify the clipboard of that fact.
  69   void WriteTextOrURL(const base::string16& text, bool is_url);
  70
  71   // We accumulate the data passed to the various targets in the |objects_|
  72   // vector, and pass it to Clipboard::WriteObjects() during object destruction.
  73   Clipboard::ObjectMap objects_;
  74   Clipboard* clipboard_;
  75   ClipboardType type_;
  76
  77   // We keep around the UTF-8 text of the URL in order to pass it to
  78   // Clipboard::DidWriteURL().
  79   std::string url_text_;
  80
  81  private:
  82   DISALLOW_COPY_AND_ASSIGN(ScopedClipboardWriter);
  83 };
  84
  85 }  // namespace ui
  86
  87 #endif  // UI_BASE_CLIPBOARD_SCOPED_CLIPBOARD_WRITER_H_
  88