MxDialog

MxDialog — a modal, single-widget container

Synopsis

struct              MxDialog;
ClutterActor *      mx_dialog_new                       (void);
void                mx_dialog_set_transient_parent      (MxDialog *dialog,
                                                         ClutterActor *actor);
void                mx_dialog_add_action                (MxDialog *dialog,
                                                         MxAction *action);
void                mx_dialog_remove_action             (MxDialog *dialog,
                                                         MxAction *action);
GList *             mx_dialog_get_actions               (MxDialog *dialog);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----ClutterActor
               +----MxWidget
                     +----MxBin
                           +----MxDialog

Implemented Interfaces

MxDialog implements ClutterScriptable, ClutterAnimatable, AtkImplementorIface, MxStylable, ClutterContainer and MxFocusable.

Description

MxDialog is a single-widget container. When presented, it performs a suitable transition animation and blocks input to the actors beneath it until it is hidden again.

It also allows actions to be added to it, which will be represented as buttons, using MxButton.

Details

struct MxDialog

struct MxDialog;

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


mx_dialog_new ()

ClutterActor *      mx_dialog_new                       (void);

Creates a new MxDialog.

Returns :

A newly allocated MxDialog

mx_dialog_set_transient_parent ()

void                mx_dialog_set_transient_parent      (MxDialog *dialog,
                                                         ClutterActor *actor);

Sets the parent of the MxDialog. This is the actor over which the modal frame will appear when clutter_actor_show() is called.

dialog :

A MxDialog

actor :

A ClutterActor

mx_dialog_add_action ()

void                mx_dialog_add_action                (MxDialog *dialog,
                                                         MxAction *action);

Adds an MxButton that represents action to the button area of dialog

dialog :

A MxDialog

action :

A MxAction

mx_dialog_remove_action ()

void                mx_dialog_remove_action             (MxDialog *dialog,
                                                         MxAction *action);

Removes the button associated with action from the button area of dialog

dialog :

A MxDialog

action :

A MxAction

mx_dialog_get_actions ()

GList *             mx_dialog_get_actions               (MxDialog *dialog);

Retrieves a list of actions added to dialog.

dialog :

A MxDialog

Returns :

A newly allocated GList of MxAction objects. The actions in the list are owned by the dialog.