CtkAppChooser: CTK+ 3 Reference Manual

## CtkAppChooser CtkAppChooser — Interface implemented by widgets for choosing an application |

## Functions

GAppInfo * | ctk_app_chooser_get_app_info ()
gchar * | ctk_app_chooser_get_content_type ()
void | ctk_app_chooser_refresh ()

## Properties

char * | content-type | Read / Write / Construct Only

## Types and Values

| CtkAppChooser

## Object Hierarchy

        GInterface
        ╰── CtkAppChooser

## Prerequisites

CtkAppChooser requires CtkWidget.

## Known Implementations

CtkAppChooser is implemented by CtkAppChooserButton, CtkAppChooserDialog and CtkAppChooserWidget.

## Includes

    #include <ctk/ctk.h>

## Description

CtkAppChooser is an interface that can be implemented by widgets which allow the user to choose an application (typically for the purpose of opening a file). The main objects that implement this interface are CtkAppChooserWidget, CtkAppChooserDialog and CtkAppChooserButton.

Applications are represented by GIO GAppInfo objects here. GIO has a concept of recommended and fallback applications for a given content type. Recommended applications are those that claim to handle the content type itself, while fallback also includes applications that handle a more generic content type. GIO also knows the default and last-used application for a given content type. The CtkAppChooserWidget provides detailed control over whether the shown list of applications should include default, recommended or fallback applications.

To obtain the application that has been selected in a CtkAppChooser, use `ctk_app_chooser_get_app_info()`.

## Functions

### ctk_app_chooser_get_app_info ()

    GAppInfo *
    ctk_app_chooser_get_app_info (CtkAppChooser *self);

Returns the currently selected application.

#### Parameters

self | a CtkAppChooser |

#### Returns

a GAppInfo for the currently selected application, or `NULL` if none is selected. Free with `g_object_unref()`.

[nullable][transfer full]

Since: 3.0

### ctk_app_chooser_get_content_type ()

    gchar *
    ctk_app_chooser_get_content_type (CtkAppChooser *self);

Returns the current value of the “content-type” property.

#### Parameters

self | a CtkAppChooser |

#### Returns

the content type of `self` . Free with `g_free()`

Since: 3.0

### ctk_app_chooser_refresh ()

    void
    ctk_app_chooser_refresh (CtkAppChooser *self);

Reloads the list of applications.

#### Parameters

self | a CtkAppChooser |

Since: 3.0

## Types and Values

### CtkAppChooser

    typedef struct _CtkAppChooser CtkAppChooser;

## Property Details

### The `“content-type”` property

      “content-type”             char *

The content type of the CtkAppChooser object.

See GContentType for more information about content types.

Owner: CtkAppChooser

Flags: Read / Write / Construct Only

Default value: NULL

## See Also

GAppInfo