MxTooltip

## MxTooltip MxTooltip — A tooltip widget |

## Synopsis

    struct              MxTooltip;
    const gchar *       mx_tooltip_get_text                 (MxTooltip *tooltip);
    void                mx_tooltip_set_text                 (MxTooltip *tooltip,
                                                             const gchar *text);
    void                mx_tooltip_show                     (MxTooltip *tooltip);
    void                mx_tooltip_hide                     (MxTooltip *tooltip);
    void                mx_tooltip_set_tip_area             (MxTooltip *tooltip,
                                                             const ClutterGeometry *area);
    const ClutterGeometry *  mx_tooltip_get_tip_area        (MxTooltip *tooltip);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----ClutterActor
                   +----MxWidget
                         +----MxFloatingWidget
                               +----MxTooltip

## Implemented Interfaces

MxTooltip implements ClutterScriptable and MxStylable.

## Properties

      "text"                     gchar*                : Read / Write
      "tip-area"                 ClutterGeometry*      : Read / Write

## Description

MxTooltip implements a single tooltip. It should not normally be created by the application but by the widget implementing tooltip capabilities, for example, mx_widget_set_tooltip_text.

## Details

### struct MxTooltip

    struct MxTooltip;

The contents of this structure is private and should only be accessed using the provided API.

### mx_tooltip_get_text ()

    const gchar *       mx_tooltip_get_text                 (MxTooltip *tooltip);

Get the text displayed on the tooltip

`tooltip` : | a MxTooltip
Returns : | the text for the tooltip. This must not be freed by the application

### mx_tooltip_set_text ()

    void                mx_tooltip_set_text                 (MxTooltip *tooltip,
                                                             const gchar *text);

Sets the text displayed on the tooltip

`tooltip` : | a MxTooltip
`text` : | text to set the label to

### mx_tooltip_show ()

    void                mx_tooltip_show                     (MxTooltip *tooltip);

Show the tooltip relative to the associated widget.

`tooltip` : | a MxTooltip

### mx_tooltip_hide ()

    void                mx_tooltip_hide                     (MxTooltip *tooltip);

Hide the tooltip

`tooltip` : | a MxTooltip

### mx_tooltip_set_tip_area ()

    void                mx_tooltip_set_tip_area             (MxTooltip *tooltip,
                                                             const ClutterGeometry *area);

Set the area on the stage that the tooltip applies to.

`tooltip` : | A MxTooltip
`area` : | A ClutterGeometry

### mx_tooltip_get_tip_area ()

    const ClutterGeometry *  mx_tooltip_get_tip_area        (MxTooltip *tooltip);

Retrieve the area on the stage that the tooltip currently applies to

`tooltip` : | A MxTooltip
Returns : | the ClutterGeometry, owned by the tooltip which must not be freed by the application.

## Property Details

### The `"text"` property

      "text"                     gchar*                : Read / Write

Text of the tooltip.

Default value: NULL

### The `"tip-area"` property

      "tip-area"                 ClutterGeometry*      : Read / Write

Area on the stage the tooltip applies to.