MCC_Hyperlink

--background--

EXAMPLE

    Boopsiobject *clickable_link = HyperlinkObject,
        MUIA_Hyperlink_URI, "http://www.morphos-team.net",
        TAG_DONE

DESCRIPTION

    With this class you can implement clickable URIs to your
    applications.

MUIA_Hyperlink_HoverTip

MUIA_Hyperlink_HoverTip [..G], CONST_STRPTR

DESCRIPTION

    This attribute is set when mouse pointer is over a link

MUIA_Hyperlink_NoMenu

MUIA_Hyperlink_NoMenu [I..], BOOL (V22)

DESCRIPTION

    Disable built-in popup menu.

    By default Hyperlink.mcc displays a popup menu when right mouse button is
    clicked on a link

NOTES

    If you pass static popup menu using MUIA_ContextMenu attribute then the built-in
  popup menu is automatically disabled.

MUIA_Hyperlink_Type

MUIA_Hyperlink_Type [I..], ULONG (V22)

DESCRIPTION

    Set hyperlink button type.

    MUIV_Hyperlink_Type_Web    - web browser look (link text underlined, no frame)
  MUIV_Hyperlink_Type_Button - normal button look with button frame

MUIA_Hyperlink_URI

MUIA_Hyperlink_URI [ISG], CONST_STRPTR

DESCRIPTION

    Set or get an URI

MUIM_Hyperlink_Copy

SYNOPSIS

    DoMethod(obj, MUIM_Hyperlink_Copy, ULONG ClipboardUnit);

DESCRIPTION

    Copy URI to the clipboard

RESULT

    TRUE if copy succeeded, FALSE if there was an error

INPUT

    ClipboardUnit - the clipboard unit number (usually you should use unit 0)

MUIM_Hyperlink_Decode

SYNOPSIS

    DoMethod(obj, MUIM_Hyperlink_Decode, CONST_STRPTR InputString, STRPTR OutputBuffer);

DESCRIPTION

    Decode percent encoded string to buffer

RESULT

    The length of decoded string or -1 in case of error. The length includes terminating NULL

INPUT

    InputString  - the percent encoded string
    OutputBuffer - the buffer for decoded string (can be NULL to get decoded length)

SPECIAL INPUTS

    MUIV_Hyperlink_Decode_Count - pass this as OutputBuffer to get decoded length.

MUIM_Hyperlink_Encode

SYNOPSIS

    DoMethod(obj, MUIM_Hyperlink_Encode, CONST_STRPTR InputString, STRPTR OutputBuffer);

DESCRIPTION

    Encode string to the percent encoding

RESULT

    The length of decoded string or -1 in case of error. The length includes terminating NULL

INPUT

    InputString  - the string to be encoded
    OutputBuffer - the buffer for encoded string (can be NULL to get encoded length)

SPECIAL INPUTS

    MUIV_Hyperlink_Encode_Count - pass this as OutputBuffer to get encoded length.

MUIM_Hyperlink_Follow

SYNOPSIS

    DoMethod(obj, MUIM_Hyperlink_Follow);

DESCRIPTION

    Follow hyperlink

RESULT

    TRUE on success, FALSE if there was an error