## ENameSelector ENameSelector |

## Synopsis

    struct              ENameSelector;
    ENameSelector *     e_name_selector_new                 (EClientCache *client_cache);
    EClientCache *      e_name_selector_ref_client_cache    (ENameSelector *name_selector);
    ENameSelectorModel * e_name_selector_peek_model         (ENameSelector *name_selector);
    ENameSelectorDialog * e_name_selector_peek_dialog       (ENameSelector *name_selector);
    ENameSelectorEntry * e_name_selector_peek_section_entry (ENameSelector *name_selector,
                                                             const gchar *name);
    ENameSelectorList * e_name_selector_peek_section_list   (ENameSelector *name_selector,
                                                             const gchar *name);
    void                e_name_selector_show_dialog         (ENameSelector *name_selector,
                                                             GtkWidget *for_transient_widget);
    void                e_name_selector_load_books          (ENameSelector *name_selector);
    void                e_name_selector_cancel_loading      (ENameSelector *name_selector);

## Object Hierarchy

      GObject
       +----ENameSelector

## Properties

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

## Description

## Details

### struct ENameSelector

    struct ENameSelector;

### e_name_selector_new ()

    ENameSelector *     e_name_selector_new                 (EClientCache *client_cache);

Creates a new ENameSelector.

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

### e_name_selector_ref_client_cache ()

    EClientCache *      e_name_selector_ref_client_cache    (ENameSelector *name_selector);

Returns the EClientCache passed to `e_name_selector_new()`.

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

`name_selector` : | an ENameSelector
Returns : | an EClientCache

Since 3.8

### e_name_selector_peek_model ()

    ENameSelectorModel * e_name_selector_peek_model         (ENameSelector *name_selector);

Gets the ENameSelectorModel used by `name_selector`.

`name_selector` : | an ENameSelector
Returns : | The ENameSelectorModel used by `name_selector`.

### e_name_selector_peek_dialog ()

    ENameSelectorDialog * e_name_selector_peek_dialog       (ENameSelector *name_selector);

Gets the ENameSelectorDialog used by `name_selector`.

`name_selector` : | an ENameSelector
Returns : | The ENameSelectorDialog used by `name_selector`.

### e_name_selector_peek_section_entry ()

    ENameSelectorEntry * e_name_selector_peek_section_entry (ENameSelector *name_selector,
                                                             const gchar *name);

Gets the ENameSelectorEntry for the section specified by `name`.

`name_selector` : | an ENameSelector
`name` : | the name of the section to peek
Returns : | The ENameSelectorEntry for the named section, or `NULL` if it doesn't exist in the ENameSelectorModel.

### e_name_selector_peek_section_list ()

    ENameSelectorList * e_name_selector_peek_section_list   (ENameSelector *name_selector,
                                                             const gchar *name);

Gets the ENameSelectorList for the section specified by `name`.

`name_selector` : | an ENameSelector
`name` : | the name of the section to peek
Returns : | The ENameSelectorList for the named section, or `NULL` if it doesn't exist in the ENameSelectorModel.

### e_name_selector_show_dialog ()

    void                e_name_selector_show_dialog         (ENameSelector *name_selector,
                                                             GtkWidget *for_transient_widget);

Shows the associated dialog, and sets the transient parent to the GtkWindow top-level of "for_transient_widget if set (it should be)

`name_selector` : | an ENameSelector
`for_transient_widget` : | a widget parent or `NULL`

Since 2.32

### e_name_selector_load_books ()

    void                e_name_selector_load_books          (ENameSelector *name_selector);

Loads address books available for the `name_selector`. This can be called only once and it can be cancelled by `e_name_selector_cancel_loading()`.

`name_selector` : | an ENameSelector

Since 3.2

### e_name_selector_cancel_loading ()

    void                e_name_selector_cancel_loading      (ENameSelector *name_selector);

Cancels any pending address book load operations. This might be called before an owner unrefs this `name_selector`.

`name_selector` : | an ENameSelector

Since 3.2

## Property Details

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

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

Cache of shared EClient instances.