## GFilenameCompleter

GFilenameCompleter — Filename Completer

## Synopsis

    #include <gio/gio.h>

                        GFilenameCompleter;
    GFilenameCompleter * g_filename_completer_new           (void);
    char *              g_filename_completer_get_completion_suffix
                                                            (GFilenameCompleter *completer,
                                                             const char *initial_text);
    char **             g_filename_completer_get_completions
                                                            (GFilenameCompleter *completer,
                                                             const char *initial_text);
    void                g_filename_completer_set_dirs_only  (GFilenameCompleter *completer,
                                                             gboolean dirs_only);

## Object Hierarchy

      GObject
       +----GFilenameCompleter

## Signals

      "got-completion-data"                            : Run Last

## Description

Completes partial file and directory names given a partial string by looking in the file system for clues. Can return a list of possible completion strings for widget implementations.

## Details

### GFilenameCompleter

    typedef struct _GFilenameCompleter GFilenameCompleter;

Completes filenames based on files that exist within the file system.

### g_filename_completer_new ()

    GFilenameCompleter * g_filename_completer_new           (void);

Creates a new filename completer.

Returns : | a GFilenameCompleter.

### g_filename_completer_get_completion_suffix ()

    char *              g_filename_completer_get_completion_suffix
                                                            (GFilenameCompleter *completer,
                                                             const char *initial_text);

Obtains a completion for `initial_text` from `completer`.

`completer` : | the filename completer.
`initial_text` : | text to be completed.
Returns : | a completed string, or `NULL` if no completion exists. This string is not owned by GIO, so remember to `g_free()` it when finished.

### g_filename_completer_get_completions ()

    char **             g_filename_completer_get_completions
                                                            (GFilenameCompleter *completer,
                                                             const char *initial_text);

Gets an array of completion strings for a given initial text.

`completer` : | the filename completer.
`initial_text` : | text to be completed.
Returns : | array of strings with possible completions for `initial_text`. This array must be freed by `g_strfreev()` when finished. [array zero-terminated=1][transfer full]

### g_filename_completer_set_dirs_only ()

    void                g_filename_completer_set_dirs_only  (GFilenameCompleter *completer,
                                                             gboolean dirs_only);

If `dirs_only` is `TRUE`, `completer` will only complete directory names, and not file names.

`completer` : | the filename completer.
`dirs_only` : | a gboolean.

## Signal Details

### The `"got-completion-data"` signal

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

Emitted when the file name completion information comes available.

`user_data` : | user data set when the signal handler was connected.