![]() |
![]() |
![]() |
MATE UI Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Signals |
#include <libmateui/libmateui.h> struct MateDruidPage; GtkWidget * mate_druid_page_new (void
); gboolean mate_druid_page_next (MateDruidPage *druid_page
); void mate_druid_page_prepare (MateDruidPage *druid_page
); gboolean mate_druid_page_back (MateDruidPage *druid_page
); gboolean mate_druid_page_cancel (MateDruidPage *druid_page
); void mate_druid_page_finish (MateDruidPage *druid_page
);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----MateDruidPage +----MateDruidPageEdge +----MateDruidPageStandard
"back" :Run Last
"cancel" :Run Last
"finish" :Run Last
"next" :Run Last
"prepare" :Run Last
The functions in this page are mostly only for the information of developers -- they should never need to call them directly. Typically, a druid will connect to the various signals described here as a way of controlling the behaviour of druids that do not just proceed in a front-to-back fashion (for example, where the subsequent pages depend upon the choice made at some point).
struct MateDruidPage;
MateDruidPage
is deprecated and should not be used in newly-written code.
The widget for a aprticular page in a druid.
GtkWidget * mate_druid_page_new (void
);
mate_druid_page_new
is deprecated and should not be used in newly-written code.
Creates a new MateDruidPage.
Returns : |
The newly created MateDruidPage. |
gboolean mate_druid_page_next (MateDruidPage *druid_page
);
mate_druid_page_next
is deprecated and should not be used in newly-written code.
This will emit the "next" signal for that particular page. It is called by mate-druid exclusively. It is expected that non-linear Druid's will override this signal and return TRUE if it handles changing pages.
|
A DruidPage widget. |
Returns : |
This function will return FALSE by default. |
void mate_druid_page_prepare (MateDruidPage *druid_page
);
mate_druid_page_prepare
is deprecated and should not be used in newly-written code.
This emits the "prepare" signal for the page. It is called by mate-druid exclusively. This function is called immediately prior to a druid page being shown so that it can "prepare" for display.
|
A DruidPage widget. |
gboolean mate_druid_page_back (MateDruidPage *druid_page
);
mate_druid_page_back
is deprecated and should not be used in newly-written code.
This will emit the "back" signal for that particular page. It is called by mate-druid exclusively. It is expected that non-linear Druid's will override this signal and return TRUE if it handles changing pages.
|
A DruidPage widget. |
Returns : |
This function will return FALSE by default. |
gboolean mate_druid_page_cancel (MateDruidPage *druid_page
);
mate_druid_page_cancel
is deprecated and should not be used in newly-written code.
This will emit the "cancel" signal for that particular page. It is called by mate-druid exclusively. It is expected that a Druid will override this signal and return TRUE if it does not want to exit.
|
A DruidPage widget. |
Returns : |
This function will return FALSE by default. |
void mate_druid_page_finish (MateDruidPage *druid_page
);
mate_druid_page_finish
is deprecated and should not be used in newly-written code.
This emits the "finish" signal for the page. It is called by mate-druid exclusively.
|
A DruidPage widget. |
"back"
signalgboolean user_function (MateDruidPage *druidpage,
GtkWidget *widget,
gpointer user_data) : Run Last
|
the object which received the signal. |
|
The MateDruid containg this page. |
|
user data set when the signal handler was connected. |
Returns : |
TRUE if the signal handler has changed the page (since this stops
all further emission of the signal), FALSE otherwise.
|
"cancel"
signalgboolean user_function (MateDruidPage *druidpage,
GtkWidget *widget,
gpointer user_data) : Run Last
|
the object which received the signal. |
|
The MateDruid containg this page. |
|
user data set when the signal handler was connected. |
Returns : |
TRUE if the druid does not want to exit yet, FALSE if the exit
should continue.
|
"finish"
signalvoid user_function (MateDruidPage *druidpage,
GtkWidget *widget,
gpointer user_data) : Run Last
|
the object which received the signal. |
|
The MateDruid containg this page. |
|
user data set when the signal handler was connected. |
"next"
signalgboolean user_function (MateDruidPage *druidpage,
GtkWidget *widget,
gpointer user_data) : Run Last
|
the object which received the signal. |
|
The MateDruid containg this page. |
|
user data set when the signal handler was connected. |
Returns : |
TRUE if the signal handler has changed the page (since this stops
all further emission of the signal), FALSE otherwise.
|
"prepare"
signalvoid user_function (MateDruidPage *druidpage,
GtkWidget *widget,
gpointer user_data) : Run Last
|
the object which received the signal. |
|
The MateDruid containg this page. |
|
user data set when the signal handler was connected. |