components/exo/data_offer.h

// Copyright 2017 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 COMPONENTS_EXO_DATA_OFFER_H_
#define COMPONENTS_EXO_DATA_OFFER_H_

#include <cstdint>
#include <string>

#include "base/containers/flat_map.h"
#include "base/containers/flat_set.h"
#include "base/files/scoped_file.h"
#include "base/macros.h"
#include "base/memory/ref_counted.h"
#include "base/observer_list.h"
#include "ui/base/class_property.h"

namespace base {
class RefCountedMemory;
}

namespace ui {
class OSExchangeData;
}

namespace exo {

class DataOfferDelegate;
class DataOfferObserver;
class FileHelper;
enum class DndAction;

// Object representing transferred data offered to a client.
class DataOffer final : public ui::PropertyHandler {
 public:
  explicit DataOffer(DataOfferDelegate* delegate);
  ~DataOffer();

  void AddObserver(DataOfferObserver* observer);
  void RemoveObserver(DataOfferObserver* observer);

  // Accepts one of the offered mime types.
  void Accept(const std::string& mime_type);

  // Requests that the data is transferred. |fd| is a file descriptor for data
  // transfer.
  void Receive(const std::string& mime_type, base::ScopedFD fd);

  // Called when the client is no longer using the data offer object.
  void Finish();

  // Sets the available/preferred drag-and-drop actions.
  void SetActions(const base::flat_set<DndAction>& dnd_actions,
                  DndAction preferred_action);

  // Sets drop data.
  void SetDropData(FileHelper* file_helper, const ui::OSExchangeData& data);

  // Sets source actions.
  void SetSourceActions(const base::flat_set<DndAction>& source_actions);

  DndAction dnd_action() { return dnd_action_; }

 private:
  DataOfferDelegate* const delegate_;

  // Map between mime type and drop data bytes.
  base::flat_map<std::string, scoped_refptr<base::RefCountedMemory>> drop_data_;
  base::flat_set<DndAction> source_actions_;
  DndAction dnd_action_;
  base::ObserverList<DataOfferObserver> observers_;

  DISALLOW_COPY_AND_ASSIGN(DataOffer);
};

}  // namespace exo

#endif  // COMPONENTS_EXO_DATA_OFFER_H_