## ENameSelector

ENameSelector

## Synopsis

    struct              ENameSelector;
    ENameSelector *     e_name_selector_new                 (ESourceRegistry *registry);
    ESourceRegistry *   e_name_selector_get_registry        (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

      "registry"                 ESourceRegistry*      : Read / Write / Construct Only

## Description

## Details

### struct ENameSelector

    struct ENameSelector;

### e_name_selector_new ()

    ENameSelector *     e_name_selector_new                 (ESourceRegistry *registry);

Creates a new ENameSelector.

`registry` : | an ESourceRegistry
Returns : | A new ENameSelector.

### e_name_selector_get_registry ()

    ESourceRegistry *   e_name_selector_get_registry        (ENameSelector *name_selector);

Returns the ESourceRegistry passed to `e_name_selector_new()`.

`name_selector` : | an ENameSelector
Returns : | the ESourceRegistry

Since 3.6

### 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 `"registry"` property

      "registry"                 ESourceRegistry*      : Read / Write / Construct Only

Data source registry.