docs: add docs for GtkTargetPair

This commit is contained in:
William Jon McCann 2014-01-20 15:18:21 -05:00
parent 83e8e38bd2
commit 29f2578cca
2 changed files with 25 additions and 12 deletions

View File

@ -34,13 +34,33 @@
G_BEGIN_DECLS
typedef struct _GtkTargetPair GtkTargetPair;
/**
* GtkTargetPair:
* @target: #GdkAtom representation of the target type
* @flags: #GtkTargetFlags for DND
* @info: an application-assigned integer ID which will
* get passed as a parameter to e.g the #GtkWidget::selection-get
* signal. It allows the application to identify the target
* type without extensive string compares.
*
* A #GtkTargetPair structure is used to represent the same
* information as a table of #GtkTargetEntry, but in
* an efficient form.
*/
struct _GtkTargetPair
{
GdkAtom target;
guint flags;
guint info;
};
/**
* GtkTargetList:
*
* A #GtkTargetList structure is a reference counted list
* of #GtkTargetPair. It is used to represent the same
* information as a table of #GtkTargetEntry, but in
* an efficient form. This structure should be treated as
* of #GtkTargetPair. This structure should be treated as
* opaque.
*/
typedef struct _GtkTargetList GtkTargetList;

View File

@ -37,6 +37,7 @@ G_BEGIN_DECLS
struct _GtkSelectionData
{
/*< private >*/
GdkAtom selection;
GdkAtom target;
GdkAtom type;
@ -48,19 +49,11 @@ struct _GtkSelectionData
struct _GtkTargetList
{
/*< private >*/
GList *list;
guint ref_count;
};
typedef struct _GtkTargetPair GtkTargetPair;
struct _GtkTargetPair
{
GdkAtom target;
guint flags;
guint info;
};
gboolean _gtk_selection_clear (GtkWidget *widget,
GdkEventSelection *event);
gboolean _gtk_selection_request (GtkWidget *widget,