UnicapgtkDeviceProperty 3 LIBUNICAPGTK Library
UnicapgtkDeviceProperty

## Synopsis

                        UnicapgtkDeviceProperty;
    GType               unicapgtk_device_property_get_type  (void);
    GtkWidget*          unicapgtk_device_property_new       (unicap_property_t *property_spec);
    GtkWidget*          unicapgtk_device_property_new_by_handle
                                                            (unicap_handle_t handle,
                                                             unicap_property_t *property_spec);
    gboolean            unicapgtk_device_property_set       (UnicapgtkDeviceProperty *ugtk,
                                                             unicap_property_t *property);
    GtkWidget*          unicapgtk_device_property_get_label (UnicapgtkDeviceProperty *ugtk);
    void                unicapgtk_device_property_set_label (UnicapgtkDeviceProperty *ugtk,
                                                             GtkWidget *label);
    void                unicapgtk_device_property_redraw    (UnicapgtkDeviceProperty *ugtk);
    void                unicapgtk_device_property_update    (UnicapgtkDeviceProperty *ugtk);
    void                unicapgtk_device_property_redraw_sensitivity
                                                            (UnicapgtkDeviceProperty *ugtk);
    void                unicapgtk_device_property_update_sensitivity
                                                            (UnicapgtkDeviceProperty *ugtk);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkHBox
                                           +----UnicapgtkDeviceProperty

## Implemented Interfaces

UnicapgtkDeviceProperty implements AtkImplementorIface and GtkBuildable.

## Signals

      "unicapgtk-device-property-changed"              : Run First / Action

## Description

## Details

### UnicapgtkDeviceProperty

    typedef struct _UnicapgtkDeviceProperty UnicapgtkDeviceProperty;

UnicapgtkDeviceProperty

### unicapgtk_device_property_get_type ()

    GType               unicapgtk_device_property_get_type  (void);

Returns :

unicapgtk_device_property_get_type

### unicapgtk_device_property_new ()

    GtkWidget*          unicapgtk_device_property_new       (unicap_property_t *property_spec);

Creates a new UnicapgtkDeviceProperty widget.

property_spec :

  specification of the property which should be controlled by this widget. This could be acquired by unicap_enumerate_properties.

Returns :

unicapgtk_device_property_new

### unicapgtk_device_property_new_by_handle ()

    GtkWidget*          unicapgtk_device_property_new_by_handle
                                                            (unicap_handle_t handle,
                                                             unicap_property_t *property_spec);

Creates a new UnicapgtkDeviceProperty widget and sets the handle.

If a handle is set on the widget, the widget will control the device directly, ie. if the user changes a value, the widget will call unicap_set_property(...) to change the value on the device.

handle :

  unicap handle of the device

property_spec :

  specification of the property which should be controlled by this widget. This could be acquired by unicap_enumerate_properties.

Returns :

  a new UnicapgtkDeviceProperty

unicapgtk_device_property_new_by_handle

### unicapgtk_device_property_set ()

    gboolean            unicapgtk_device_property_set       (UnicapgtkDeviceProperty *ugtk,
                                                             unicap_property_t *property);

ugtk :

  a UnicapgtkDeviceProperty

property :

  the property to set. Must have the same identifier as used on creation of the widget.

Returns :

  TRUE if the change was successful

unicapgtk_device_property_set

### unicapgtk_device_property_get_label ()

    GtkWidget*          unicapgtk_device_property_get_label (UnicapgtkDeviceProperty *ugtk);

ugtk :

  a UnicapgtkDeviceProperty

Returns :

  the label widget

unicapgtk_device_property_get_label

### unicapgtk_device_property_set_label ()

    void                unicapgtk_device_property_set_label (UnicapgtkDeviceProperty *ugtk,
                                                             GtkWidget *label);

ugtk :

  a UnicapgtkDeviceProperty

label :

  the new label widget

unicapgtk_device_property_set_label

### unicapgtk_device_property_redraw ()

    void                unicapgtk_device_property_redraw    (UnicapgtkDeviceProperty *ugtk);

Updates the widgets to reflect the current property state

ugtk :

  a UnicapgtkDeviceProperty

unicapgtk_device_property_redraw

### unicapgtk_device_property_update ()

    void                unicapgtk_device_property_update    (UnicapgtkDeviceProperty *ugtk);

Reads the current property state from the device and updates the widget

ugtk :

  a UnicapgtkDeviceProperty

unicapgtk_device_property_update

### unicapgtk_device_property_redraw_sensitivity ()

    void                unicapgtk_device_property_redraw_sensitivity
                                                            (UnicapgtkDeviceProperty *ugtk);

Updates the widgets sensitivity state according to the auto/manual flags

ugtk :

  a UnicapgtkDeviceProperty

unicapgtk_device_property_redraw_sensitivity

### unicapgtk_device_property_update_sensitivity ()

    void                unicapgtk_device_property_update_sensitivity
                                                            (UnicapgtkDeviceProperty *ugtk);

Reads the current property state from the device and updates the widgets sensitivity

ugtk :

  a UnicapgtkDeviceProperty

unicapgtk_device_property_update_sensitivity

## Signal Details

### The `"unicapgtk-device-property-changed"` signal

    void                user_function                      (UnicapgtkDeviceProperty *unicapgtkdeviceproperty,
                                                            gpointer                 arg1,
                                                            gpointer                 user_data)                    : Run First / Action

unicapgtkdeviceproperty :

  the object which received the signal.

arg1 :

user_data :

  user data set when the signal handler was connected.

UnicapgtkDeviceProperty::unicapgtk-device-property-changed