APP_INDICATOR_TYPE

#define APP_INDICATOR_TYPE            (app_indicator_get_type ())

Get the GType for a AppIndicator.

APP_INDICATOR()

#define APP_INDICATOR(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), APP_INDICATOR_TYPE, AppIndicator))

Safely convert a GObject into an AppIndicator.

APP_INDICATOR_CLASS()

#define APP_INDICATOR_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), APP_INDICATOR_TYPE, AppIndicatorClass))

Safely convert a GObjectClass into a AppIndicatorClass.

IS_APP_INDICATOR()

#define IS_APP_INDICATOR(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), APP_INDICATOR_TYPE))

Checks to see if obj is in the object hierarchy of AppIndicator.

IS_APP_INDICATOR_CLASS()

#define IS_APP_INDICATOR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), APP_INDICATOR_TYPE))

Checks to see if klass is in the object class hierarchy of AppIndicatorClass.

APP_INDICATOR_GET_CLASS()

#define APP_INDICATOR_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), APP_INDICATOR_TYPE, AppIndicatorClass))

Gets a pointer to the AppIndicatorClass for the object obj.

APP_INDICATOR_SIGNAL_NEW_ICON

#define APP_INDICATOR_SIGNAL_NEW_ICON            "new-icon"

String identifier for the "new-icon" signal.

APP_INDICATOR_SIGNAL_NEW_ATTENTION_ICON

#define APP_INDICATOR_SIGNAL_NEW_ATTENTION_ICON  "new-attention-icon"

String identifier for the "new-attention-icon" signal.

APP_INDICATOR_SIGNAL_NEW_STATUS

#define APP_INDICATOR_SIGNAL_NEW_STATUS          "new-status"

String identifier for the "new-status" signal.

APP_INDICATOR_SIGNAL_NEW_LABEL

#define APP_INDICATOR_SIGNAL_NEW_LABEL           "new-label"

String identifier for the "new-label" signal.

APP_INDICATOR_SIGNAL_NEW_ICON_THEME_PATH

#define APP_INDICATOR_SIGNAL_NEW_ICON_THEME_PATH "new-icon-theme-path"

String identifier for the "new-icon-theme-path" signal.

APP_INDICATOR_SIGNAL_CONNECTION_CHANGED

#define APP_INDICATOR_SIGNAL_CONNECTION_CHANGED  "connection-changed"

String identifier for the "connection-changed" signal.

enum AppIndicatorCategory

typedef enum { /*< prefix=APP_INDICATOR_CATEGORY >*/
	APP_INDICATOR_CATEGORY_APPLICATION_STATUS, /*< nick=ApplicationStatus >*/
	APP_INDICATOR_CATEGORY_COMMUNICATIONS, /*< nick=Communications >*/
	APP_INDICATOR_CATEGORY_SYSTEM_SERVICES, /*< nick=SystemServices >*/
	APP_INDICATOR_CATEGORY_HARDWARE, /*< nick=Hardware >*/
	APP_INDICATOR_CATEGORY_OTHER /*< nick=Other >*/
} AppIndicatorCategory;

The category provides grouping for the indicators so that users can find indicators that are similar together.

enum AppIndicatorStatus

typedef enum { /*< prefix=APP_INDICATOR_STATUS >*/
	APP_INDICATOR_STATUS_PASSIVE, /*< nick=Passive >*/
	APP_INDICATOR_STATUS_ACTIVE, /*< nick=Active >*/
	APP_INDICATOR_STATUS_ATTENTION /*< nick=NeedsAttention >*/
} AppIndicatorStatus;

These are the states that the indicator can be on in the user's panel. The indicator by default starts in the state APP_INDICATOR_STATUS_PASSIVE and can be shown by setting it to APP_INDICATOR_STATUS_ACTIVE.

AppIndicatorPrivate

typedef struct _AppIndicatorPrivate AppIndicatorPrivate;

All of the private data in an instance of a application indicator.

AppIndicator

typedef struct _AppIndicator AppIndicator;

A application indicator represents the values that are needed to show a unique status in the panel for an application. In general, applications should try to fit in the other indicators that are available on the panel before using this. But, sometimes it is necissary.

AppIndicatorClass

typedef struct {
	/* Parent */
	GObjectClass parent_class;

	/* DBus Signals */
	void (* new_icon)               (AppIndicator      *indicator,
	                                 gpointer            user_data);
	void (* new_attention_icon)     (AppIndicator      *indicator,
	                                 gpointer            user_data);
	void (* new_status)             (AppIndicator      *indicator,
	                                 const gchar       *status,
	                                 gpointer            user_data);
	void (* new_icon_theme_path)    (AppIndicator      *indicator,
	                                 const gchar       *icon_theme_path,
	                                 gpointer            user_data);
	void (* new_label)              (AppIndicator       *indicator,
	                                 const gchar        *label,
	                                 const gchar        *guide,
	                                 gpointer            user_data);

	/* Local Signals */
	void (* connection_changed)     (AppIndicator * indicator,
	                                 gboolean          connected,
	                                 gpointer          user_data);
	void (*app_indicator_reserved_sw)(void);
	void (*app_indicator_reserved_ats)(void);

	/* Overridable Functions */
	GtkStatusIcon * (*fallback)     (AppIndicator * indicator);
	void (*unfallback)              (AppIndicator * indicator,
	                                 GtkStatusIcon * status_icon);

	/* Reserved */
	void (*app_indicator_reserved_1)(void);
	void (*app_indicator_reserved_2)(void);
	void (*app_indicator_reserved_3)(void);
	void (*app_indicator_reserved_4)(void);
	void (*app_indicator_reserved_5)(void);
	void (*app_indicator_reserved_6)(void);
} AppIndicatorClass;

The signals and external functions that make up the AppIndicator class object.

app_indicator_get_type ()

GType               app_indicator_get_type              (void);

Generates or returns the unique GType for AppIndicator.

app_indicator_new ()

AppIndicator *      app_indicator_new                   (const gchar *id,
                                                         const gchar *icon_name,
                                                         AppIndicatorCategory category);

Creates a new AppIndicator setting the properties: "id" with id, "category" with category and "icon-name" with icon_name.

app_indicator_new_with_path ()

AppIndicator *      app_indicator_new_with_path         (const gchar *id,
                                                         const gchar *icon_name,
                                                         AppIndicatorCategory category,
                                                         const gchar *icon_theme_path);

Creates a new AppIndicator setting the properties: "id" with id, "category" with category, "icon-name" with icon_name and "icon-theme-path" with icon_theme_path.

app_indicator_set_status ()

void                app_indicator_set_status            (AppIndicator *self,
                                                         AppIndicatorStatus status);

Wrapper function for property "status".

app_indicator_set_attention_icon ()

void                app_indicator_set_attention_icon    (AppIndicator *self,
                                                         const gchar *icon_name);

Wrapper function for property "attention-icon-name".

app_indicator_set_menu ()

void                app_indicator_set_menu              (AppIndicator *self,
                                                         GtkMenu *menu);

Sets the menu that should be shown when the Application Indicator is clicked on in the panel. An application indicator will not be rendered unless it has a menu. Wrapper function for property "menu".

app_indicator_set_icon ()

void                app_indicator_set_icon              (AppIndicator *self,
                                                         const gchar *icon_name);

Sets the default icon to use when the status is active but not set to attention. In most cases, this should be the application icon for the program. Wrapper function for property "icon-name".

app_indicator_set_icon_theme_path ()

void                app_indicator_set_icon_theme_path   (AppIndicator *self,
                                                         const gchar *icon_theme_path);

Sets the path to use when searching for icons.

app_indicator_set_label ()

void                app_indicator_set_label             (AppIndicator *self,
                                                         const gchar *label,
                                                         const gchar *guide);

This is a wrapper function for the "label" and "guide" properties. This function can take NULL as either label or guide and will clear the entries.

app_indicator_set_ordering_index ()

void                app_indicator_set_ordering_index    (AppIndicator *self,
                                                         guint32 ordering_index);

Sets the ordering index for the app indicator which effects the placement of it on the panel. For almost all app indicator this is not the function you're looking for.

Wrapper function for property "ordering-index".

app_indicator_get_id ()

const gchar *       app_indicator_get_id                (AppIndicator *self);

Wrapper function for property "id".

app_indicator_get_category ()

AppIndicatorCategory  app_indicator_get_category        (AppIndicator *self);

Wrapper function for property "category".

app_indicator_get_status ()

AppIndicatorStatus  app_indicator_get_status            (AppIndicator *self);

Wrapper function for property "status".

app_indicator_get_icon ()

const gchar *       app_indicator_get_icon              (AppIndicator *self);

Wrapper function for property "icon-name".

app_indicator_get_icon_theme_path ()

const gchar *       app_indicator_get_icon_theme_path   (AppIndicator *self);

Wrapper function for property "icon-theme-path".

app_indicator_get_attention_icon ()

const gchar *       app_indicator_get_attention_icon    (AppIndicator *self);

Wrapper function for property "attention-icon-name".

app_indicator_get_menu ()

GtkMenu *           app_indicator_get_menu              (AppIndicator *self);

Gets the menu being used for this application indicator. Wrapper function for property "menu".

app_indicator_get_label ()

const gchar *       app_indicator_get_label             (AppIndicator *self);

Wrapper function for property "label".

app_indicator_get_label_guide ()

const gchar *       app_indicator_get_label_guide       (AppIndicator *self);

Wrapper function for property "label-guide".

app_indicator_get_ordering_index ()

guint32             app_indicator_get_ordering_index    (AppIndicator *self);

Wrapper function for property "ordering-index".

The "attention-icon-name" property

  "attention-icon-name"      gchar*                : Read / Write

If the indicator sets it's status to APP_INDICATOR_STATUS_ATTENTION then this icon is shown.

Default value: NULL

The "category" property

  "category"                 gchar*                : Read / Write / Construct Only

The type of indicator that this represents. Please don't use 'Other'. Defaults to 'ApplicationStatus'.

Default value: NULL

The "connected" property

  "connected"                gboolean              : Read

Pretty simple, TRUE if we have a reasonable expectation of being displayed through this object. You should hide your TrayIcon if so.

Default value: FALSE

The "icon-name" property

  "icon-name"                gchar*                : Read / Write / Construct

The name of the regular icon that is shown for the indicator.

Default value: NULL

The "icon-theme-path" property

  "icon-theme-path"          gchar*                : Read / Write / Construct

An additional place to look for icon names that may be installed by the application.

Default value: NULL

The "id" property

  "id"                       gchar*                : Read / Write / Construct Only

The ID for this indicator, which should be unique, but used consistently by this program and its indicator.

Default value: NULL

The "label" property

  "label"                    gchar*                : Read / Write

A label that can be shown next to the string in the application indicator. The label will not be shown unless there is an icon as well. The label is useful for numerical and other frequently updated information. In general, it shouldn't be shown unless a user requests it as it can take up a significant amount of space on the user's panel. This may not be shown in all visualizations.

Default value: NULL

The "label-guide" property

  "label-guide"              gchar*                : Read / Write

An optional string to provide guidance to the panel on how big the "label" string could get. If this is set correctly then the panel should never 'jiggle' as the string adjusts through out the range of options. For instance, if you were providing a percentage like "54% thrust" in "label" you'd want to set this string to "100% thrust" to ensure space when Scotty can get you enough power.

Default value: NULL

The "menu" property

  "menu"                     DBusGObjectPath*      : Read

A method for getting the menu path as a string for DBus.

The "ordering-index" property

  "ordering-index"           guint                 : Read / Write

The ordering index is an odd parameter, and if you think you don't need it you're probably right. In general, the application indicator try to place the applications in a recreatable place taking into account which category they're in to try and group them. But, there are some cases where you'd want to ensure indicators are next to each other. To do that you can override the generated ordering index and replace it with a new one. Again, you probably don't want to be doing this, but in case you do, this is the way.

Default value: 0

The "status" property

  "status"                   gchar*                : Read / Write

Whether the indicator is shown or requests attention. Defaults to 'Passive'.

Default value: NULL

The "x-ayatana-label" property

  "x-ayatana-label"          gchar*                : Read / Write

Wrapper for "label". Please use that in all of your code.

Default value: NULL

The "x-ayatana-label-guide" property

  "x-ayatana-label-guide"    gchar*                : Read / Write

Wrapper for "label-guide". Please use that in all of your code.

Default value: NULL

The "x-ayatana-ordering-index" property

  "x-ayatana-ordering-index" guint                 : Read / Write

A wrapper for "ordering-index" so that it can match the dbus interface currently. It will hopefully be retired, please don't use it anywhere.

Default value: 0

The "connection-changed" signal

void                user_function                      (AppIndicator *arg0,
                                                        gboolean      arg1,
                                                        gpointer      user_data)      : Run Last

Signaled when we connect to a watcher, or when it drops away.

The "new-attention-icon" signal

void                user_function                      (AppIndicator *arg0,
                                                        gpointer      user_data)      : Run Last

Emitted when "attention-icon-name" is changed

The "new-icon" signal

void                user_function                      (AppIndicator *arg0,
                                                        gpointer      user_data)      : Run Last

Emitted when "icon-name" is changed

The "new-icon-theme-path" signal

void                user_function                      (AppIndicator *arg0,
                                                        gchar        *arg1,
                                                        gpointer      user_data)      : Run Last

Signaled when there is a new icon set for the object.

The "new-label" signal

void                user_function                      (AppIndicator *arg0,
                                                        gchar        *arg1,
                                                        gchar        *arg1,
                                                        gpointer      user_data)      : Run Last

Emitted when either "label" or "label-guide" are changed.

The "new-status" signal

void                user_function                      (AppIndicator *arg0,
                                                        gchar        *arg1,
                                                        gpointer      user_data)      : Run Last

Emitted when "status" is changed

The "x-ayatana-new-label" signal

void                user_function                      (AppIndicator *arg0,
                                                        gchar        *arg1,
                                                        gchar        *arg1,
                                                        gpointer      user_data)      : Run Last

Wrapper for "new-label", please don't use this signal use the other one.