## LineObject

LineObject — Defines a specialised GtkHBox to choose all characteristic of lines.

## Synopsis

                        LineObject;
    GtkWidget*          lineObjectNew                       (const gchar *label);
    void                lineObjectSet_color                 (LineObject *line,
                                                             float rgb[3]);
    void                lineObjectSet_stipple               (LineObject *line,
                                                             guint16 stipple);
    void                lineObjectSet_use                   (LineObject *line,
                                                             gboolean status);
    void                lineObjectSet_width                 (LineObject *line,
                                                             gint width);

## Description

This widget looks like a GtkComboBox and it displays a list of preset patterns for line. These patterns are defined by a guint16 value that is given to OpenGL for line stipple.

This widget can emit a "stipple-selected" signal that is a wrapper around the "changed" signal, but it is emitted only when a stipple is selected and this stipple is passed to the call back.

## Details

### LineObject

    typedef struct _LineObject LineObject;

Private structure to store informations of a LineObject object.

Since 3.4

### lineObjectNew ()

    GtkWidget*          lineObjectNew                       (const gchar *label);

A LineObject widget is a widget allowing to choose the properties of a line. These properties are the line stipple pattern, its colour and its width. The colour is available through GtkRange and with a ColorComboBox widget. There is also a checkbox allowing to turn the line on or off.

`label` : | the name of the group, output in bold.
Returns : | a newly created LineObject widget.

Since 3.4

### lineObjectSet_color ()

    void                lineObjectSet_color                 (LineObject *line,
                                                             float rgb[3]);

The line can is drawn in a given colour. Change the interface values using this routine. The colour ranges are updated and if it correspond to a registered colour, it is selected in the combobox.

`line` : | the object to modify ;
`rgb` : | a RGB array.

### lineObjectSet_stipple ()

    void                lineObjectSet_stipple               (LineObject *line,
                                                             guint16 stipple);

The line can be drawn with a given stipple pattern, call this routine to change the interface value.

`line` : | the object to modify ;
`stipple` : | a value.

### lineObjectSet_use ()

    void                lineObjectSet_use                   (LineObject *line,
                                                             gboolean status);

The line can be turn on or off, call this routine to change the interface status.

`line` : | the object to modify ;
`status` : | a boolean.

### lineObjectSet_width ()

    void                lineObjectSet_width                 (LineObject *line,
                                                             gint width);

The line can be drawn with a given width, call this routine to change the interface value.

`line` : | the object to modify ;
`width` : | a value.

## See Also

ColorComboBox and StippleComboBox