ag-application: libaccounts-glib Reference Manual

## ag-application ag-application — information on the client applications of libaccounts. |

## Functions

const gchar * | ag_application_get_name ()
const gchar * | ag_application_get_description ()
const gchar * | ag_application_get_i18n_domain ()
GDesktopAppInfo * | ag_application_get_desktop_app_info ()
gboolean | ag_application_supports_service ()
const gchar * | ag_application_get_service_usage ()
AgApplication * | ag_application_ref ()
void | ag_application_unref ()

## Includes

    #include <libaccounts-glib/ag-application.h>

## Description

The AgApplication structure holds information on the client applications registered with libaccounts. It is instantiated by AgManager with `ag_manager_get_application()` and `ag_manager_list_applications_by_service()`, and destroyed with `ag_application_unref()`.

Example 3. Querying application names for an AgService

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    AgManager *manager;
    GList *services, *applications;
    AgService *service;

    manager = ag_manager_new ();
    services = ag_manager_list_services (manager);
    g_assert (services != NULL);
    service = (AgService *) services->data;
    applications = ag_manager_list_applications_by_service (manager, service);

    g_print ("Service type: %s\n", ag_service_get_name (service));
    for (applications; applications != NULL; applications = applications->next)
    {
        const gchar *application_name = ag_application_get_name ((AgApplication *) applications->data);
        g_print ("  Application name: %s\n", application_name);
    }

## Functions

### ag_application_get_name ()

    const gchar *
    ag_application_get_name (AgApplication *self);

Get the name of the AgApplication.

#### Parameters

self | the AgApplication. |

#### Returns

the name of `self` .

### ag_application_get_description ()

    const gchar *
    ag_application_get_description (AgApplication *self);

Get the description of the AgApplication.

#### Parameters

self | the AgApplication. |

#### Returns

the description of `self` .

### ag_application_get_i18n_domain ()

    const gchar *
    ag_application_get_i18n_domain (AgApplication *self);

Get the translation domain of the AgApplication.

#### Parameters

self | the AgApplication. |

#### Returns

the translation domain.

### ag_application_get_desktop_app_info ()

    GDesktopAppInfo *
    ag_application_get_desktop_app_info (AgApplication *self);

Get the GDesktopAppInfo of the application.

#### Parameters

self | the AgApplication. |

#### Returns

the GDesktopAppInfo for `self` , or `NULL` if failed.

[transfer full]

### ag_application_supports_service ()

    gboolean
    ag_application_supports_service (AgApplication *self,
                                     AgService *service);

Check whether the application supports the given service.

#### Parameters

self | the AgApplication. |
service | an AgService. |

#### Returns

`TRUE` if `service` is supported, `FALSE` otherwise.

### ag_application_get_service_usage ()

    const gchar *
    ag_application_get_service_usage (AgApplication *self,
                                      AgService *service);

Get the description from the application XML file, for the specified service; if not found, get the service-type description instead.

#### Parameters

self | the AgApplication. |
service | an AgService. |

#### Returns

usage description of the service.

### ag_application_ref ()

    AgApplication *
    ag_application_ref (AgApplication *self);

Increment the reference count of `self` .

#### Parameters

self | the AgApplication. |

#### Returns

`self` .

### ag_application_unref ()

    void
    ag_application_unref (AgApplication *self);

Decrements the reference count of `self` . The item is destroyed when the count gets to 0.

#### Parameters

self | the AgApplication. |