![]() |
![]() |
![]() |
GNOME UI Library Reference Manual | ![]() |
---|---|---|---|---|
#include <libgnomeui/libgnomeui.h> 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
GtkWidget* gnome_href_new (const gchar *url, const gchar *text);
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 : |
URL assigned to this object. |
text : |
Text associated with the URL. |
Returns : | Pointer to new GNOME href widget. |
void gnome_href_set_url (GnomeHRef *href, const gchar *url);
Sets the internal URL value within href
to the value of url
.
href : |
Pointer to GnomeHRef widget |
url : |
String containing the URL to be stored within href .
|
const gchar* gnome_href_get_url (GnomeHRef *href);
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.
href : |
Pointer to GnomeHRef widget |
Returns : | Pointer to an internal URL string, or NULL if failure.
|
void gnome_href_set_text (GnomeHRef *href, const gchar *text);
Sets the internal label widget text (used to display a URL's link
text) to the value given in label
.
href : |
Pointer to GnomeHRef widget |
text : |
New link text for the href object. |
const gchar* gnome_href_get_text (GnomeHRef *href);
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.
href : |
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
href : |
Pointer to GnomeHRef widget |
label : |
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.
href : |
Pointer to GnomeHRef widget |
Returns : |