Tiré de GTK+ Reference Manual
acryline 2007 Boosteur de petits projets

GtkLinkButton

GtkLinkButton — Crée des boutons reliés à un  URL

Synopsis

#include <gtk/gtk.h>


                    GtkLinkButton;
GtkWidget*          gtk_link_button_new                 (const gchar *uri);
GtkWidget*          gtk_link_button_new_with_label      (const gchar *uri,
                                                         const gchar *label);
const gchar*        gtk_link_button_get_uri             (GtkLinkButton *link_button);
void                gtk_link_button_set_uri             (GtkLinkButton *link_button,
                                                         const gchar *uri);
void                (*GtkLinkButtonUriFunc)             (GtkLinkButton *button,
                                                         const gchar *link,
                                                         gpointer user_data);
GtkLinkButtonUriFunc gtk_link_button_set_uri_hook       (GtkLinkButtonUriFunc func,
                                                         gpointer data,
                                                         GDestroyNotify destroy);

Hiérarchie d'Objet

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkButton
                                       +----GtkLinkButton
 









Interfaces Implémentés




GtkLinkButton implémente
AtkImplementorIface.









Propriétés






  

    


      
      
  "uri"                      gchararray            : Lire / Ecrire

      		

    


  










Description




Un GtkLinkButton est un GtkButton
avec un hyperlien, semblables à ceux utilisés par les
explorateurs web, qui déclenches une action quand on clique
dessus. On les utilise pour afficher des liens rapides vers des
ressources.




Un bouton de lien  est créé en appelant soit  gtk_link_button_new()
ou
gtk_link_button_new_with_label().
Si vous utilisez la deuxième fonction, l'URI que vous passez au
constructeur est utilisé comme label pour le widget.




L'URI relié a un  GtkLinkButton
peut être défini en utilisant 
gtk_link_button_set_uri(), et recherché en utilisant gtk_link_button_get_uri().





GtkLinkButton offre une fonction hook globale qui est appelée quand l'utilisateur clique sur le lien : voir  gtk_link_button_set_uri_hook().





GtkLinkButton a été ajouté dans  GTK+ 2.10.










Details






GtkLinkButton






  

    


      
      
typedef struct _GtkLinkButton GtkLinkButton;

      		

    


  
  




La structure  GtkLinkButton 
contient seulement des données privées, et elle doit
être manipulée en utilisant les fonctions décrites
ci-dessous.











gtk_link_button_new
()






  

    


      
      
GtkWidget*          gtk_link_button_new                 (const gchar *uri);

      		

    


  
  



Crée un nouveau GtkLinkButton
avec pour texte l'URI.












   

    


      uri :

      un URI valide 

    


    


      Retourne :

      un nouveau widget  bouton pour lien 

    


  







Depuis 2.10











gtk_link_button_new_with_label
()






  

    


      
      
GtkWidget*          gtk_link_button_new_with_label      (const gchar *uri,
                                                         const gchar *label);

      		

    


  
  



Crée un nouveau  GtkLinkButton
contenant un label.












   

    


      uri :

      un URI valide 

    


    


      label :

      texte du bouton 

    


    


      Retourne :

      un nouveau widget bouton pour lien 

    


  







Depuis 2.10











gtk_link_button_get_uri
()






  

    


      
      
const gchar*        gtk_link_button_get_uri             (GtkLinkButton *link_button);

      		

    


  
  



Recherche l'URI défini en utilisant  gtk_link_button_set_uri().












   

    


      link_button :

       un GtkLinkButton
      

    


    


      Retourne :

      un URI valide. La chaîne retournée appartient au
pouton et ne doit ni être modifiée ni
libérée. 

    


  







Depuis 2.10











gtk_link_button_set_uri
()






  

    


      
      
void                gtk_link_button_set_uri             (GtkLinkButton *link_button,
                                                         const gchar *uri);

      		

    


  
  



Définit  uri
comme le où pointe le  GtkLinkButton.












   

    


      link_button :

      un GtkLinkButton
      

    


    


      uri :

      un URI valide 

    


  







Depuis 2.10











GtkLinkButtonUriFunc
()






  

    


      
      
void                (*GtkLinkButtonUriFunc)             (GtkLinkButton *button,
                                                         const gchar *link,
                                                         gpointer user_data);

      		

    


  
  



Le type d'une fonction qui est appelée quand on clique sur un GtkLinkButton.








   

    


      button :

       GtkLinkButton sur lequel on a cliqué 

    


    


      link :

      URI pour lequel le GtkLinkButton  cliqué pointe. 

    


    


      user_data :

       

    


  














gtk_link_button_set_uri_hook
()






  

    


      
      
GtkLinkButtonUriFunc gtk_link_button_set_uri_hook       (GtkLinkButtonUriFunc func,
                                                         gpointer data,
                                                         GDestroyNotify destroy);

      		

    


  
  



Définit  func
comme étant la fonction qui devra être appelée chaque fois que l'utilisateur clique sur un GtkLinkButton. Cette fonction est appelée avant tout  callback enregistré pour le signal "clicked".












   

    


      func :

      fonction appelée chaque fois qu'un GtkLinkButton est cliqué, ou NULL 

    


    


      data :

      données utilisateur passée à  func,
ou NULL 

    


    


      destroy :

       un GDestroyNotify qui sera appelée quand data
n'est plus nécessaire, ou NULL 

    


    


      Retourne :

      la fonction hook préalablement définie 

    


  







Depuis 2.10













Détails de propriétés






The "uri" property






  

    


      
      
  "uri"                      gchararray            : Lire / Ecrire

      		

    


  
  




Lien URI pour ce bouton








Valeur par défaut : "http://www.gtk.org"



Depuis 2.10













Voir Aussi




GtkButton