MxTooltip

MxTooltip — A tooltip widget

Functions

const gchar * mx_tooltip_get_text ()
void mx_tooltip_set_text ()
void mx_tooltip_show ()
void mx_tooltip_hide ()
void mx_tooltip_set_tip_area ()
const ClutterGeometry * mx_tooltip_get_tip_area ()
gboolean mx_tooltip_is_in_browse_mode ()

Properties

char * text Read / Write
ClutterGeometry * tip-area Read / Write

Types and Values

struct MxTooltip
struct MxTooltipClass

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── ClutterActor
            ╰── MxWidget
                ╰── MxFloatingWidget
                    ╰── MxTooltip

Implemented Interfaces

MxTooltip implements ClutterContainer, ClutterScriptable, ClutterAnimatable, AtkImplementorIface and MxStylable.

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.

Functions

mx_tooltip_get_text ()

const gchar *
mx_tooltip_get_text (MxTooltip *tooltip);

Get the text displayed on the tooltip

Parameters

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

Parameters

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.

Parameters

tooltip

a MxTooltip

 

mx_tooltip_hide ()

void
mx_tooltip_hide (MxTooltip *tooltip);

Hide the tooltip

Parameters

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.

Parameters

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

Parameters

tooltip

A MxTooltip

 

Returns

the ClutterGeometry, owned by the tooltip which must not be freed by the application.


mx_tooltip_is_in_browse_mode ()

gboolean
mx_tooltip_is_in_browse_mode (void);

Browse mode is entered whenever a tooltip is displayed and it is left after a short delay when a tooltip is hidden. This is used to make tooltips display quicker when a previous tooltip is already displayed.

Returns

TRUE if the app is in tooltip browse mode or FALSE otherwise.

Since: 1.2

Types and Values

struct MxTooltip

struct MxTooltip;

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


struct MxTooltipClass

struct MxTooltipClass {
  MxFloatingWidgetClass parent_class;

  /* padding for future expansion */
  void (*_padding_0) (void);
  void (*_padding_1) (void);
  void (*_padding_2) (void);
  void (*_padding_3) (void);
  void (*_padding_4) (void);
};

Property Details

The “text” property

  “text”                     char *

Text of the tooltip.

Owner: MxTooltip

Flags: Read / Write

Default value: NULL


The “tip-area” property

  “tip-area”                 ClutterGeometry *

Area on the stage the tooltip applies to.

Owner: MxTooltip

Flags: Read / Write