text: // -------------------------------------------------
  // BlinKit - BlinKit Library
  // -------------------------------------------------
  //   File Name: DataObject.h
  // Description: DataObject Class
  //      Author: Ziming Li
  //     Created: 2021-07-28
  // -------------------------------------------------
  // Copyright (C) 2021 MingYang Software Technology.
  // -------------------------------------------------
  
  /*
   * Copyright (c) 2008, 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
   * copyright notice, this list of conditions and the following disclaimer
   * in the documentation and/or other materials provided with the
   * distribution.
   *     * Neither the name of Google Inc. nor the names of its
   * contributors may be used to endorse or promote products derived from
   * this software without specific prior written permission.
   *
   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
   * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
   * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
   * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
   * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
   * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   */
  
  #ifndef DataObject_h
  #define DataObject_h
  
  #include "core/CoreExport.h"
  #include "core/clipboard/DataObjectItem.h"
  #include "platform/PasteMode.h"
  #include "platform/Supplementable.h"
  #include "platform/heap/Handle.h"
  #include "wtf/ListHashSet.h"
  #include "wtf/PassRefPtr.h"
  #include "wtf/Vector.h"
  #include "wtf/text/StringHash.h"
  #include "wtf/text/WTFString.h"
  
  namespace blink {
  
  class KURL;
  class SharedBuffer;
  class WebDragData;
  
  // A data object for holding data that would be in a clipboard or moved
  // during a drag-n-drop operation. This is the data that WebCore is aware
  // of and is not specific to a platform.
  class CORE_EXPORT DataObject : public BlinKit::GCObject // BKTODO: , public HeapSupplementable<DataObject> {
  {
      USING_GARBAGE_COLLECTED_MIXIN(DataObject);
  public:
      static GCRefPtr<DataObject> createFromPasteboard(PasteMode);
      static GCRefPtr<DataObject> create();
      // BKTODO: static DataObject* create(WebDragData);
  
      virtual ~DataObject();
  
      // DataTransferItemList support.
      size_t length() const;
      DataObjectItem* item(unsigned long index);
      // FIXME: Implement V8DataTransferItemList::indexedPropertyDeleter to get this called.
      void deleteItem(unsigned long index);
      void clearAll();
      // Returns null if an item already exists with the provided type.
      DataObjectItem* add(const String& data, const String& type);
      DataObjectItem* add(File*);
  
      // WebCore helpers.
      void clearData(const String& type);
  
      ListHashSet<String> types() const;
      String getData(const String& type) const;
      void setData(const String& type, const String& data);
  
      void urlAndTitle(String& url, String* title = 0) const;
      void setURLAndTitle(const String& url, const String& title);
      void htmlAndBaseURL(String& html, KURL& baseURL) const;
      void setHTMLAndBaseURL(const String& html, const KURL& baseURL);
  
      // Used for dragging in files from the desktop.
      bool containsFilenames() const;
      Vector<String> filenames() const;
      void addFilename(const String& filename, const String& displayName);
  
      // Used for dragging in filesystem from the desktop.
      void setFilesystemId(const String& fileSystemId) { m_filesystemId = fileSystemId; }
      const String& filesystemId() const { ASSERT(!m_filesystemId.isEmpty()); return m_filesystemId; }
  
      // Used to handle files (images) being dragged out.
      void addSharedBuffer(const String& name, const std::shared_ptr<SharedBuffer> &);
  
      int modifiers() const { return m_modifiers; }
      void setModifiers(int modifiers) { m_modifiers = modifiers; }
  
      DECLARE_TRACE();
  
      // BKTODO: WebDragData toWebDragData();
  
  private:
      DataObject();
  
      DataObjectItem* findStringItem(const String& type) const;
      bool internalAddStringItem(DataObjectItem*);
      void internalAddFileItem(DataObjectItem*);
  
      HeapVector<Member<DataObjectItem>> m_itemList;
  
      // State of Shift/Ctrl/Alt/Meta keys and Left/Right/Middle mouse buttons
      int m_modifiers;
      String m_filesystemId;
  };
  
  } // namespace blink
  
  #endif
  