![]() |
![]() |
![]() |
Evolution Utilities Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
#include <e-util/e-util.h> struct EProxySelector; GtkWidget * e_proxy_selector_new (ESourceRegistry *registry
); void e_proxy_selector_refresh (EProxySelector *selector
); ESourceRegistry * e_proxy_selector_get_registry (EProxySelector *selector
); ESource * e_proxy_selector_ref_selected (EProxySelector *selector
); gboolean e_proxy_selector_set_selected (EProxySelector *selector
,ESource *source
);
GObject +----GInitiallyUnowned +----GtkWidget +----GtkContainer +----GtkBox +----ETreeViewFrame +----EProxySelector
EProxySelector implements AtkImplementorIface, GtkBuildable, GtkOrientable and EExtensible.
"registry" ESourceRegistry* : Read / Write / Construct Only "selected" ESource* : Read / Write
EProxySelector displays a list of available proxy profiles, with inline toolbar controls for adding and removing profiles.
struct EProxySelector;
Contains only private data that should be read and manipulated using the functions below.
GtkWidget * e_proxy_selector_new (ESourceRegistry *registry
);
Creates a new EProxySelector widget using ESource instances in registry
.
|
an ESourceRegistry |
Returns : |
a new EProxySelector |
void e_proxy_selector_refresh (EProxySelector *selector
);
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
.
|
an EProxySelector |
ESourceRegistry * e_proxy_selector_get_registry (EProxySelector *selector
);
Returns the ESourceRegistry passed to e_proxy_selector_get_registry()
.
|
an EProxySelector |
Returns : |
an ESourceRegistry |
ESource * e_proxy_selector_ref_selected (EProxySelector *selector
);
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.
|
an EProxySelector |
Returns : |
an ESource |
gboolean e_proxy_selector_set_selected (EProxySelector *selector
,ESource *source
);
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
.
|
an EProxySelector |
|
an ESource, or NULL for the built-in proxy profile |
Returns : |
whether source was selected |