|  |  |  | Spice-GTK Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
#include <usb-device-widget.h> struct SpiceUsbDeviceWidget; struct SpiceUsbDeviceWidgetClass; GtkWidget * spice_usb_device_widget_new (SpiceSession *session,const gchar *device_format_string);
GObject +----GInitiallyUnowned +----GtkWidget +----GtkContainer +----GtkBox +----SpiceUsbDeviceWidget
SpiceUsbDeviceWidget implements AtkImplementorIface, GtkBuildable and GtkOrientable.
"device-format-string" gchar* : Read / Write / Construct Only "session" SpiceSession* : Read / Write / Construct Only
SpiceUsbDeviceWidget is a gtk widget which apps can use to easily add an UI to select USB devices to redirect (or unredirect).
struct SpiceUsbDeviceWidget;
The SpiceUsbDeviceWidget struct is opaque and should not be accessed directly.
struct SpiceUsbDeviceWidgetClass {
    GtkVBoxClass parent_class;
    /* signals */
    void (*connect_failed) (SpiceUsbDeviceWidget *widget,
                            SpiceUsbDevice *device, GError *error);
};
Class structure for SpiceUsbDeviceWidget.
| Signal class handler for the "connect-failed" signal. | 
GtkWidget * spice_usb_device_widget_new (SpiceSession *session,const gchar *device_format_string);
| 
 | SpiceSession for which to widget will control USB redirection | 
| 
 | String passed to spice_usb_device_get_description(). [allow-none] | 
| Returns : | a new SpiceUsbDeviceWidget instance | 
"device-format-string" property"device-format-string" gchar* : Read / Write / Construct Only
Format string to pass to spice_usb_device_get_description() for getting
the device USB descriptions.
Default value: NULL
"session" property"session" SpiceSession* : Read / Write / Construct Only
SpiceSession this SpiceUsbDeviceWidget is associated with
"connect-failed" signalvoid                user_function                      (SpiceUsbDeviceWidget *widget,
                                                        SpiceUsbDevice       *device,
                                                        GError               *error,
                                                        gpointer              user_data)      : Run First
The "connect-failed" signal is emitted whenever the user has requested for a device to be redirected and this has failed.
| 
 | The SpiceUsbDeviceWidget that emitted the signal | 
| 
 | SpiceUsbDevice boxed object corresponding to the added device | 
| 
 | GError describing the reason why the connect failed | 
| 
 | user data set when the signal handler was connected. |