## EProxyLinkSelector

EProxyLinkSelector — Link accounts to a proxy profile

## Synopsis

    #include <e-util/e-util.h>

    struct              EProxyLinkSelector;
    GtkWidget *         e_proxy_link_selector_new           (ESourceRegistry *registry);
    ESource *           e_proxy_link_selector_ref_target_source
                                                            (EProxyLinkSelector *selector);
    void                e_proxy_link_selector_set_target_source
                                                            (EProxyLinkSelector *selector,
                                                             ESource *target_source);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkWidget
                   +----GtkContainer
                         +----GtkTreeView
                               +----ESourceSelector
                                     +----EProxyLinkSelector

## Implemented Interfaces

EProxyLinkSelector implements AtkImplementorIface, GtkBuildable and GtkScrollable.

## Properties

      "target-source"            ESource*              : Read / Write

## Description

EProxyLinkSelector shows all network-based accounts in a tree view, with a checkbox next to each account. The checkbox allows users to choose between linking the account to a pre-determined user-defined proxy profile, or to the built-in default proxy profile.

## Details

### struct EProxyLinkSelector

    struct EProxyLinkSelector;

Contains only private data that should be read and manipulated using the functions below.

### e_proxy_link_selector_new ()

    GtkWidget *         e_proxy_link_selector_new           (ESourceRegistry *registry);

Creates a new EProxyLinkSelector using ESource instances in `registry`.

`registry` : | an ESourceRegistry
Returns : | a new EProxyLinkSelector

### e_proxy_link_selector_ref_target_source ()

    ESource *           e_proxy_link_selector_ref_target_source
                                                            (EProxyLinkSelector *selector);

Returns the target network proxy profile ESource.

See `e_proxy_link_selector_set_target_source()` for further details.

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

`selector` : | an EProxyLinkSelector
Returns : | an ESource

### e_proxy_link_selector_set_target_source ()

    void                e_proxy_link_selector_set_target_source
                                                            (EProxyLinkSelector *selector,
                                                             ESource *target_source);

Sets the target network proxy profile ESource.

Checking the box next to an account name in `selector` will link the account to `target_source`. The account will then use `target_source` as its GProxyResolver when connecting to a remote host.

As a special case, if `target_source` refers to the built-in network proxy profile, then `selector` will hide its checkboxes since they would otherwise link accounts to the same ESource when checked or unchecked.

`selector` : | an EProxyLinkSelector
`target_source` : | an ESource

## Property Details

### The `"target-source"` property

      "target-source"            ESource*              : Read / Write

The data source to link to when the checkbox is active.