GnomeHRef

Name

GnomeHRef -- 

Synopsis


#include <libgnomeui/libgnomeui.h>


struct      GnomeHRef;
GtkWidget*  gnome_href_new                  (const gchar *url,
                                             const gchar *text);
void        gnome_href_construct            (GnomeHRef *href,
                                             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);


Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkButton
                                 +----GnomeHRef

Properties


  "url"                  gchararray           : Read / Write
  "text"                 gchararray           : Read / Write

Style Properties


  "link-color"           GdkColor             : Read

Description

Details

struct GnomeHRef

struct GnomeHRef;


gnome_href_new ()

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.


gnome_href_construct ()

void        gnome_href_construct            (GnomeHRef *href,
                                             const gchar *url,
                                             const gchar *text);


gnome_href_set_url ()

void        gnome_href_set_url              (GnomeHRef *href,
                                             const gchar *url);

Sets the internal URL value within href to the value of url.


gnome_href_get_url ()

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.


gnome_href_set_text ()

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.


gnome_href_get_text ()

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.


gnome_href_set_label ()

void        gnome_href_set_label            (GnomeHRef *href,
                                             const gchar *label);

Warning

gnome_href_set_label is deprecated and should not be used in newly-written code.

deprecated, use gnome_href_set_text


gnome_href_get_label ()

const gchar* gnome_href_get_label           (GnomeHRef *href);

Warning

gnome_href_get_label is deprecated and should not be used in newly-written code.

Deprecated, use gnome_href_get_text.

Properties

"url" (gchararray : Read / Write)

The URL that GnomeHRef activates

"text" (gchararray : Read / Write)

The text on the button

Style Properties

"link-color" (GdkColor : Read)

Color used to draw the link