4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>gimpgradientmenu</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
7
<link rel="start" href="index.html" title="GIMP Library Reference Manual">
8
<link rel="up" href="libgimpui.html" title="Part III. GIMP User Interface Library">
8
<link rel="up" href="libgimpui.html" title="Part II. GIMP User Interface Library">
9
9
<link rel="prev" href="libgimp-gimpfontmenu.html" title="gimpfontmenu">
10
10
<link rel="next" href="libgimp-gimppalettemenu.html" title="gimppalettemenu">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="gimpdefinitions.html" title="Part I. GIMP Constants">
14
<link rel="part" href="libgimp.html" title="Part II. GIMP Library">
13
<link rel="part" href="libgimp.html" title="Part I. GIMP Library">
15
14
<link rel="chapter" href="libgimp-general.html" title="Functions not Related to Specific Images">
16
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and all their Properties">
15
<link rel="chapter" href="libgimp-image.html" title="Manupulating Images and their Properties">
17
16
<link rel="chapter" href="libgimp-data.html" title="Data Objects">
18
17
<link rel="chapter" href="libgimp-selectors.html" title="Controlling the Core's Selection Dialogs">
19
<link rel="part" href="libgimpui.html" title="Part III. GIMP User Interface Library">
18
<link rel="part" href="libgimpui.html" title="Part II. GIMP User Interface Library">
20
19
<link rel="chapter" href="libgimpui-hierarchy.html" title="Object Hierarchy">
20
<link rel="index" href="libgimp-index.html" title="Index">
21
<link rel="index" href="libgimp-index-new-in-2-2.html" title="Index of new symbols in GIMP 2.2">
22
<link rel="index" href="libgimp-index-new-in-2-4.html" title="Index of new symbols in GIMP 2.4">
23
<link rel="index" href="libgimp-index-deprecated.html" title="Index of deprecated symbols">
22
25
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
23
26
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
28
31
<th width="100%" align="center">GIMP Library Reference Manual</th>
29
32
<td><a accesskey="n" href="libgimp-gimppalettemenu.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
31
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2566190" class="shortcut">Top</a>
34
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2588035" class="shortcut">Top</a>
33
<a href="#id2660182" class="shortcut">Description</a></nobr></td></tr>
36
<a href="#id2565555" class="shortcut">Description</a></nobr></td></tr>
35
38
<div class="refentry" lang="en">
36
39
<a name="libgimp-gimpgradientmenu"></a><div class="titlepage"></div>
37
40
<div class="refnamediv"><table width="100%"><tr>
40
<a name="id2566190"></a><span class="refentrytitle">gimpgradientmenu</span>
43
<a name="id2588035"></a><span class="refentrytitle">gimpgradientmenu</span>
42
45
<p>gimpgradientmenu — A widget for selecting gradients.</p>
52
GtkWidget* <a href="libgimp-gimpgradientmenu.html#gimp-gradient-select-widget-new">gimp_gradient_select_widget_new</a> (const gchar *title,
53
const gchar *gradient_name,
54
<a href="libgimp-gimpgradientselect.html#GimpRunGradientCallback">GimpRunGradientCallback</a> callback,
56
void <a href="libgimp-gimpgradientmenu.html#gimp-gradient-select-widget-close">gimp_gradient_select_widget_close</a>
58
void <a href="libgimp-gimpgradientmenu.html#gimp-gradient-select-widget-set">gimp_gradient_select_widget_set</a> (GtkWidget *widget,
59
const gchar *gradient_name);
55
GtkWidget* <a href="libgimp-gimpgradientmenu.html#gimp-gradient-select-widget-new">gimp_gradient_select_widget_new</a> (const gchar *title,
56
const gchar *gradient_name,
57
<a href="libgimp-gimpgradientselect.html#GimpRunGradientCallback">GimpRunGradientCallback</a> callback,
59
void <a href="libgimp-gimpgradientmenu.html#gimp-gradient-select-widget-close">gimp_gradient_select_widget_close</a> (GtkWidget *widget);
60
void <a href="libgimp-gimpgradientmenu.html#gimp-gradient-select-widget-set">gimp_gradient_select_widget_set</a> (GtkWidget *widget,
61
const gchar *gradient_name);
62
64
<div class="refsect1" lang="en">
63
<a name="id2660182"></a><h2>Description</h2>
65
<a name="id2565555"></a><h2>Description</h2>
65
67
A widget for selecting gradients.
68
70
<div class="refsect1" lang="en">
69
<a name="id2660197"></a><h2>Details</h2>
71
<a name="id2714611"></a><h2>Details</h2>
70
72
<div class="refsect2" lang="en">
71
<a name="id2660208"></a><h3>
73
<a name="id2714622"></a><h3>
72
74
<a name="gimp-gradient-select-widget-new"></a>gimp_gradient_select_widget_new ()</h3>
73
<a class="indexterm" name="id2660219"></a><pre class="programlisting">GtkWidget* gimp_gradient_select_widget_new (const gchar *title,
74
const gchar *gradient_name,
75
<a href="libgimp-gimpgradientselect.html#GimpRunGradientCallback">GimpRunGradientCallback</a> callback,
75
<a class="indexterm" name="id2721071"></a><a class="indexterm" name="id2721078"></a><pre class="programlisting">GtkWidget* gimp_gradient_select_widget_new (const gchar *title,
76
const gchar *gradient_name,
77
<a href="libgimp-gimpgradientselect.html#GimpRunGradientCallback">GimpRunGradientCallback</a> callback,
79
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
80
<h3 class="title">Warning</h3>
81
<p><code class="literal">gimp_gradient_select_widget_new</code> is deprecated and should not be used in newly-written code.</p>
78
84
Creates a new <span class="type">GtkWidget</span> that completely controls the selection of
79
85
a gradient. This widget is suitable for placement in a table in a
85
91
<col align="left" valign="top">
89
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
94
<td><span class="term"><em class="parameter"><code>title</code></em> :</span></td>
90
95
<td> Title of the dialog to use or <code class="literal">NULL</code> to use the default title.
95
<span class="term"><em class="parameter"><code>gradient_name</code></em> :</span></td>
96
<td> Initial gradient name or <code class="literal">NULL</code> to use current selection.
99
<td><span class="term"><em class="parameter"><code>gradient_name</code></em> :</span></td>
100
<td> Initial gradient name.
101
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
104
<td><span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
102
105
<td> A function to call when the selected gradient changes.
107
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
108
<td> A pointer to arbitary data to be used in the call to
109
<em class="parameter"><code>callback</code></em>.
109
<td><span class="term"><em class="parameter"><code>data</code></em> :</span></td>
110
<td> A pointer to arbitary data to be used in the call to <em class="parameter"><code>callback</code></em>.
114
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
114
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
115
115
<td> A <span class="type">GtkWidget</span> that you can use in your UI.
121
<p class="since">Since GIMP 2.2
122
125
<div class="refsect2" lang="en">
123
<a name="id2660382"></a><h3>
126
<a name="id2720649"></a><h3>
124
127
<a name="gimp-gradient-select-widget-close"></a>gimp_gradient_select_widget_close ()</h3>
125
<a class="indexterm" name="id2653072"></a><pre class="programlisting">void gimp_gradient_select_widget_close
126
(GtkWidget *widget);</pre>
128
<a class="indexterm" name="id2720662"></a><pre class="programlisting">void gimp_gradient_select_widget_close (GtkWidget *widget);</pre>
129
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
130
<h3 class="title">Warning</h3>
131
<p><code class="literal">gimp_gradient_select_widget_close</code> is deprecated and should not be used in newly-written code.</p>
128
134
Closes the popup window associated with <em class="parameter"><code>widget</code></em>.</p>
143
148
<div class="refsect2" lang="en">
144
<a name="id2653127"></a><h3>
149
<a name="id2720729"></a><h3>
145
150
<a name="gimp-gradient-select-widget-set"></a>gimp_gradient_select_widget_set ()</h3>
146
<a class="indexterm" name="id2653138"></a><pre class="programlisting">void gimp_gradient_select_widget_set (GtkWidget *widget,
147
const gchar *gradient_name);</pre>
151
<a class="indexterm" name="id2720743"></a><pre class="programlisting">void gimp_gradient_select_widget_set (GtkWidget *widget,
152
const gchar *gradient_name);</pre>
153
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
154
<h3 class="title">Warning</h3>
155
<p><code class="literal">gimp_gradient_select_widget_set</code> is deprecated and should not be used in newly-written code.</p>
149
Sets the current gradient for the gradient select widget. Calls
150
the callback function if one was supplied in the call to
158
Sets the current gradient for the gradient select widget. Calls the
159
callback function if one was supplied in the call to
151
160
<a href="libgimp-gimpgradientmenu.html#gimp-gradient-select-widget-new"><code class="function">gimp_gradient_select_widget_new()</code></a>.</p>
156
165
<col align="left" valign="top">
160
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
168
<td><span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
161
169
<td> A gradient select widget.
166
<span class="term"><em class="parameter"><code>gradient_name</code></em> :</span></td>
173
<td><span class="term"><em class="parameter"><code>gradient_name</code></em> :</span></td>
167
174
<td> Gradient name to set.