## EmpathyProtocolChooser EmpathyProtocolChooser — A widget used to choose from a list of protocols |

## Synopsis

    #include <libempathy-gtk/empathy-protocol-chooser.h>

                        EmpathyProtocolChooser;
    gboolean            (*EmpathyProtocolChooserFilterFunc) (TpConnectionManager *cm,
                                                             TpConnectionManagerProtocol *protocol,
                                                             gpointer user_data);
    GtkWidget *         empathy_protocol_chooser_new        (void);
    TpConnectionManager * empathy_protocol_chooser_dup_selected
                                                            (EmpathyProtocolChooser *protocol_chooser,
                                                             TpConnectionManagerProtocol **protocol,
                                                             gboolean *is_gtalk);
    void                empathy_protocol_chooser_set_visible
                                                            (EmpathyProtocolChooser *protocol_chooser,
                                                             EmpathyProtocolChooserFilterFunc func,
                                                             gpointer user_data);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkComboBox
                                           +----EmpathyProtocolChooser

## Implemented Interfaces

EmpathyProtocolChooser implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.

## Description

EmpathyProtocolChooser is a widget which extends GtkComboBox to provides a chooser of available protocols.

## Details

### EmpathyProtocolChooser

    typedef struct _EmpathyProtocolChooser EmpathyProtocolChooser;

Widget which extends GtkComboBox to provide a chooser of available protocols.

### EmpathyProtocolChooserFilterFunc ()

    gboolean            (*EmpathyProtocolChooserFilterFunc) (TpConnectionManager *cm,
                                                             TpConnectionManagerProtocol *protocol,
                                                             gpointer user_data);

`cm` : |
`protocol` : |
`user_data` : |
Returns : |

### empathy_protocol_chooser_new ()

    GtkWidget *         empathy_protocol_chooser_new        (void);

Triggers the creation of a new EmpathyProtocolChooser.

Returns : | a new EmpathyProtocolChooser widget

### empathy_protocol_chooser_dup_selected ()

    TpConnectionManager * empathy_protocol_chooser_dup_selected
                                                            (EmpathyProtocolChooser *protocol_chooser,
                                                             TpConnectionManagerProtocol **protocol,
                                                             gboolean *is_gtalk);

`protocol_chooser` : |
`protocol` : |
`is_gtalk` : |
Returns : |

### empathy_protocol_chooser_set_visible ()

    void                empathy_protocol_chooser_set_visible
                                                            (EmpathyProtocolChooser *protocol_chooser,
                                                             EmpathyProtocolChooserFilterFunc func,
                                                             gpointer user_data);

`protocol_chooser` : |
`func` : |
`user_data` : |