// Copyright (c) 2011 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 UI_BASE_DRAGDROP_GTK_DND_UTIL_H_
#define UI_BASE_DRAGDROP_GTK_DND_UTIL_H_
#include <gtk/gtk.h>
#include <vector>
#include "base/strings/string16.h"
#include "ui/base/ui_base_export.h"
class GURL;
namespace ui {
// Registry of all internal int codes for drag and drop.
enum {
// Intra-application types.
CHROME_TAB = 1 << 0,
CHROME_BOOKMARK_ITEM = 1 << 1,
CHROME_WEBDROP_FILE_CONTENTS = 1 << 2,
CHROME_NAMED_URL = 1 << 3,
// Standard types.
TEXT_PLAIN = 1 << 4,
TEXT_URI_LIST = 1 << 5,
TEXT_HTML = 1 << 6,
// Other types. NETSCAPE_URL is provided for compatibility with other
// apps.
NETSCAPE_URL = 1 << 7,
// Used for drag-out download.
TEXT_PLAIN_NO_CHARSET = 1 << 8,
DIRECT_SAVE_FILE = 1 << 9,
// Custom data for web drag/drop.
CUSTOM_DATA = 1 << 10,
// Tracks if the drag originated from the renderer.
RENDERER_TAINT = 1 << 11,
INVALID_TARGET = 1 << 12,
};
// Get the atom for a given target (of the above enum type). Will return NULL
// for non-custom targets, such as CHROME_TEXT_PLAIN.
UI_BASE_EXPORT GdkAtom GetAtomForTarget(int target);
// Creates a target list from the given mask. The mask should be an OR of
// CHROME_* values. The target list is returned with ref count 1; the caller
// is responsible for calling gtk_target_list_unref() when it is no longer
// needed.
// Since the MIME type for WEBDROP_FILE_CONTENTS depends on the file's
// contents, that flag is ignored by this function. It is the responsibility
// of the client code to do the right thing.
UI_BASE_EXPORT GtkTargetList* GetTargetListFromCodeMask(int code_mask);
// Set the drag target list for |source| with the target list that
// corresponds to |code_mask|.
UI_BASE_EXPORT void SetSourceTargetListFromCodeMask(GtkWidget* source,
int code_mask);
// Set the accepted targets list for |dest|. The |target_codes| array should
// be sorted in preference order and should be terminated with -1.
UI_BASE_EXPORT void SetDestTargetList(GtkWidget* dest, const int* target_codes);
// Write a URL to the selection in the given type.
UI_BASE_EXPORT void WriteURLWithName(GtkSelectionData* selection_data,
const GURL& url,
base::string16 title,
int type);
// Extracts data of type CHROME_NAMED_URL from |selection_data| into
// |url| and |title|. Returns true if the url/title were safely extracted
// and the url is valid.
UI_BASE_EXPORT bool ExtractNamedURL(GtkSelectionData* selection_data,
GURL* url,
base::string16* title);
// Extracts data of type TEXT_URI_LIST from |selection_data| into |urls|.
UI_BASE_EXPORT bool ExtractURIList(GtkSelectionData* selection_data,
std::vector<GURL>* urls);
// Extracts a Netscape URL (url\ntitle) from |selection_data|.
UI_BASE_EXPORT bool ExtractNetscapeURL(GtkSelectionData* selection_data,
GURL* url,
base::string16* title);
} // namespace ui
#endif // UI_BASE_DRAGDROP_GTK_DND_UTIL_H_