![]() |
![]() |
![]() |
V_Sim API - Reference Manual | ![]() |
---|---|---|---|---|
StippleComboBox; GtkWidget* stippleComboBox_new (); void stippleComboBoxAdd_pattern (StippleComboBox *stippleComboBox, guint16 stipple); guint16 stippleComboBoxGet_selectedStipple (StippleComboBox *stippleComboBox); GdkPixbuf* stippleComboBoxGet_pixbufFromStipple (StippleComboBox *stippleComboBox, guint16 stipple); gboolean stippleComboBoxSet_selectionByStipple (StippleComboBox *stippleComboBox, guint16 stipple); GdkPixbuf* stippleComboBoxBuild_stippleStamp (guint16 stipple);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkComboBox +----StippleComboBox
StippleComboBox implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.
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.
typedef struct _StippleComboBox StippleComboBox;
Private structure to store informations of a StippleComboBox object.
Since 3.4
GtkWidget* stippleComboBox_new ();
A StippleComboBox widget is like a GtkComboBox widget, but it is already filled with predefined line patterns (call stipple). Using this widget is a convienient way to share stipples between all part of V_Sim and to give a consistent look of all stipple selection.
Returns : |
a newly created StippleComboBox widget. |
Since 3.4
void stippleComboBoxAdd_pattern (StippleComboBox *stippleComboBox, guint16 stipple);
Create an entry in the ComboBox for the given stipple
pattern if
it does not already exist.
|
a StippleComboBox widget ; |
|
a pattern value. |
Since 3.4
guint16 stippleComboBoxGet_selectedStipple (StippleComboBox *stippleComboBox);
The user can access to the selected Stipple object using this method.
|
a StippleComboBox widget. |
Returns : |
a pattern value (or 65535). |
Since 3.4
GdkPixbuf* stippleComboBoxGet_pixbufFromStipple (StippleComboBox *stippleComboBox, guint16 stipple);
The stippleComboBox
has little pixbufs to represent the stipple. User methods can
use these pixbufs but should considered them read-only.
|
a StippleComboBox widget ; |
|
a pattern value. |
Returns : |
a pixbuf pointer corresponding to the little image shown on
the stippleComboBox .
|
Since 3.4
gboolean stippleComboBoxSet_selectionByStipple (StippleComboBox *stippleComboBox, guint16 stipple);
Use this method to set the ComboBox on the given stipple. This emits a 'stipple-channel' signal if the stipple is changed, which means, a previous stipple has been modified, or a new stipple is selected.
|
a StippleComboBox widget ; |
|
a pattern value. |
Returns : |
TRUE if the stipple already exists in the model.
|
Since 3.4
"stipple-selected"
signalvoid user_function (StippleComboBox *combo, guint stipple, gpointer user_data) : Run First / Action
This signal is emitted when a new valid line pattern is selected.
|
the StippleComboBox that emits the signal ; |
|
the value of the newly selected line patter. |
|
user data set when the signal handler was connected. |
Since 3.4