EProxySelector

EProxySelector — Select and manage proxy profiles

Functions

Types and Values

Includes

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

Description

EProxySelector displays a list of available proxy profiles, with inline toolbar controls for adding and removing profiles.

Functions

e_proxy_selector_new ()

GtkWidget *
e_proxy_selector_new (ESourceRegistry *registry);

e_proxy_selector_new is deprecated and should not be used in newly-written code.

Creates a new EProxySelector widget using ESource instances in registry .

Parameters

registry

an ESourceRegistry

 

Returns

a new EProxySelector


e_proxy_selector_refresh ()

void
e_proxy_selector_refresh (EProxySelector *selector);

e_proxy_selector_refresh is deprecated and should not be used in newly-written code.

Rebuilds the selector 's list store with an updated list of ESource instances that describe a network proxy profile, without disrupting the previously selected item (if possible).

This funtion is called automatically in response to ESourceRegistry signals which are pertinent to the selector .

Parameters

selector

an EProxySelector

 

e_proxy_selector_get_registry ()

ESourceRegistry *
e_proxy_selector_get_registry (EProxySelector *selector);

e_proxy_selector_get_registry is deprecated and should not be used in newly-written code.

Returns the ESourceRegistry passed to e_proxy_selector_get_registry().

Parameters

selector

an EProxySelector

 

Returns

an ESourceRegistry


e_proxy_selector_ref_selected ()

ESource *
e_proxy_selector_ref_selected (EProxySelector *selector);

e_proxy_selector_ref_selected is deprecated and should not be used in newly-written code.

Returns the selected ESource in selector .

The function tries to ensure a valid ESource is always returned, falling back to e_source_registry_ref_builtin_proxy() if necessary.

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

Parameters

selector

an EProxySelector

 

Returns

an ESource


e_proxy_selector_set_selected ()

gboolean
e_proxy_selector_set_selected (EProxySelector *selector,
                               ESource *source);

e_proxy_selector_set_selected is deprecated and should not be used in newly-written code.

Finds the corresponding tree model row for source , selects the row, and returns TRUE. If no corresponding tree model row for source is found, the selection remains unchanged and the function returns FALSE.

Parameters

selector

an EProxySelector

 

source

an ESource, or NULL for the built-in proxy profile

 

Returns

whether source was selected

Types and Values

struct EProxySelector

struct EProxySelector {
	ETreeViewFrame parent;
	EProxySelectorPrivate *priv;
};

EProxySelector is deprecated and should not be used in newly-written code.

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