Details
enum
GtkDestDefaults
typedef enum { GTK_DEST_DEFAULT_MOTION = 1 << 0, /* réponse au mouvement "glisser" */ GTK_DEST_DEFAULT_HIGHLIGHT = 1 << 1, /* auto-surbrillance */ GTK_DEST_DEFAULT_DROP = 1 << 2, /* réponse au "glisser dépose" */ GTK_DEST_DEFAULT_ALL = 0x07 } GtkDestDefaults;
|
L'énumération
GtkDestDefaults
définit les types variés d'actions qui seront
réalisées au nom de l'utilisateur dans un site de
destination d'un glissé.
GTK_DEST_DEFAULT_MOTION |
S'il est défini pour un widget, pendant qu'un
élément est glissé dans ce widget GTK+
contrôlera si le "glisser" s'accorde avec la liste des cibles et
actions possibles pour ce widget.
GTK+ appelera alors gdk_drag_status() si c'est approprié.
|
GTK_DEST_DEFAULT_HIGHLIGHT |
S'il est défini pour un widget, GTK+ dessinera
une surbrillance sur le widget aussi longtemps que le "glisser" est sur
le widget et si le format et l'action du "glisser" est acceptable.
|
GTK_DEST_DEFAULT_DROP |
S'il est défini pour un widget, quand un "glisser" a
lieu, GTK+ contrôlera si le "glisser" s'accorde avec la
liste des cibles et actions possibles pour ce widget. Si
c'est le cas, GTK+ appellera gtk_drag_get_data()
au nom du widget. Si le "glisser" réussit ou s'il ne réussit pas, GTK+ appellera gtk_drag_finish() .
Si l'action est un mouvement, alors si le "glisser" réussit, TRUE sera passé au paramètre delete de gtk_drag_finish() .
|
GTK_DEST_DEFAULT_ALL |
S'il est défini, signifie que toutes les actions par défaut sont activées.
|
enum
GtkTargetFlags
typedef enum { GTK_TARGET_SAME_APP = 1 << 0, /*< nick=same-app >*/ GTK_TARGET_SAME_WIDGET = 1 << 1 /*< nick=same-widget >*/ } GtkTargetFlags;
|
L'énumération GtkTargetFlags est utikisée pour définir les contraintes sur une entrée dans un GtkTargetTable.
GTK_TARGET_SAME_APP |
S'il est défini, la cible sera seulement
sélectionnée pour des "glisser" à
l'intérieur d'une seule application.
|
GTK_TARGET_SAME_WIDGET |
S'il est défini, la cible sera seulement
sélectionnée pour des "glisser" à
l'intérieur d'un seul widget.
|
gtk_drag_dest_set
()
Définit un widget comme étant une destination possible de "déposer".
widget : |
Un GtkWidget
|
flags : |
Les flags qui définissent quelles actions GTK+ doit
effectuer au nom du widget pour "déposer" sur le widget. Les
champs targets et actions
sont seulement utilisés si GTK_DEST_DEFAULT_MOTION
ou GTK_DEST_DEFAULT_DROP sont donnés.
|
targets : |
Pointeur sur un tableau de GtkTargetEntrys
indiquant les types de "dépots" le widget accepte.
|
n_targets : |
Le nombre d'entrées dans targets .
|
actions : |
Un bitmask des actions possible pour le "dépot" sur ce widget.
|
gtk_drag_dest_set_proxy
()
Définit ce widget comme étant un proxy (serveur
mandaté) pour les "dépots" dans une autre
fenêtre.
widget : |
Un GtkWidget
|
proxy_window : |
La fenêtre à laquelle des événement "déposer" sont envoyés.
|
protocol : |
Le protocole de "déposer" que proxy_window
accepte
(Vous pouvez utiliser gdk_drag_get_protocol()
pour le déterminer)
|
use_coordinates : |
Si TRUE ,
envoit les mêmes coordonnées à la
déstination, parce que c'est une sous-fenêtre
incorporée. |
gtk_drag_dest_unset
()
void gtk_drag_dest_unset (GtkWidget *widget);
|
Efface les informations concernant une destination de "déposer" définie avec
gtk_drag_dest_set()
. Le widget ne recevra plus de notification de "glisser".
gtk_drag_dest_find_target
()
Cherche une association entre
context->targets
et
dest_target_list
,
retournant la première cible d'association, sinon la fonction retourne
GDK_NONE
.
dest_target_list
doit être normalement la valeur retournée par
gtk_drag_dest_get_target_list()
,
mais certains widgets peuvent avoir des cibles valides
différentes pour différentes parties du widget; dans ce
cas, ils doivent appliquer un handler de mouvement de glisser qui
passera la liste correcte de cibles à la fonction.
widget : |
Widget de destination du "glisser"
|
context : |
Contexte de "glisser"
|
target_list : |
Liste de cibles pour le "déposer" , ou NULL mour utiliser gtk_drag_dest_get_target_list (widget ).
|
Returns : |
Première cible que la source présente et que le destinataire peut accepter, ou GDK_NONE
|
gtk_drag_dest_get_target_list
()
Retourne la liste des cibles que ce widget peut accepter pour le "glisser-déposer";
gtk_drag_dest_set_target_list
()
Définit les types de cible que ce widget peut accepter pour le
"glisser-déposer". Le widget doit d'habord être
transformé en destination de "glisser" avec
gtk_drag_dest_set()
.
widget : |
Un GtkWidget qui est une destination de "glisser"
|
target_list : |
Liste des cibles "dépot" , ou NULL s'il n'y en a pas
|
gtk_drag_dest_add_text_targets
()
void gtk_drag_dest_add_text_targets (GtkWidget *widget);
|
Ajoute les cibles texte supportées par
GtkSelection
à la liste de cibles de la destination du "glisser". Les cibles sont ajoutées avec
info
= 0. si vous avez besoin d'une autre valeur, utilisez
gtk_target_list_add_text_targets()
et
gtk_drag_dest_set_target_list()
.
widget : |
Un GtkWidget qui est une destination "glisser"
|
Depuis 2.6
gtk_drag_dest_add_image_targets
()
void gtk_drag_dest_add_image_targets (GtkWidget *widget);
|
Ajoute les cibles image supportées par GtkSelection
à la liste de cibles de la destination du "glisser". Les cibles sont ajoutées avec info
= 0. si vous avez besoin d'une autre valeur, utilisez gtk_target_list_add_image_targets()
et
gtk_drag_dest_set_target_list()
.
widget : |
Un GtkWidget qui est une destination "glisser"
|
Depuis 2.6
gtk_drag_dest_add_uri_targets
()
void gtk_drag_dest_add_uri_targets (GtkWidget *widget);
|
Ajoute les cibles URI supportées par GtkSelection
à la liste de cibles de la destination du "glisser". Les cibles sont ajoutées avec info
= 0. si vous avez besoin d'une autre valeur, utilisez
gtk_target_list_add_uri_targets()
et
gtk_drag_dest_set_target_list()
.
widget : |
Un GtkWidget qui est une destination "glisser"
|
Depuis 2.6
gtk_drag_dest_set_track_motion
()
Dit au widget d'émettre les événements
::drag-motion et ::drag-leave sans se soucier des cibles et du
flag GTK_DEST_DEFAULT_MOTION
.
Cela peut être utile quand un widget veut faire des actions
générique sans prendre en compte les cibles que la source
présente.
widget : |
Un GtkWidget qui est une destination "glisser"
|
track_motion : |
Si TRUE, accepte toutes les cibles (il manquait TRUE mais je pense que c'est ça)
|
Depuis 2.10
gtk_drag_dest_get_track_motion
()
Retourbe si le widget a été configuré pour émettre toujours les signaux ::drag-motion.
widget : |
Un GtkWidget qui est une destination "glisser"
|
Returns : |
TRUE si le widget émet toujours les événements ::drag-motion
|
Depuis 2.10
gtk_drag_finish
()
Informe la source du "glisser" que le "dépot" est
terminé, et que les données du "glisser" ne sont plus
requises.
context : |
Un contexte de "glisser"
|
success : |
Un flag indiquant si le "dépot" a réussi.
|
del : |
Un flag indiquant si le source doit supprimer les données d'origine. (Cela doit être TRUE pour un mouvement)
|
time_ : |
Le timestamp du signal "drag_data_drop".
|
gtk_drag_get_data
()
Obtient les données associées à un "glisser".
Quand les données sont reçues ou que la
récupération a échoué, GTK+ va
émettre un signal "drag_data_received". L'échec de la
récupération est indiqué par le champ taille du
paramètre selection_data
du signal qui est négatif . Cependant, quand gtk_drag_get_data()
est appelé implicitement parce que GTK_DEST_DEFAULT_DROP
a été défini, le widget ne recevra pas de notification de l'échec du "dépot".
widget : |
Le widget qui recevra le signal "drag_data_received".
|
context : |
Contexte de "glisser" (ou contexte de drague -->c'est pour rire)
|
target : |
La cible (forme des données) à rechercher.
|
time_ : |
Un timestamp pour rechercher les données.
Généralement c'est le temps reçu dans un signal
"drag_data_motion" ou "drag_data_drop".
|
gtk_drag_get_source_widget
()
Détermine le widget source pour un "glisser".
context : |
Un contexte de "glisser" (côté destination).
|
Retourne : |
Si le "glisser" se produit à l'interieur d'une seule application, c'est un pointeur sur le widget source. Autrement, NULL .
|
gtk_drag_highlight
()
Dessine une surbrillance autour du widger. Ceci attachera des
handlers à "expose_event" et "draw", ainsi la surbrillance
continuera d'être affichée jusqu'à ce que
gtk_drag_unhighlight()
soit appelée.
widget : |
Un widget à mettre en surbrillance
|
gtk_drag_unhighlight
()
void gtk_drag_unhighlight (GtkWidget *widget);
|
Supprime la surbrillance définie par gtk_drag_highlight()
pour un widget.
widget : |
Un widget pour lequel on veut supprimer la surbrillance.
|
gtk_drag_begin
()
Initiamise un "glisser" côté source. La fonction a
besoin seulement d'être utilisée quand l'application
commence les "glisser" elle-même, et n'est pas nécessaire
quand
gtk_drag_source_set()
est utilisé.
widget : |
Le widget source.
|
targets : |
Les cibles (formats des données) dans lesqueles la source peut fournir les données.
|
actions : |
Un bitmask des actions de "glisser" allouées pour ce "glisser"
|
button : |
Le bouton sur lequel l'utilisateur clique pour commencer le "glisser"
|
event : |
L'événement qui déclenche le commencement du "glisser"
|
Retourne : |
Contexte pour ce "glisser"
|
gtk_drag_set_icon_widget
()
Change l'icône d'un widget en un widget donné. GTK+ ne
détruira pas l'icône, aussi si vous ne voulez pas qu'elle
persiste, vous devrez connecter le signal "drag_end" et la
détruire vous-même.
context : |
Contexte pour un "glisser" (doit être appelée avec un contexte pour le côté source du "glisser").
|
widget : |
Fenêtre de haut niveau à utiliser comme icône.
|
hot_x : |
L'offset X dans le widget du
hotspot (Partie de l'écran pour laquelle un clic de souris
provoque un événement particulier par exemple.) |
hot_y : |
L'offset Y dans le widget du hotspot.
|
gtk_drag_set_icon_pixmap
()
Définit un
pixmap
comme
icône pour un "glisser" donné. GTK+retient les
références pour les arguments et les libérera
quand elles ne seront plus nécessaires. En général
gtk_drag_set_icon_pixbuf()
est pus commode à utiliser.
context : |
Contexte pour un "glisser" (doit être appelée avec un contexte pour le côté source du "glisser").
|
colormap : |
La palette de couleur pour l'icône. |
pixmap : |
Les données d'image pour l'icône. |
mask : |
Le masque transparent pour l'îcone.
|
hot_x : |
L'offset X dans le pixmap
du hotspot
|
hot_y : |
L'offset Y dans le pixmap
du hotspot |
gtk_drag_set_icon_pixbuf
()
Définit un pixbuf
en tant qu'icône pour un "glisser" donné.
context : |
Contexte pour un "glisser" (doit être appelée avec un contexte pour le côté source du "glisser").
|
pixbuf : |
Le GdkPixbuf à utiliser comme icône "glisser".
|
hot_x : |
L'offset X dans le widget
du hotspot.
|
hot_y : |
L'offset Y dans le widget
du hotspot.
|
gtk_drag_set_icon_stock
()
Définit l'icône pour un "glisser" donné à partir d'un stock ID.
context : |
Contexte pour un "glisser" (doit être appelée avec un contexte pour le côté source du "glisser").
|
stock_id : |
L' ID de la stock icon à utiliser pour le "glisser".
|
hot_x : |
L'offset X dans l'icône du hotspot.
|
hot_y : |
L'offset Y dans l'icône du hotspot. |
gtk_drag_set_icon_name
()
Définit l'icône pour un "glisser " donné
à partir d'une icône (named Themed). Voir la documentation pour GtkIconTheme
pour plus de détails. Notez que la taille de l'icône
dépend du thème de l'icône (l'icône est
chargée à la taille symbolique GTK_ICON_SIZE_DND), ainsi hot_x et hot_y doivent être employés avec précaussion.
context : |
Contexte pour un "glisser" (doit être appelée avec un contexte pour le côté source du "glisser").
|
icon_name : |
Nom de l'icône à utiliser.
|
hot_x : |
L'offset X du hotspot dans l'icône. |
hot_y : |
L'offset Y du hotspot dans l'icône.
|
Depuis 2.8
gtk_drag_set_icon_default
()
Définit d'un "glisser" particulier à l'icône par défaut.
context : |
Contexte pour un "glisser" (doit être appelée avec un contexte pour le côté source du "glisser").
|
gtk_drag_set_default_icon
()
Attendtion
gtk_drag_set_default_icon
est dépréciée et ne doit plus être utilisée dans du code nouvellement écrit.
Modifie l'icône "glisser" par défaut. GTK+ retient les
références pour les arguments, et les linérera
quand ils ne seront plus nécessaires. Cette fonction est
obsolète. l'icône par défaut doit être
modifiée maintenant via le système de stock en changeant
le pixbuf du stock pour GTK_STOCK_DND.
colormap : |
La palette de couleur pour l'icône
|
pixmap : |
Les données images pour l'icône
|
mask : |
Le masque transparent pour une image
|
hot_x : |
L'offset X du hotspot dans le widget .
|
hot_y : |
L'offset Y du hotspot dans le widget .
|
gtk_drag_check_threshold
()
Contrôle pour voir si un "glisser" de souris commençant à (start_x
,
start_y
)
et se termine à (current_x
,
current_y
) a passé le seuil de "glisser" de GTK+, et ainsi peut amorser l'opération "glisser - déposer".
widget : |
Un GtkWidget
|
start_x : |
Coordonnée X de départ de "glisser"
|
start_y : |
Coordonnée Y de départ de "glisser"
|
current_x : |
Coordonnée X courante
|
current_y : |
Coordonnée y courante
|
Retourne : |
TRUE si le seuil du "glisser" a été passé
|
gtk_drag_source_set
()
Définit un widget de telle sort que GTK+
débutera une opération de "glisser" quand l'utilisateur
cliquera et glissera sur le widget. Le widget doit avoir une
fénêtre.
widget : |
Un GtkWidget
|
start_button_mask : |
Le bitmask des boutons qui peuvent faire commencer le "glisser"
|
targets : |
Une table de cibles que le "glisser" supporte.
|
n_targets : |
Nombre d'items dans targets
|
actions : |
Le bitmask des actions possibles pour un "glisser" depuis ce widget.
|
gtk_drag_source_set_icon
()
Définit l'icône que sera utilisée pour les
"glisser" depuis un widget particulier par un pixmap/mask (from a pixmap/mask) .GTK+ retient les
références pour les arguments, et les linérera
quand ils ne seront plus nécessaires. Utilisez gtk_drag_source_set_icon_pixbuf()
à la place.
widget : |
Un GtkWidget
|
colormap : |
La palette de couleur pour l'icône
|
pixmap : |
Les données images pour l'icône
|
mask : |
Le masque transparent pour une image
|
gtk_drag_source_set_icon_pixbuf
()
Définit l'icône que sera utilisée pour les "glisser" depuis un widget particulier par un GdkPixbuf. GTK+ retient les
références pour les arguments, et les linérera
quand ils ne seront plus nécessaires.
gtk_drag_source_set_icon_stock
()
void gtk_drag_source_set_icon_stock (GtkWidget *widget, const gchar *stock_id);
|
Définit l'icône que sera utilisée pour les "glisser" depuis un widget particulier par une stock icon.
widget : |
Un GtkWidget
|
stock_id : |
L' ID de la stock icon à utiliser
|
gtk_drag_source_set_icon_name
()
void gtk_drag_source_set_icon_name (GtkWidget *widget, const gchar *icon_name);
|
Définit l'icône que sera utilisée pour les "glisser" depuis un widget particulier par une themed icon. Voir la documentation pour GtkIconTheme
pour plus de détails.
widget : |
Un GtkWidget
|
icon_name : |
Nom de l'icône à utiliser |
Depuis 2.8
gtk_drag_source_set_target_list
()
Modifie les types de cibles que le widget propose pour le
"glisser-coller" Le widget doit d'abord être transformé en
source de "glisser" avec
gtk_drag_source_set()
.
widget : |
Un GtkWidget qui est une source de "glisser"
|
target_list : |
Liste de cibles à glisser, ou NULL s'il n'y en a pas
|
Depuis 2.4
gtk_drag_source_get_target_list
()
Obtient la liste des cibles que ce widget peut fournir pour le "glisser-déposer".
Depuis 2.4
gtk_drag_source_add_image_targets
()
void gtk_drag_source_add_image_targets (GtkWidget *widget);
|
Ajoute les cibles image à affichage supportées par GtkSelectionà la liste des cibles de la source de "glisser". Les cibles sont ajoutées avec info
= 0. Si vous avez besoin d'une autre valeur, utilisez
gtk_target_list_add_image_targets()
et
gtk_drag_source_set_target_list()
.
widget : |
Un GtkWidget qui est une source de "glisser"
|
Depuis 2.6
gtk_drag_source_add_uri_targets
()
void gtk_drag_source_add_uri_targets (GtkWidget *widget);
Ajoute les cibles URI supportées par GtkSelection GtkSelectionà la liste des cibles de la source de "glisser". Les cibles sont ajoutées avec info
= 0. Si vous avez besoin d'une autre valeur, utilisez gtk_target_list_add_uri_targets()
et
gtk_drag_source_set_target_list()
.
widget : |
Un GtkWidget qui est une source de "glisser"
|
Depuis 2.6