blob: 6d118906f0bc8b0a6be2c1c435a33a570a6b99ce [file] [log] [blame]
// Copyright 2015 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.
#include <memory>
#include <string>
#include "base/macros.h"
#include "base/time/time.h"
#include "url/gurl.h"
// Helper class returning an URL if the content of the clipboard can be turned
// into an URL, and if it estimates that the content of the clipboard is not too
// old.
class ClipboardRecentContent {
virtual ~ClipboardRecentContent();
// Returns the global instance of the ClipboardRecentContent singleton. This
// method does *not* create the singleton and will return null if no instance
// was registered via SetInstance().
static ClipboardRecentContent* GetInstance();
// Sets the global instance of ClipboardRecentContent singleton.
static void SetInstance(std::unique_ptr<ClipboardRecentContent> new_instance);
// Returns true if the clipboard contains a recent URL that is appropriate to
// be suggested and has not been supressed, and copies it in |url|.
// Otherwise, returns false. |url| must not be null.
virtual bool GetRecentURLFromClipboard(GURL* url) = 0;
// Returns how old the content of the clipboard is.
virtual base::TimeDelta GetClipboardContentAge() const = 0;
// Prevent GetRecentURLFromClipboard from returning anything until the
// clipboard's content changed.
virtual void SuppressClipboardContent() = 0;
// GetRecentURLFromClipboard() should never return a URL from a clipboard
// older than this.
static base::TimeDelta MaximumAgeOfClipboard();