## ENameSelectorEntry

ENameSelectorEntry

## Synopsis

    struct              ENameSelectorEntry;
    GtkWidget *         e_name_selector_entry_new           (EClientCache *client_cache);
    EClientCache *      e_name_selector_entry_ref_client_cache
                                                            (ENameSelectorEntry *name_selector_entry);
    void                e_name_selector_entry_set_client_cache
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             EClientCache *client_cache);
    gint                e_name_selector_entry_get_minimum_query_length
                                                            (ENameSelectorEntry *name_selector_entry);
    void                e_name_selector_entry_set_minimum_query_length
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             gint length);
    gboolean            e_name_selector_entry_get_show_address
                                                            (ENameSelectorEntry *name_selector_entry);
    void                e_name_selector_entry_set_show_address
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             gboolean show);
    EContactStore *     e_name_selector_entry_peek_contact_store
                                                            (ENameSelectorEntry *name_selector_entry);
    void                e_name_selector_entry_set_contact_store
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             EContactStore *contact_store);
    EDestinationStore * e_name_selector_entry_peek_destination_store
                                                            (ENameSelectorEntry *name_selector_entry);
    void                e_name_selector_entry_set_destination_store
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             EDestinationStore *destination_store);
    EDestination *      e_name_selector_entry_get_popup_destination
                                                            (ENameSelectorEntry *name_selector_entry);
    void                e_name_selector_entry_set_contact_editor_func
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             gpointer func);
    void                e_name_selector_entry_set_contact_list_editor_func
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             gpointer func);
    gchar *             ens_util_populate_user_query_fields (GSList *user_query_fields,
                                                             const gchar *cue_str,
                                                             const gchar *encoded_cue_str);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkWidget
                   +----GtkEntry
                         +----ENameSelectorEntry
                               +----ENameSelectorList

## Implemented Interfaces

ENameSelectorEntry implements AtkImplementorIface, GtkBuildable, GtkEditable, GtkCellEditable and EExtensible.

## Properties

      "client-cache"             EClientCache*         : Read / Write / Construct
      "minimum-query-length"     gint                  : Read / Write
      "show-address"             gboolean              : Read / Write

## Signals

      "updated"                                        : Run First

## Description

## Details

### struct ENameSelectorEntry

    struct ENameSelectorEntry;

### e_name_selector_entry_new ()

    GtkWidget *         e_name_selector_entry_new           (EClientCache *client_cache);

Creates a new ENameSelectorEntry.

`client_cache` : | an EClientCache
Returns : | A new ENameSelectorEntry.

### e_name_selector_entry_ref_client_cache ()

    EClientCache *      e_name_selector_entry_ref_client_cache
                                                            (ENameSelectorEntry *name_selector_entry);

Returns the EClientCache passed to `e_name_selector_entry_new()`.

The returned EClientCache is referenced for thread-safety and must be unreferenced with `g_object_unref()` when finished with it.

`name_selector_entry` : | an ENameSelectorEntry
Returns : | an EClientCache

Since 3.8

### e_name_selector_entry_set_client_cache ()

    void                e_name_selector_entry_set_client_cache
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             EClientCache *client_cache);

Sets the EClientCache used to query address books.

This function is intended for cases where `name_selector_entry` is instantiated by a GtkBuilder and has to be given an EClientCache after it is fully constructed.

`name_selector_entry` : | an ENameSelectorEntry
`client_cache` : | an EClientCache

Since 3.6

### e_name_selector_entry_get_minimum_query_length ()

    gint                e_name_selector_entry_get_minimum_query_length
                                                            (ENameSelectorEntry *name_selector_entry);

`name_selector_entry` : | an ENameSelectorEntry
Returns : | Minimum length of query before completion starts

Since 3.6

### e_name_selector_entry_set_minimum_query_length ()

    void                e_name_selector_entry_set_minimum_query_length
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             gint length);

Sets minimum length of query before completion starts.

`name_selector_entry` : | an ENameSelectorEntry
`length` : | minimum query length

Since 3.6

### e_name_selector_entry_get_show_address ()

    gboolean            e_name_selector_entry_get_show_address
                                                            (ENameSelectorEntry *name_selector_entry);

`name_selector_entry` : | an ENameSelectorEntry
Returns : | Whether always show email address for an auto-completed contact.

Since 3.6

### e_name_selector_entry_set_show_address ()

    void                e_name_selector_entry_set_show_address
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             gboolean show);

Sets whether always show email address for an auto-completed contact.

`name_selector_entry` : | an ENameSelectorEntry
`show` : | new value to set

Since 3.6

### e_name_selector_entry_peek_contact_store ()

    EContactStore *     e_name_selector_entry_peek_contact_store
                                                            (ENameSelectorEntry *name_selector_entry);

Gets the EContactStore being used by `name_selector_entry`.

`name_selector_entry` : | an ENameSelectorEntry
Returns : | An EContactStore.

### e_name_selector_entry_set_contact_store ()

    void                e_name_selector_entry_set_contact_store
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             EContactStore *contact_store);

Sets the EContactStore being used by `name_selector_entry` to `contact_store`.

`name_selector_entry` : | an ENameSelectorEntry
`contact_store` : | an EContactStore to use

### e_name_selector_entry_peek_destination_store ()

    EDestinationStore * e_name_selector_entry_peek_destination_store
                                                            (ENameSelectorEntry *name_selector_entry);

Gets the EDestinationStore being used to store `name_selector_entry`'s destinations.

`name_selector_entry` : | an ENameSelectorEntry
Returns : | An EDestinationStore.

### e_name_selector_entry_set_destination_store ()

    void                e_name_selector_entry_set_destination_store
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             EDestinationStore *destination_store);

Sets `destination_store` as the EDestinationStore to be used to store destinations for `name_selector_entry`.

`name_selector_entry` : | an ENameSelectorEntry
`destination_store` : | an EDestinationStore to use

### e_name_selector_entry_get_popup_destination ()

    EDestination *      e_name_selector_entry_get_popup_destination
                                                            (ENameSelectorEntry *name_selector_entry);

Since 2.32

### e_name_selector_entry_set_contact_editor_func ()

    void                e_name_selector_entry_set_contact_editor_func
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             gpointer func);

DO NOT USE.

### e_name_selector_entry_set_contact_list_editor_func ()

    void                e_name_selector_entry_set_contact_list_editor_func
                                                            (ENameSelectorEntry *name_selector_entry,
                                                             gpointer func);

DO NOT USE.

### ens_util_populate_user_query_fields ()

    gchar *             ens_util_populate_user_query_fields (GSList *user_query_fields,
                                                             const gchar *cue_str,
                                                             const gchar *encoded_cue_str);

Populates list of user query fields to string usable in query string. Returned pointer is either newly allocated string, supposed to be freed with g_free, or NULL if no fields defined.

Since 2.24

## Property Details

### The `"client-cache"` property

      "client-cache"             EClientCache*         : Read / Write / Construct

Cache of shared EClient instances.

### The `"minimum-query-length"` property

      "minimum-query-length"     gint                  : Read / Write

Allowed values: >= 1

Default value: 3

### The `"show-address"` property

      "show-address"             gboolean              : Read / Write

Default value: FALSE

## Signal Details

### The `"updated"` signal

    void                user_function                      (ENameSelectorEntry *enameselectorentry,
                                                            gpointer            arg1,
                                                            gpointer            user_data)               : Run First