GnomeHRef

GnomeHRef

Functions

Properties

gchar * text Read / Write
gchar * url Read / Write

Style Properties

Types and Values

struct GnomeHRef

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkButton
                            ╰── GnomeHRef

Implemented Interfaces

GnomeHRef implements AtkImplementorIface, GtkBuildable and GtkActivatable.

Includes

#include <libgnomeui/libgnomeui.h>

Description

Functions

gnome_href_new ()

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.

Parameters

url

URL assigned to this object.

 

text

Text associated with the URL.

 

Returns

Pointer to new GNOME href widget.


gnome_href_set_url ()

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 .

Parameters

href

Pointer to GnomeHRef widget

 

url

String containing the URL to be stored within href .

 

gnome_href_get_url ()

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.

Parameters

href

Pointer to GnomeHRef widget

 

Returns

Pointer to an internal URL string, or NULL if failure.


gnome_href_set_text ()

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 .

Parameters

href

Pointer to GnomeHRef widget

 

text

New link text for the href object.

 

gnome_href_get_text ()

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.

Parameters

href

Pointer to GnomeHRef widget

 

Returns

Pointer to text contained in the label widget.


gnome_href_set_label ()

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

Parameters

href

Pointer to GnomeHRef widget

 

label

New link text for the href object.

 

gnome_href_get_label ()

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.

Parameters

href

Pointer to GnomeHRef widget

 

Types and Values

struct GnomeHRef

struct GnomeHRef;

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

Property Details

The “text” property

  “text”                     gchar *

The text on the button.

Flags: Read / Write

Default value: "End World Hunger"


The “url” property

  “url”                      gchar *

The URL that GnomeHRef activates.

Flags: Read / Write

Default value: "http://www.wfp.org"

Style Property Details

The “link-color” style property

  “link-color”               GdkColor *

Color used to draw the link.

Flags: Read