~ubuntu-branches/debian/jessie/glib2.0/jessie

If no such action exists, returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

147

If no such action exists, returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

148

149

<a name="id-1.4.22.5.10.2.6"></a><h4>Parameters</h4>

150

169

</div>

170

171

<a name="id-1.4.22.5.10.2.7"></a><h4>Returns</h4>

172

a <a class="link" href="GAction.html" title="GAction">GAction</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

172

a <a class="link" href="GAction.html" title="GAction">GAction</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

173

[<acronym title="Don't free data after the code is done.">transfer none</acronym>]

174

</div>

175

Since 2.32

180

<pre class="programlisting">void

181

g_action_map_add_action_entries (<code><a class="link" href="GActionMap.html" title="GActionMap">GActionMap</a> *action_map</code>,

182

<code>const <a class="link" href="GActionMap.html#GActionEntry" title="struct GActionEntry">GActionEntry</a> *entries</code>,

183

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> n_entries</code>,

184

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

183

<code><a href="../glib/glib-Basic-Types.html#gint">gint</a> n_entries</code>,

184

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

185

A convenience function for creating multiple <a class="link" href="GSimpleAction.html" title="GSimpleAction">GSimpleAction</a> instances

186

and adding them to a <a class="link" href="GActionMap.html" title="GActionMap">GActionMap</a>.

187

Each action is constructed as per one <a class="link" href="GActionMap.html#GActionEntry" title="struct GActionEntry">GActionEntry</a>.

219

220

221

30</pre></td>

222

<td class="listing_code"><pre class="programlisting">static void

223

activate_quit (GSimpleAction *simple,

224

GVariant *parameter,

225

gpointer user_data)

226

{

227

exit (0);

228

}

229

230

static void

231

activate_print_string (GSimpleAction *simple,

232

GVariant *parameter,

233

gpointer user_data)

234

{

235

<a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a> ("%s\n", <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-get-string">g_variant_get_string</a> (parameter, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>));

236

}

237

238

static <a href="GActionGroup.html">GActionGroup</a> *

239

create_action_group (void)

240

{

241

const GActionEntry entries[] = {

242

{ "quit", activate_quit },

243

{ "print-string", activate_print_string, "s" }

244

};

245

GSimpleActionGroup *group;

246

247

group = <a href="GSimpleActionGroup.html#g-simple-action-group-new">g_simple_action_group_new</a> ();

248

<a href="GActionMap.html#g-action-map-add-action-entries">g_action_map_add_action_entries</a> (G_ACTION_MAP (group), entries, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-N-ELEMENTS:CAPS">G_N_ELEMENTS</a> (entries), <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>);

249

250

return G_ACTION_GROUP (group);

251

}</pre></td>

222

<td class="listing_code"><pre class="programlisting">static void

223

activate_quit (GSimpleAction *simple,

224

GVariant *parameter,

225

gpointer user_data)

226

{

227

exit (0);

228

}

229

230

static void

231

activate_print_string (GSimpleAction *simple,

232

GVariant *parameter,

233

gpointer user_data)

234

{

235

<a href="../glib/glib-Warnings-and-Assertions.html#g-print">g_print</a> ("%s\n", <a href="../glib/glib-GVariant.html#g-variant-get-string">g_variant_get_string</a> (parameter, NULL));

236

}

237

238

static GActionGroup *

239

create_action_group (void)

240

{

241

const GActionEntry entries[] = {

242

{ "quit", activate_quit },

243

{ "print-string", activate_print_string, "s" }

244

};

245

GSimpleActionGroup *group;

246

247

group = <a href="GSimpleActionGroup.html#g-simple-action-group-new">g_simple_action_group_new</a> ();

248

<a href="GActionMap.html#g-action-map-add-action-entries">g_action_map_add_action_entries</a> (G_ACTION_MAP (group), entries, <a href="../glib/glib-Standard-Macros.html#G-N-ELEMENTS:CAPS">G_N_ELEMENTS</a> (entries), NULL);

249

250

return G_ACTION_GROUP (group);

251

}</pre></td>

252

</tr>

253

</tbody>

254

</table>

279

<td class="parameter_name">n_entries</td>

280

<td class="parameter_description">the length of <code>entries</code>

281

, or -1 if <code>entries</code>

282

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated</td>

282

is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated</td>

283

284

</tr>

285

<tr>

334

<a name="g-action-map-remove-action"></a><h3>g_action_map_remove_action ()</h3>

335

<pre class="programlisting">void

336

g_action_map_remove_action (<code><a class="link" href="GActionMap.html" title="GActionMap">GActionMap</a> *action_map</code>,

337

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *action_name</code>);</pre>

337

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *action_name</code>);</pre>

338

Removes the named action from the action map.

339

If no action of this name is in the map then nothing happens.

340

393

</colgroup>

394

<tbody>

395

<tr>

396

<td class="struct_member_name"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface">GTypeInterface</a> <code><a name="GActionMapInterface.g-iface"></a>g_iface</code>;</td>

396

<td class="struct_member_name"><a href="../gobject/gobject-Type-Information.html#GTypeInterface">GTypeInterface</a> <code><a name="GActionMapInterface.g-iface"></a>g_iface</code>;</td>

397

398

399

</tr>

440

<a class="link" href="GActionMap.html#g-action-map-add-action-entries" title="g_action_map_add_action_entries ()"><code class="function">g_action_map_add_action_entries()</code></a>.

441

The order of the items in the structure are intended to reflect

442

frequency of use. It is permissible to use an incomplete initialiser

443

in order to leave some of the later values as <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. All values

443

in order to leave some of the later values as <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. All values

444

after <code>name</code>

445

are optional. Additional optional fields may be added in

446

the future.

455

</colgroup>

456

<tbody>

457

<tr>

458

<td class="struct_member_name">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *<code><a name="GActionEntry.name"></a>name</code>;</td>

458

<td class="struct_member_name">const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *<code><a name="GActionEntry.name"></a>name</code>;</td>

459

<td class="struct_member_description">the name of the action</td>

460

461

</tr>

462

<tr>

463

<td class="struct_member_name"><code><a name="GActionEntry.activate"></a>activate</code> ()</td>

464

<td class="struct_member_description">the callback to connect to the "activate" signal of the

465

action. Since GLib 2.40, this can be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for stateful

465

action. Since GLib 2.40, this can be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for stateful

466

actions, in which case the default handler is used. For

467

boolean-stated actions with no parameter, this is a

468

toggle. For other state types (and parameter type equal

472

473

</tr>

474

<tr>

475

476

<td class="struct_member_description">the type of the parameter that must be passed to the

477

activate function for this action, given as a single

478

GVariant type string (or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for no parameter)</td>

478

GVariant type string (or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for no parameter)</td>

479

480

</tr>

481

<tr>

482

483

<td class="struct_member_description">the initial state for this action, given in

484

<a href="http://library.gnome.org/devel/glib/unstable/gvariant-text.html">GVariant text format</a>. The state is parsed

484

<a href="../glib/gvariant-text.html">GVariant text format</a>. The state is parsed

485

with no extra type information, so type tags must be added to

486

the string if they are necessary. Stateless actions should

487

give <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> here.</td>

487

give <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> here.</td>

488

489

</tr>

490

<tr>

Older »