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

<a class="link" href="GActionGroup.html#g-action-group-get-action-enabled" title="g_action_group_get_action_enabled ()">g_action_group_get_action_enabled</a> ()

</td>

</tr>

<tr>

<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> *

<td class="function_type">const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> *

</td>

<a class="link" href="GActionGroup.html#g-action-group-get-action-parameter-type" title="g_action_group_get_action_parameter_type ()">g_action_group_get_action_parameter_type</a> ()

</td>

</tr>

<tr>

<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> *

<td class="function_type">const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> *

</td>

<a class="link" href="GActionGroup.html#g-action-group-get-action-state-type" title="g_action_group_get_action_state_type ()">g_action_group_get_action_state_type</a> ()

</tr>

<tr>

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

</td>

<a class="link" href="GActionGroup.html#g-action-group-get-action-state-hint" title="g_action_group_get_action_state_hint ()">g_action_group_get_action_state_hint</a> ()

100

</tr>

101

<tr>

102

103

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

103

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

104

</td>

105

106

<a class="link" href="GActionGroup.html#g-action-group-get-action-state" title="g_action_group_get_action_state ()">g_action_group_get_action_state</a> ()

210

</div>

211

212

<a name="GActionGroup.object-hierarchy"></a><h2>Object Hierarchy</h2>

213

<pre class="screen"> GInterface

213

<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>

214

╰── GActionGroup

215

</pre>

216

</div>

218

<a name="GActionGroup.prerequisites"></a><h2>Prerequisites</h2>

219

220

GActionGroup requires

221

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.

221

<a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>.

222

</div>

223

224

<a name="GActionGroup.derived-interfaces"></a><h2>Known Derived Interfaces</h2>

247

a menu.

248

The main way to interact with the actions in a GActionGroup is to

249

activate them with <a class="link" href="GActionGroup.html#g-action-group-activate-action" title="g_action_group_activate_action ()"><code class="function">g_action_group_activate_action()</code></a>. Activating an

250

action may require a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> parameter. The required type of the

250

action may require a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> parameter. The required type of the

251

parameter can be inquired with <a class="link" href="GActionGroup.html#g-action-group-get-action-parameter-type" title="g_action_group_get_action_parameter_type ()"><code class="function">g_action_group_get_action_parameter_type()</code></a>.

252

Actions may be disabled, see <a class="link" href="GActionGroup.html#g-action-group-get-action-enabled" title="g_action_group_get_action_enabled ()"><code class="function">g_action_group_get_action_enabled()</code></a>.

253

Activating a disabled action has no effect.

254

Actions may optionally have a state in the form of a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a>. The

254

Actions may optionally have a state in the form of a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a>. The

255

current state of an action can be inquired with

256

<a class="link" href="GActionGroup.html#g-action-group-get-action-state" title="g_action_group_get_action_state ()"><code class="function">g_action_group_get_action_state()</code></a>. Activating a stateful action may

257

change its state, but it is also possible to set the state by calling

282

<a name="GActionGroup.functions_details"></a><h2>Functions</h2>

283

284

<a name="g-action-group-list-actions"></a><h3>g_action_group_list_actions ()</h3>

285

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **

285

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar">gchar</a> **

286

g_action_group_list_actions (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>);</pre>

287

Lists the actions contained within <code>action_group</code>

288

.

289

The caller is responsible for freeing the list with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when

289

The caller is responsible for freeing the list with <a href="../glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when

290

it is no longer required.

291

292

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

305

</div>

306

307

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

308

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

308

a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of the names of the

309

actions in the groupb.

310

[<acronym title="Free data after the code is done.">transfer full</acronym>]

311

</div>

314

<hr>

315

316

<a name="g-action-group-query-action"></a><h3>g_action_group_query_action ()</h3>

317

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

317

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

318

g_action_group_query_action (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

319

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

320

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

321

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> **parameter_type</code>,

322

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> **state_type</code>,

323

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **state_hint</code>,

324

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **state</code>);</pre>

319

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

320

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> *enabled</code>,

321

<code>const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> **parameter_type</code>,

322

<code>const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> **state_type</code>,

323

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> **state_hint</code>,

324

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> **state</code>);</pre>

325

Queries all aspects of the named action within an <code>action_group</code>

326

.

327

This function acquires the information available from

341

information. The interface also provides default implementations of

342

those functions that call this function. All implementations,

343

therefore, must override either this function or all of the others.

344

If the action exists, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned and any of the requested

345

fields (as indicated by having a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> reference passed in) are

346

filled. If the action doesn't exist, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned and the

344

If the action exists, <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned and any of the requested

345

fields (as indicated by having a non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> reference passed in) are

346

filled. If the action doesn't exist, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned and the

347

fields may or may not have been modified.

348

349

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

371

</tr>

372

<tr>

373

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

374

<td class="parameter_description"> the parameter type, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none needed. </td>

374

<td class="parameter_description"> the parameter type, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none needed. </td>

375

<td class="parameter_annotations">[<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="NULL is OK, both for passing and for returning.">allow-none</acronym>]</td>

376

</tr>

377

<tr>

378

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

379

<td class="parameter_description"> the state type, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if stateless. </td>

379

<td class="parameter_description"> the state type, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if stateless. </td>

380

381

</tr>

382

<tr>

383

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

384

<td class="parameter_description"> the state hint, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none. </td>

384

<td class="parameter_description"> the state hint, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if none. </td>

385

386

</tr>

387

<tr>

388

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

389

<td class="parameter_description"> the current state, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if stateless. </td>

389

<td class="parameter_description"> the current state, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if stateless. </td>

390

391

</tr>

392

</tbody>

394

</div>

395

396

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

397

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the action exists, else <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

397

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the action exists, else <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

398

399

</div>

400

Since 2.32

402

<hr>

403

404

<a name="g-action-group-has-action"></a><h3>g_action_group_has_action ()</h3>

405

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

405

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

406

g_action_group_has_action (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

407

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

407

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

408

Checks if the named action exists within <code>action_group</code>

409

.

410

439

<hr>

440

441

<a name="g-action-group-get-action-enabled"></a><h3>g_action_group_get_action_enabled ()</h3>

442

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

442

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

443

g_action_group_get_action_enabled (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

444

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

444

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

445

Checks if the named action within <code>action_group</code>

446

is currently enabled.

447

An action must be enabled in order to be activated or in order to

478

<hr>

479

480

<a name="g-action-group-get-action-parameter-type"></a><h3>g_action_group_get_action_parameter_type ()</h3>

481

<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> *

481

<pre class="programlisting">const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> *

482

g_action_group_get_action_parameter_type

483

(<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

484

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

484

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

485

Queries the type of the parameter that must be given when activating

486

the named action within <code>action_group</code>

487

.

488

When activating the action using <a class="link" href="GActionGroup.html#g-action-group-activate-action" title="g_action_group_activate_action ()"><code class="function">g_action_group_activate_action()</code></a>,

489

the <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> given to that function must be of the type returned

489

the <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> given to that function must be of the type returned

490

by this function.

491

In the case that this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, you must not give any

492

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a>, but <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> instead.

491

In the case that this function returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, you must not give any

492

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a>, but <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> instead.

493

The parameter type of a particular action will never change but it is

494

possible for an action to be removed and for a new action to be added

495

with the same name but a different parameter type.

525

<hr>

526

527

<a name="g-action-group-get-action-state-type"></a><h3>g_action_group_get_action_state_type ()</h3>

528

<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> *

528

<pre class="programlisting">const <a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> *

529

g_action_group_get_action_state_type (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

530

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

530

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

531

Queries the type of the state of the named action within

532

<code>action_group</code>

533

.

534

If the action is stateful then this function returns the

535

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariantType.html#GVariantType">GVariantType</a> of the state. All calls to

536

<a class="link" href="GActionGroup.html#g-action-group-change-action-state" title="g_action_group_change_action_state ()"><code class="function">g_action_group_change_action_state()</code></a> must give a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> of this

537

type and <a class="link" href="GActionGroup.html#g-action-group-get-action-state" title="g_action_group_get_action_state ()"><code class="function">g_action_group_get_action_state()</code></a> will return a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a>

535

<a href="../glib/glib-GVariantType.html#GVariantType">GVariantType</a> of the state. All calls to

536

<a class="link" href="GActionGroup.html#g-action-group-change-action-state" title="g_action_group_change_action_state ()"><code class="function">g_action_group_change_action_state()</code></a> must give a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> of this

537

type and <a class="link" href="GActionGroup.html#g-action-group-get-action-state" title="g_action_group_get_action_state ()"><code class="function">g_action_group_get_action_state()</code></a> will return a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a>

538

of the same type.

539

If the action is not stateful then this function will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

540

In that case, <a class="link" href="GActionGroup.html#g-action-group-get-action-state" title="g_action_group_get_action_state ()"><code class="function">g_action_group_get_action_state()</code></a> will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

539

If the action is not stateful then this function will return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

540

In that case, <a class="link" href="GActionGroup.html#g-action-group-get-action-state" title="g_action_group_get_action_state ()"><code class="function">g_action_group_get_action_state()</code></a> will return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

541

and you must not call <a class="link" href="GActionGroup.html#g-action-group-change-action-state" title="g_action_group_change_action_state ()"><code class="function">g_action_group_change_action_state()</code></a>.

542

The state type of a particular action will never change but it is

543

possible for an action to be removed and for a new action to be added

575

<hr>

576

577

<a name="g-action-group-get-action-state-hint"></a><h3>g_action_group_get_action_state_hint ()</h3>

578

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

578

<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

579

g_action_group_get_action_state_hint (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

580

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

580

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

581

Requests a hint about the valid range of values for the state of the

582

named action within <code>action_group</code>

583

.

584

If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned it either means that the action is not stateful

584

If <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned it either means that the action is not stateful

585

or that there is no hint about the valid range of values for the

586

state of the action.

587

If a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> array is returned then each item in the array is a

588

possible value for the state. If a <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> pair (ie: two-tuple) is

587

If a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> array is returned then each item in the array is a

588

possible value for the state. If a <a href="../glib/glib-GVariant.html#GVariant">GVariant</a> pair (ie: two-tuple) is

589

returned then the tuple specifies the inclusive lower and upper bound

590

of valid values for the state.

591

In any case, the information is merely a hint. It may be possible to

592

have a state value outside of the hinted range and setting a value

593

within the range may fail.

594

The return value (if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) should be freed with

595

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> when it is no longer required.

594

The return value (if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) should be freed with

595

<a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> when it is no longer required.

596

597

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

598

625

<hr>

626

627

<a name="g-action-group-get-action-state"></a><h3>g_action_group_get_action_state ()</h3>

628

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *

628

<pre class="programlisting"><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *

629

g_action_group_get_action_state (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

630

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

630

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

631

Queries the current state of the named action within <code>action_group</code>

632

.

633

If the action is not stateful then <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned. If the

633

If the action is not stateful then <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned. If the

634

action is stateful then the type of the return value is the type

635

given by <a class="link" href="GActionGroup.html#g-action-group-get-action-state-type" title="g_action_group_get_action_state_type ()"><code class="function">g_action_group_get_action_state_type()</code></a>.

636

The return value (if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) should be freed with

637

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> when it is no longer required.

636

The return value (if non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>) should be freed with

637

<a href="../glib/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a> when it is no longer required.

638

639

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

640

669

<a name="g-action-group-change-action-state"></a><h3>g_action_group_change_action_state ()</h3>

670

<pre class="programlisting">void

671

g_action_group_change_action_state (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

672

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

673

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *value</code>);</pre>

672

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

673

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *value</code>);</pre>

674

Request for the state of the named action within <code>action_group</code>

675

to be

676

changed to <code>value</code>

718

<a name="g-action-group-activate-action"></a><h3>g_action_group_activate_action ()</h3>

719

<pre class="programlisting">void

720

g_action_group_activate_action (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

721

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

722

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *parameter</code>);</pre>

721

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

722

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *parameter</code>);</pre>

723

Activate the named action within <code>action_group</code>

724

.

725

If the action is expecting a parameter, then the correct type of

726

parameter must be given as <code>parameter</code>

727

. If the action is expecting no

728

parameters then <code>parameter</code>

729

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

729

must be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. See

730

<a class="link" href="GActionGroup.html#g-action-group-get-action-parameter-type" title="g_action_group_get_action_parameter_type ()"><code class="function">g_action_group_get_action_parameter_type()</code></a>.

731

732

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

762

<a name="g-action-group-action-added"></a><h3>g_action_group_action_added ()</h3>

763

<pre class="programlisting">void

764

g_action_group_action_added (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

765

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

765

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

766

Emits the <a class="link" href="GActionGroup.html#GActionGroup-action-added" title="The “action-added” signal">“action-added”</a> signal on <code>action_group</code>

767

.

768

This function should only be called by <a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> implementations.

795

<a name="g-action-group-action-removed"></a><h3>g_action_group_action_removed ()</h3>

796

<pre class="programlisting">void

797

g_action_group_action_removed (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

798

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

798

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

799

Emits the <a class="link" href="GActionGroup.html#GActionGroup-action-removed" title="The “action-removed” signal">“action-removed”</a> signal on <code>action_group</code>

800

.

801

This function should only be called by <a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> implementations.

828

<a name="g-action-group-action-enabled-changed"></a><h3>g_action_group_action_enabled_changed ()</h3>

829

<pre class="programlisting">void

830

g_action_group_action_enabled_changed (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

831

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

832

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

831

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

832

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

833

Emits the <a class="link" href="GActionGroup.html#GActionGroup-action-enabled-changed" title="The “action-enabled-changed” signal">“action-enabled-changed”</a> signal on <code>action_group</code>

834

.

835

This function should only be called by <a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> implementations.

867

<a name="g-action-group-action-state-changed"></a><h3>g_action_group_action_state_changed ()</h3>

868

<pre class="programlisting">void

869

g_action_group_action_state_changed (<code><a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group</code>,

870

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

871

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *state</code>);</pre>

870

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

871

<code><a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *state</code>);</pre>

872

Emits the <a class="link" href="GActionGroup.html#GActionGroup-action-state-changed" title="The “action-state-changed” signal">“action-state-changed”</a> signal on <code>action_group</code>

873

.

874

This function should only be called by <a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> implementations.

976

</colgroup>

977

<tbody>

978

<tr>

979

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

979

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

980

981

982

</tr>

1062

<a name="GActionGroup-action-added"></a><h3>The <code class="literal">“action-added”</code> signal</h3>

1063

<pre class="programlisting">void

1064

user_function (<a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group,

1065

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

1066

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

1065

<a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *action_name,

1066

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

1067

Signals that a new action was just added to the group.

1068

This signal is emitted after the action has been added

1069

and is now visible.

1103

<a name="GActionGroup-action-enabled-changed"></a><h3>The <code class="literal">“action-enabled-changed”</code> signal</h3>

1104

<pre class="programlisting">void

1105

user_function (<a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group,

1106

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

1107

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

1108

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

1106

<a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *action_name,

1107

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> enabled,

1108

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

1109

Signals that the enabled status of the named action has changed.

1110

1111

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

1148

<a name="GActionGroup-action-removed"></a><h3>The <code class="literal">“action-removed”</code> signal</h3>

1149

<pre class="programlisting">void

1150

user_function (<a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group,

1151

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

1152

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

1151

<a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *action_name,

1152

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

1153

Signals that an action is just about to be removed from the group.

1154

This signal is emitted before the action is removed, so the action

1155

is still visible and can be queried from the signal handler.

1189

<a name="GActionGroup-action-state-changed"></a><h3>The <code class="literal">“action-state-changed”</code> signal</h3>

1190

<pre class="programlisting">void

1191

user_function (<a class="link" href="GActionGroup.html" title="GActionGroup">GActionGroup</a> *action_group,

1192

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

1193

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> *value,

1194

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

1192

<a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *action_name,

1193

<a href="../glib/glib-GVariant.html#GVariant">GVariant</a> *value,

1194

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

1195

Signals that the state of the named action has changed.

1196

1197

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

Older »