mirror of
https://github.com/brl/mutter.git
synced 2024-12-27 05:12:15 +00:00
2b81d90dd7
The G_CONST_RETURN define in GLib is, and has always been, a bit fuzzy. We always used it to conform to the platform, at least for public-facing API. At first I assumed it has something to do with brain-damaged compilers or with weird platforms where const was not really supported; sadly, it's something much, much worse: it's a define that can be toggled at compile-time to remove const from the signature of public API. This is a truly terrifying feature that I assume was added in the past century, and whose inception clearly had something to do with massive doses of absynthe and opium — because any other explanation would make the existence of such a feature even worse than assuming drugs had anything to do with it. Anyway, and pleasing the gods, this dubious feature is being removed/deprecated in GLib; see bug: https://bugzilla.gnome.org/show_bug.cgi?id=644611 Before deprecation, though, we should just remove its usage from the whole API. We should especially remove its usage from Cally's internals, since there it never made sense in the first place.
85 lines
2.4 KiB
C
85 lines
2.4 KiB
C
/* inclusion guard */
|
|
#ifndef __CB_BUTTON_H__
|
|
#define __CB_BUTTON_H__
|
|
|
|
/* include any dependencies */
|
|
#include <clutter/clutter.h>
|
|
|
|
/* GObject implementation */
|
|
|
|
/* declare this function signature to remove compilation errors with -Wall;
|
|
* the cb_button_get_type() function is actually added via the
|
|
* G_DEFINE_TYPE macro in the .c file
|
|
*/
|
|
GType cb_button_get_type (void);
|
|
|
|
/* GObject type macros */
|
|
/* returns the class type identifier (GType) for CbButton */
|
|
#define CB_TYPE_BUTTON (cb_button_get_type ())
|
|
|
|
/* cast obj to a CbButton object structure*/
|
|
#define CB_BUTTON(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), CB_TYPE_BUTTON, CbButton))
|
|
|
|
/* check whether obj is a CbButton */
|
|
#define CB_IS_BUTTON(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), CB_TYPE_BUTTON))
|
|
|
|
/* cast klass to CbButtonClass class structure */
|
|
#define CB_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), CB_TYPE_BUTTON, CbButtonClass))
|
|
|
|
/* check whether klass is a member of the CbButtonClass */
|
|
#define CB_IS_BUTTON_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), CB_TYPE_BUTTON))
|
|
|
|
/* get the CbButtonClass structure for a CbButton obj */
|
|
#define CB_BUTTON_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), CB_TYPE_BUTTON, CbButtonClass))
|
|
|
|
/*
|
|
* Private instance fields; see
|
|
* http://www.gotw.ca/gotw/024.htm for the rationale
|
|
*/
|
|
typedef struct _CbButtonPrivate CbButtonPrivate;
|
|
typedef struct _CbButton CbButton;
|
|
typedef struct _CbButtonClass CbButtonClass;
|
|
|
|
/* object structure */
|
|
struct _CbButton
|
|
{
|
|
/*<private>*/
|
|
ClutterActor parent_instance;
|
|
|
|
/* structure containing private members */
|
|
/*<private>*/
|
|
CbButtonPrivate *priv;
|
|
};
|
|
|
|
/* class structure */
|
|
struct _CbButtonClass
|
|
{
|
|
/* signals */
|
|
void (* clicked)(CbButton *button);
|
|
|
|
/*<private>*/
|
|
ClutterActorClass parent_class;
|
|
};
|
|
|
|
/* public API */
|
|
|
|
/* constructor - note this returns a ClutterActor instance */
|
|
ClutterActor *cb_button_new (void);
|
|
|
|
/* getter */
|
|
const gchar *cb_button_get_text (CbButton *self);
|
|
|
|
/* setters - these are wrappers round functions
|
|
* which change properties of the internal actors
|
|
*/
|
|
void cb_button_set_text (CbButton *self,
|
|
const gchar *text);
|
|
|
|
void cb_button_set_background_color (CbButton *self,
|
|
const ClutterColor *color);
|
|
|
|
void cb_button_set_text_color (CbButton *self,
|
|
const ClutterColor *color);
|
|
|
|
#endif /* __CB_BUTTON_H__ */
|