|  |  |  | GNOME UI Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Style Properties | ||||
#include <libgnomeui/libgnomeui.h> struct GnomeHRef; GtkWidget * gnome_href_new (const gchar *url,const gchar *text); void gnome_href_set_url (GnomeHRef *href,const gchar *url); const gchar * gnome_href_get_url (GnomeHRef *href); void gnome_href_set_text (GnomeHRef *href,const gchar *text); const gchar * gnome_href_get_text (GnomeHRef *href); void gnome_href_set_label (GnomeHRef *href,const gchar *label); const gchar * gnome_href_get_label (GnomeHRef *href);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----GnomeHRef
struct GnomeHRef;
GnomeHRef is deprecated and should not be used in newly-written code.
GtkWidget * gnome_href_new (const gchar *url,const gchar *text);
gnome_href_new is deprecated and should not be used in newly-written code.
Created a GNOME href object, a label widget with a clickable action
and an associated URL.  If text is set to NULL, url is used as
the text for the label.
| 
 | URL assigned to this object. | 
| 
 | Text associated with the URL. | 
| Returns : | Pointer to new GNOME href widget. | 
void gnome_href_set_url (GnomeHRef *href,const gchar *url);
gnome_href_set_url is deprecated and should not be used in newly-written code.
Sets the internal URL value within href to the value of url.
| 
 | Pointer to GnomeHRef widget | 
| 
 | String containing the URL to be stored within href. | 
const gchar *       gnome_href_get_url                  (GnomeHRef *href);
gnome_href_get_url is deprecated and should not be used in newly-written code.
Returns the pointer to the URL associated with the href href object.  Note
that the string should not be freed as it is internal memory.
| 
 | Pointer to GnomeHRef widget | 
| Returns : | Pointer to an internal URL string, or NULLif failure. | 
void gnome_href_set_text (GnomeHRef *href,const gchar *text);
gnome_href_set_text is deprecated and should not be used in newly-written code.
Sets the internal label widget text (used to display a URL's link
text) to the value given in label.
| 
 | Pointer to GnomeHRef widget | 
| 
 | New link text for the href object. | 
const gchar *       gnome_href_get_text                 (GnomeHRef *href);
gnome_href_get_text is deprecated and should not be used in newly-written code.
Returns the contents of the label widget used to display the link text. Note that the string should not be freed as it points to internal memory.
| 
 | Pointer to GnomeHRef widget | 
| Returns : | Pointer to text contained in the label widget. | 
void gnome_href_set_label (GnomeHRef *href,const gchar *label);
gnome_href_set_label is deprecated and should not be used in newly-written code.
deprecated, use gnome_href_set_text
| 
 | Pointer to GnomeHRef widget | 
| 
 | New link text for the href object. | 
const gchar *       gnome_href_get_label                (GnomeHRef *href);
gnome_href_get_label is deprecated and should not be used in newly-written code.
Deprecated, use gnome_href_get_text.
| 
 | Pointer to GnomeHRef widget | 
"text" property"text" gchar* : Read / Write
The text on the button.
Default value: "End World Hunger"
"url" property"url" gchar* : Read / Write
The URL that GnomeHRef activates.
Default value: "http://www.wfp.org"