UnicapgtkDeviceSelection

UnicapgtkDeviceSelection —

Synopsis




            UnicapgtkDeviceSelection;
GtkWidget*  unicapgtk_device_selection_new  (gboolean include_rescan_entry);
gint        unicapgtk_device_selection_rescan
                                            (UnicapgtkDeviceSelection *combo);
gboolean    unicapgtk_device_selection_set_device
                                            (UnicapgtkDeviceSelection *combo,
                                             unicap_device_t *device);
void        unicapgtk_device_selection_set_label_fmt
                                            (UnicapgtkDeviceSelection *combo,
                                             const gchar *fmt);

Object Hierarchy


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

Implemented Interfaces

UnicapgtkDeviceSelection implements AtkImplementorIface, GtkCellLayout and GtkCellEditable.

Properties


  "include-rescan-entry" gboolean              : Read / Write / Construct Only

Signals


"unicapgtk-device-selection-changed"
            void        user_function      (UnicapgtkDeviceSelection *unicapgtkdeviceselection,
                                            gpointer                  arg1,
                                            gpointer                  user_data)                     : Run first / Action

Description

Details

UnicapgtkDeviceSelection

typedef struct _UnicapgtkDeviceSelection UnicapgtkDeviceSelection;


unicapgtk_device_selection_new ()

GtkWidget*  unicapgtk_device_selection_new  (gboolean include_rescan_entry);

Creates a new UnicapgtkDeviceSelection

include_rescan_entry : if TRUE, the an entry will get added to the combo box allowing the user to manually trigger a device rescan
Returns : a new UnicapgtkDeviceSelection

unicapgtk_device_selection_rescan ()

gint        unicapgtk_device_selection_rescan
                                            (UnicapgtkDeviceSelection *combo);

Tiggers rescan of available video capture devices and updates the combo box.

combo : an UnicapgtkDeviceSelection
Returns : number of available devices

unicapgtk_device_selection_set_device ()

gboolean    unicapgtk_device_selection_set_device
                                            (UnicapgtkDeviceSelection *combo,
                                             unicap_device_t *device);

Sets the combo box to the given device.

combo : a UnicapgtkDeviceSelection
device : a unicap_device_t
Returns : TRUE on success

unicapgtk_device_selection_set_label_fmt ()

void        unicapgtk_device_selection_set_label_fmt
                                            (UnicapgtkDeviceSelection *combo,
                                             const gchar *fmt);

Sets the format string for the device labels. The following special sequences are currently supported:

%i: Identifier

%v: Vendor Name

%m: Model Name

%s: Model Id, hexadecimal with lowercase letters

%S: Model Id, hexadecimal with uppercase letters

%p: Vendor Id, hexadecimal with lowercase letters

%P: Vendor Id, hexadecimal with uppercase letters

combo : a UnicapgtkDeviceSelection
fmt : a format string

Property Details

The "include-rescan-entry" property

  "include-rescan-entry" gboolean              : Read / Write / Construct Only

Default value: FALSE

Signal Details

The "unicapgtk-device-selection-changed" signal

void        user_function                  (UnicapgtkDeviceSelection *unicapgtkdeviceselection,
                                            gpointer                  arg1,
                                            gpointer                  user_data)                     : Run first / Action

unicapgtkdeviceselection : the object which received the signal.
arg1 :
user_data : user data set when the signal handler was connected.