~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed

<a class="link" href="gobject-Signals.html#g-signal-connect-closure-by-id" title="g_signal_connect_closure_by_id ()">g_signal_connect_closure_by_id</a> ()

231

</tr>

232

<tr>

233

234

<a href="../glib/glib-Basic-Types.html#gulong">gulong</a>

234

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

235

</td>

236

237

<a class="link" href="gobject-Signals.html#g-signal-handler-find" title="g_signal_handler_find ()">g_signal_handler_find</a> ()

239

</tr>

240

<tr>

241

242

<a href="../glib/glib-Basic-Types.html#guint">guint</a>

242

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

243

</td>

244

245

<a class="link" href="gobject-Signals.html#g-signal-handlers-block-matched" title="g_signal_handlers_block_matched ()">g_signal_handlers_block_matched</a> ()

247

</tr>

248

<tr>

249

250

<a href="../glib/glib-Basic-Types.html#guint">guint</a>

250

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

251

</td>

252

253

<a class="link" href="gobject-Signals.html#g-signal-handlers-unblock-matched" title="g_signal_handlers_unblock_matched ()">g_signal_handlers_unblock_matched</a> ()

255

</tr>

256

<tr>

257

258

<a href="../glib/glib-Basic-Types.html#guint">guint</a>

258

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

259

</td>

260

261

<a class="link" href="gobject-Signals.html#g-signal-handlers-disconnect-matched" title="g_signal_handlers_disconnect_matched ()">g_signal_handlers_disconnect_matched</a> ()

263

</tr>

264

<tr>

265

266

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

266

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

267

</td>

268

269

<a class="link" href="gobject-Signals.html#g-signal-handler-is-connected" title="g_signal_handler_is_connected ()">g_signal_handler_is_connected</a> ()

295

</tr>

296

<tr>

297

298

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

298

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

299

</td>

300

301

<a class="link" href="gobject-Signals.html#g-signal-has-handler-pending" title="g_signal_has_handler_pending ()">g_signal_has_handler_pending</a> ()

335

</tr>

336

<tr>

337

338

<a href="../glib/glib-Basic-Types.html#guint">guint</a>

338

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

339

</td>

340

341

<a class="link" href="gobject-Signals.html#g-signal-new-class-handler" title="g_signal_new_class_handler ()">g_signal_new_class_handler</a> ()

359

</tr>

360

<tr>

361

362

<a href="../glib/glib-Basic-Types.html#gulong">gulong</a>

362

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

363

</td>

364

365

<a class="link" href="gobject-Signals.html#g-signal-add-emission-hook" title="g_signal_add_emission_hook ()">g_signal_add_emission_hook</a> ()

375

</tr>

376

<tr>

377

378

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

378

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

379

</td>

380

381

<a class="link" href="gobject-Signals.html#g-signal-parse-name" title="g_signal_parse_name ()">g_signal_parse_name</a> ()

399

</tr>

400

<tr>

401

402

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

402

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

403

</td>

404

405

<a class="link" href="gobject-Signals.html#g-signal-accumulator-first-wins" title="g_signal_accumulator_first_wins ()">g_signal_accumulator_first_wins</a> ()

407

</tr>

408

<tr>

409

410

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

410

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

411

</td>

412

413

<a class="link" href="gobject-Signals.html#g-signal-accumulator-true-handled" title="g_signal_accumulator_true_handled ()">g_signal_accumulator_true_handled</a> ()

521

<a name="gobject-Signals.functions_details"></a><h2>Functions</h2>

522

523

<a name="GSignalAccumulator"></a><h3>GSignalAccumulator ()</h3>

524

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

524

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

525

(*GSignalAccumulator) (<code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="struct GSignalInvocationHint">GSignalInvocationHint</a> *ihint</code>,

526

<code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_accu</code>,

527

<code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *handler_return</code>,

528

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

528

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

529

The signal accumulator is a special callback function that can be used

530

to collect return values of the various callbacks that are called

531

during a signal emission. The signal accumulator is specified at signal

532

creation time, if it is left <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, no accumulation of callback return

532

creation time, if it is left <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, no accumulation of callback return

533

values is performed. The return value of signal emissions is then the

534

value returned by the last callback.

535

568

569

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

570

The accumulator function returns whether the signal emission

571

should be aborted. Returning <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> means to abort the

572

current emission and <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned for continuation.

571

should be aborted. Returning <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> means to abort the

572

current emission and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is returned for continuation.

573

574

</div>

575

</div>

576

<hr>

577

578

<a name="GSignalEmissionHook"></a><h3>GSignalEmissionHook ()</h3>

579

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

579

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

580

(*GSignalEmissionHook) (<code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="struct GSignalInvocationHint">GSignalInvocationHint</a> *ihint</code>,

581

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

581

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

582

<code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *param_values</code>,

583

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

583

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

584

A simple function pointer to get invoked when the signal is emitted. This

585

allows you to tie a hook to the signal type, so that it will trap all

586

emissions of that signal, from any object.

621

</div>

622

623

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

624

whether it wants to stay connected. If it returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, the signal

624

whether it wants to stay connected. If it returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, the signal

625

hook is disconnected (and destroyed).

626

627

</div>

651

<td class="listing_code"><pre class="programlisting"><a href="gobject-Signals.html#g-signal-new">g_signal_new</a> ("size_request",

652

<a href="gobject-Type-Information.html#G-TYPE-FROM-CLASS:CAPS">G_TYPE_FROM_CLASS</a> (gobject_class),

653

G_SIGNAL_RUN_FIRST,

654

<a href="../glib/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a> (GtkWidgetClass, size_request),

654

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#G-STRUCT-OFFSET:CAPS">G_STRUCT_OFFSET</a> (GtkWidgetClass, size_request),

655

NULL, NULL,

656

_gtk_marshal_VOID__BOXED,

657

G_TYPE_NONE, 1,

666

<hr>

667

668

<a name="g-signal-new"></a><h3>g_signal_new ()</h3>

669

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

670

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

669

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

670

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

671

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype</code>,

672

<code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags</code>,

673

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

673

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

674

<code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator</code>,

675

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

675

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

676

<code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller</code>,

677

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type</code>,

678

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

678

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

679

680

Creates a new signal. (This is usually done in the class initializer.)

681

A signal name consists of segments consisting of ASCII letters and

688

subclasses cannot override the class handler

689

in their class_init method by doing super_class->signal_handler = my_signal_handler.

690

Instead they will have to use <a class="link" href="gobject-Signals.html#g-signal-override-class-handler" title="g_signal_override_class_handler ()"><code class="function">g_signal_override_class_handler()</code></a>.

691

If c_marshaller is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <a class="link" href="gobject-Closures.html#g-cclosure-marshal-generic" title="g_cclosure_marshal_generic ()"><code class="function">g_cclosure_marshal_generic()</code></a> will be used as

691

If c_marshaller is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <a class="link" href="gobject-Closures.html#g-cclosure-marshal-generic" title="g_cclosure_marshal_generic ()"><code class="function">g_cclosure_marshal_generic()</code></a> will be used as

692

the marshaller for this signal.

693

694

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

726

</tr>

727

<tr>

728

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

729

<td class="parameter_description">the accumulator for this signal; may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

729

<td class="parameter_description">the accumulator for this signal; may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

730

731

</tr>

732

<tr>

738

<tr>

739

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

740

<td class="parameter_description"> the function to translate arrays of parameter

741

values to signal emissions into C language callback invocations or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

741

values to signal emissions into C language callback invocations or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

742

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

743

</tr>

744

<tr>

769

<hr>

770

771

<a name="g-signal-newv"></a><h3>g_signal_newv ()</h3>

772

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

773

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

772

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

773

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

774

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype</code>,

775

<code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags</code>,

776

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *class_closure</code>,

777

<code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator</code>,

778

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

778

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

779

<code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller</code>,

780

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type</code>,

781

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

781

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

782

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> *param_types</code>);</pre>

783

Creates a new signal. (This is usually done in the class initializer.)

784

See <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> for details on allowed signal names.

785

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

785

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

786

will be used as

787

the marshaller for this signal.

788

815

<tr>

816

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

817

<td class="parameter_description"> The closure to invoke on signal emission;

818

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

818

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

819

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

820

</tr>

821

<tr>

822

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

823

<td class="parameter_description"> the accumulator for this signal; may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

823

<td class="parameter_description"> the accumulator for this signal; may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

824

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

825

</tr>

826

<tr>

833

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

834

<td class="parameter_description"> the function to translate arrays of

835

parameter values to signal emissions into C language callback

836

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

836

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

837

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

838

</tr>

839

<tr>

866

<hr>

867

868

<a name="g-signal-new-valist"></a><h3>g_signal_new_valist ()</h3>

869

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

870

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

869

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

870

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

871

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype</code>,

872

<code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags</code>,

873

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *class_closure</code>,

874

<code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator</code>,

875

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

875

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

876

<code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller</code>,

877

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type</code>,

878

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

878

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

879

880

Creates a new signal. (This is usually done in the class initializer.)

881

See <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> for details on allowed signal names.

882

883

the marshaller for this signal.

884

885

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

910

</tr>

911

<tr>

912

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

913

<td class="parameter_description">The closure to invoke on signal emission; may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

913

<td class="parameter_description">The closure to invoke on signal emission; may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

914

915

</tr>

916

<tr>

917

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

918

<td class="parameter_description">the accumulator for this signal; may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

918

919

920

</tr>

921

<tr>

927

<tr>

928

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

929

<td class="parameter_description"> the function to translate arrays of parameter

930

values to signal emissions into C language callback invocations or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

930

931

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

932

</tr>

933

<tr>

960

961

<a name="g-signal-set-va-marshaller"></a><h3>g_signal_set_va_marshaller ()</h3>

962

<pre class="programlisting">void

963

g_signal_set_va_marshaller (<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

963

g_signal_set_va_marshaller (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

964

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> instance_type</code>,

965

<code><a class="link" href="gobject-Signals.html#GSignalCVaMarshaller" title="GSignalCVaMarshaller">GSignalCVaMarshaller</a> va_marshaller</code>);</pre>

966

</div>

968

969

<a name="g-signal-query"></a><h3>g_signal_query ()</h3>

970

<pre class="programlisting">void

971

g_signal_query (<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

971

g_signal_query (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

972

<code><a class="link" href="gobject-Signals.html#GSignalQuery" title="struct GSignalQuery">GSignalQuery</a> *query</code>);</pre>

973

Queries the signal system for in-depth information about a

974

specific signal. This function will fill in a user-provided

1004

<hr>

1005

1006

<a name="g-signal-lookup"></a><h3>g_signal_lookup ()</h3>

1007

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

1008

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

1007

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

1008

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

1009

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype</code>);</pre>

1010

Given the name of the signal and the type of object it connects to, gets

1011

the signal's identifying integer. Emitting the signal by number is

1043

<hr>

1044

1045

<a name="g-signal-name"></a><h3>g_signal_name ()</h3>

1046

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

1047

g_signal_name (<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> signal_id</code>);</pre>

1046

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

1047

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

1048

Given the signal's identifier, finds its name.

1049

Two different signals may have the same name, if they have differing types.

1050

1064

</div>

1065

1066

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

1067

the signal name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the signal number was invalid.

1067

the signal name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the signal number was invalid.

1068

1069

</div>

1070

</div>

1071

<hr>

1072

1073

<a name="g-signal-list-ids"></a><h3>g_signal_list_ids ()</h3>

1074

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

1074

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

1075

g_signal_list_ids (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype</code>,

1076

<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> *n_ids</code>);</pre>

1076

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

1077

Lists the signals by id that a certain instance or interface type

1078

created. Further information about the signals can be acquired through

1079

<a class="link" href="gobject-Signals.html#g-signal-query" title="g_signal_query ()"><code class="function">g_signal_query()</code></a>.

1110

1111

<a name="g-signal-emit"></a><h3>g_signal_emit ()</h3>

1112

<pre class="programlisting">void

1113

g_signal_emit (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1114

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

1115

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1113

g_signal_emit (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1114

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

1115

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1116

1117

Emits a signal.

1118

Note that <a class="link" href="gobject-Signals.html#g-signal-emit" title="g_signal_emit ()"><code class="function">g_signal_emit()</code></a> resets the return value to the default

1156

1157

<a name="g-signal-emit-by-name"></a><h3>g_signal_emit_by_name ()</h3>

1158

<pre class="programlisting">void

1159

g_signal_emit_by_name (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1160

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

1159

g_signal_emit_by_name (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1160

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

1161

1162

Emits a signal.

1163

Note that <a class="link" href="gobject-Signals.html#g-signal-emit-by-name" title="g_signal_emit_by_name ()"><code class="function">g_signal_emit_by_name()</code></a> resets the return value to the default

1197

<a name="g-signal-emitv"></a><h3>g_signal_emitv ()</h3>

1198

<pre class="programlisting">void

1199

g_signal_emitv (<code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *instance_and_params</code>,

1200

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

1201

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1200

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

1201

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1202

<code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_value</code>);</pre>

1203

Emits a signal.

1204

Note that <a class="link" href="gobject-Signals.html#g-signal-emitv" title="g_signal_emitv ()"><code class="function">g_signal_emitv()</code></a> doesn't change <code>return_value</code>

1243

1244

<a name="g-signal-emit-valist"></a><h3>g_signal_emit_valist ()</h3>

1245

<pre class="programlisting">void

1246

g_signal_emit_valist (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1247

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

1248

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1246

g_signal_emit_valist (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1247

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

1248

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1249

1250

Emits a signal.

1251

Note that <a class="link" href="gobject-Signals.html#g-signal-emit-valist" title="g_signal_emit_valist ()"><code class="function">g_signal_emit_valist()</code></a> resets the return value to the default

1425

<hr>

1426

1427

<a name="g-signal-connect-object"></a><h3>g_signal_connect_object ()</h3>

1428

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

1429

g_signal_connect_object (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1430

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

1428

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

1429

g_signal_connect_object (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1430

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

1431

<code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> c_handler</code>,

1432

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

1432

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

1433

<code><a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags">GConnectFlags</a> connect_flags</code>);</pre>

1434

This is similar to <a class="link" href="gobject-Signals.html#g-signal-connect-data" title="g_signal_connect_data ()"><code class="function">g_signal_connect_data()</code></a>, but uses a closure which

1435

ensures that the <code>gobject</code>

1490

<hr>

1491

1492

<a name="g-signal-connect-data"></a><h3>g_signal_connect_data ()</h3>

1493

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

1494

g_signal_connect_data (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1495

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

1493

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

1494

g_signal_connect_data (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1495

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

1496

<code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> c_handler</code>,

1497

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

1497

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

1498

<code><a class="link" href="gobject-Closures.html#GClosureNotify" title="GClosureNotify ()">GClosureNotify</a> destroy_data</code>,

1499

<code><a class="link" href="gobject-Signals.html#GConnectFlags" title="enum GConnectFlags">GConnectFlags</a> connect_flags</code>);</pre>

1500

Connects a <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> function to a signal for a particular object. Similar

1556

<hr>

1557

1558

<a name="g-signal-connect-closure"></a><h3>g_signal_connect_closure ()</h3>

1559

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

1560

g_signal_connect_closure (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1561

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

1559

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

1560

g_signal_connect_closure (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1561

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

1562

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *closure</code>,

1563

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

1563

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

1564

Connects a closure to a signal for a particular object.

1565

1566

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

1604

<hr>

1605

1606

<a name="g-signal-connect-closure-by-id"></a><h3>g_signal_connect_closure_by_id ()</h3>

1607

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

1608

g_signal_connect_closure_by_id (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1609

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

1610

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1607

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

1608

g_signal_connect_closure_by_id (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1609

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

1610

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1611

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *closure</code>,

1612

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

1612

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

1613

Connects a closure to a signal for a particular object.

1614

1615

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

1659

1660

<a name="g-signal-handler-block"></a><h3>g_signal_handler_block ()</h3>

1661

<pre class="programlisting">void

1662

g_signal_handler_block (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1663

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

1662

g_signal_handler_block (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1663

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

1664

Blocks a handler of an instance so it will not be called during any

1665

signal emissions unless it is unblocked again. Thus "blocking" a

1666

signal handler means to temporarily deactive it, a signal handler

1697

1698

<a name="g-signal-handler-unblock"></a><h3>g_signal_handler_unblock ()</h3>

1699

<pre class="programlisting">void

1700

g_signal_handler_unblock (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1701

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

1700

g_signal_handler_unblock (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1701

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

1702

Undoes the effect of a previous <a class="link" href="gobject-Signals.html#g-signal-handler-block" title="g_signal_handler_block ()"><code class="function">g_signal_handler_block()</code></a> call. A

1703

blocked handler is skipped during signal emissions and will not be

1704

invoked, unblocking it (for exactly the amount of times it has been

1740

1741

<a name="g-signal-handler-disconnect"></a><h3>g_signal_handler_disconnect ()</h3>

1742

<pre class="programlisting">void

1743

g_signal_handler_disconnect (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1744

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

1743

g_signal_handler_disconnect (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1744

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

1745

Disconnects a handler from an instance so it will not be called during

1746

any future or currently ongoing emissions of the signal it has been

1747

connected to. The <code>handler_id</code>

1776

<hr>

1777

1778

<a name="g-signal-handler-find"></a><h3>g_signal_handler_find ()</h3>

1779

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

1780

g_signal_handler_find (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1779

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

1780

g_signal_handler_find (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1781

<code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask</code>,

1782

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

1783

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1782

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

1783

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1784

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *closure</code>,

1785

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

1786

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

1785

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

1786

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

1787

Finds the first signal handler that matches certain selection criteria.

1788

The criteria mask is passed as an OR-ed combination of <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a>

1789

flags, and the criteria values are passed as arguments.

1851

<hr>

1852

1853

<a name="g-signal-handlers-block-matched"></a><h3>g_signal_handlers_block_matched ()</h3>

1854

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

1855

g_signal_handlers_block_matched (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1854

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

1855

g_signal_handlers_block_matched (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1856

<code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask</code>,

1857

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

1858

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1857

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

1858

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1859

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *closure</code>,

1860

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

1861

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

1860

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

1861

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

1862

Blocks all handlers on an instance that match a certain selection criteria.

1863

The criteria mask is passed as an OR-ed combination of <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a>

1864

flags, and the criteria values are passed as arguments.

1927

<hr>

1928

1929

<a name="g-signal-handlers-unblock-matched"></a><h3>g_signal_handlers_unblock_matched ()</h3>

1930

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

1931

g_signal_handlers_unblock_matched (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1930

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

1931

g_signal_handlers_unblock_matched (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

1932

<code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask</code>,

1933

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

1934

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1933

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

1934

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

1935

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *closure</code>,

1936

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

1937

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

1936

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

1937

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

1938

Unblocks all handlers on an instance that match a certain selection

1939

criteria. The criteria mask is passed as an OR-ed combination of

1940

<a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> flags, and the criteria values are passed as arguments.

2004

<hr>

2005

2006

<a name="g-signal-handlers-disconnect-matched"></a><h3>g_signal_handlers_disconnect_matched ()</h3>

2007

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

2008

g_signal_handlers_disconnect_matched (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2007

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

2008

g_signal_handlers_disconnect_matched (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2009

<code><a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> mask</code>,

2010

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

2011

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

2010

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

2011

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

2012

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *closure</code>,

2013

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

2014

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

2013

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

2014

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

2015

Disconnects all handlers on an instance that match a certain

2016

selection criteria. The criteria mask is passed as an OR-ed

2017

combination of <a class="link" href="gobject-Signals.html#GSignalMatchType" title="enum GSignalMatchType">GSignalMatchType</a> flags, and the criteria values are

2081

<hr>

2082

2083

<a name="g-signal-handler-is-connected"></a><h3>g_signal_handler_is_connected ()</h3>

2084

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

2085

g_signal_handler_is_connected (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2086

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

2084

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

2085

g_signal_handler_is_connected (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2086

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

2087

Returns whether <code>handler_id</code>

2088

is the id of a handler connected to <code>instance</code>

2089

.

2275

<hr>

2276

2277

<a name="g-signal-has-handler-pending"></a><h3>g_signal_has_handler_pending ()</h3>

2278

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

2279

g_signal_has_handler_pending (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2280

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

2281

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

2282

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

2278

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

2279

g_signal_has_handler_pending (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2280

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

2281

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

2282

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

2283

Returns whether there are any handlers connected to <code>instance</code>

2284

for the

2285

given signal id and detail.

2321

</div>

2322

2323

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

2324

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a handler is connected to the signal, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

2324

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a handler is connected to the signal, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

2325

otherwise.

2326

2327

</div>

2330

2331

<a name="g-signal-stop-emission"></a><h3>g_signal_stop_emission ()</h3>

2332

<pre class="programlisting">void

2333

g_signal_stop_emission (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2334

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

2335

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>);</pre>

2333

g_signal_stop_emission (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2334

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

2335

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>);</pre>

2336

Stops a signal's current emission.

2337

This will prevent the default method from running, if the signal was

2338

<a class="link" href="gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">G_SIGNAL_RUN_LAST</code></a> and you connected normally (i.e. without the "after"

2370

2371

<a name="g-signal-stop-emission-by-name"></a><h3>g_signal_stop_emission_by_name ()</h3>

2372

<pre class="programlisting">void

2373

g_signal_stop_emission_by_name (<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2374

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

2373

g_signal_stop_emission_by_name (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2374

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

2375

Stops a signal's current emission.

2376

This is just like <a class="link" href="gobject-Signals.html#g-signal-stop-emission" title="g_signal_stop_emission ()"><code class="function">g_signal_stop_emission()</code></a> except it will look up the

2377

signal id for you.

2402

2403

<a name="g-signal-override-class-closure"></a><h3>g_signal_override_class_closure ()</h3>

2404

<pre class="programlisting">void

2405

g_signal_override_class_closure (<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

2405

g_signal_override_class_closure (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

2406

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> instance_type</code>,

2407

<code><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *class_closure</code>);</pre>

2408

Overrides the class closure (i.e. the default handler) for the given signal

2480

<hr>

2481

2482

<a name="g-signal-new-class-handler"></a><h3>g_signal_new_class_handler ()</h3>

2483

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

2484

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

2483

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

2484

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

2485

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype</code>,

2486

<code><a class="link" href="gobject-Signals.html#GSignalFlags" title="enum GSignalFlags">GSignalFlags</a> signal_flags</code>,

2487

<code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> class_handler</code>,

2488

<code><a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> accumulator</code>,

2489

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

2489

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

2490

<code><a class="link" href="gobject-Signals.html#GSignalCMarshaller" title="GSignalCMarshaller">GSignalCMarshaller</a> c_marshaller</code>,

2491

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> return_type</code>,

2492

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

2492

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

2493

2494

Creates a new signal. (This is usually done in the class initializer.)

2495

This is a variant of <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> that takes a C callback instead

2502

<a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden" title="g_signal_chain_from_overridden ()"><code class="function">g_signal_chain_from_overridden()</code></a> or

2503

<a class="link" href="gobject-Signals.html#g-signal-chain-from-overridden-handler" title="g_signal_chain_from_overridden_handler ()"><code class="function">g_signal_chain_from_overridden_handler()</code></a>.

2504

See <a class="link" href="gobject-Signals.html#g-signal-new" title="g_signal_new ()"><code class="function">g_signal_new()</code></a> for information about signal names.

2505

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

2505

2506

will be used as

2507

the marshaller for this signal.

2508

2535

<tr>

2536

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

2537

<td class="parameter_description">a <a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> which acts as class implementation of

2538

this signal. Used to invoke a class method generically. Pass <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to

2538

this signal. Used to invoke a class method generically. Pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to

2539

not associate a class method with this signal.</td>

2540

2541

</tr>

2542

<tr>

2543

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

2544

<td class="parameter_description">the accumulator for this signal; may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>

2544

2545

2546

</tr>

2547

<tr>

2553

<tr>

2554

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

2555

<td class="parameter_description"> the function to translate arrays of parameter

2556

values to signal emissions into C language callback invocations or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

2556

2557

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2558

</tr>

2559

<tr>

2586

2587

<a name="g-signal-override-class-handler"></a><h3>g_signal_override_class_handler ()</h3>

2588

<pre class="programlisting">void

2589

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

2589

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

2590

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> instance_type</code>,

2591

<code><a class="link" href="gobject-Closures.html#GCallback" title="GCallback ()">GCallback</a> class_handler</code>);</pre>

2592

Overrides the class closure (i.e. the default handler) for the

2634

<a name="g-signal-chain-from-overridden-handler"></a><h3>g_signal_chain_from_overridden_handler ()</h3>

2635

<pre class="programlisting">void

2636

g_signal_chain_from_overridden_handler

2637

(<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> instance</code>,

2637

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

2638

2639

Calls the original class closure of a signal. This function should

2640

only be called from an overridden class closure; see

2669

<hr>

2670

2671

<a name="g-signal-add-emission-hook"></a><h3>g_signal_add_emission_hook ()</h3>

2672

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

2673

g_signal_add_emission_hook (<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

2674

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

2672

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

2673

g_signal_add_emission_hook (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

2674

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> detail</code>,

2675

<code><a class="link" href="gobject-Signals.html#GSignalEmissionHook" title="GSignalEmissionHook ()">GSignalEmissionHook</a> hook_func</code>,

2676

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

2677

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> data_destroy</code>);</pre>

2676

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

2677

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> data_destroy</code>);</pre>

2678

Adds an emission hook for a signal, which will get called for any emission

2679

of that signal, independent of the instance. This is possible only

2680

for signals which don't have <a class="link" href="gobject-Signals.html#G-SIGNAL-NO-HOOKS:CAPS">G_SIGNAL_NO_HOOKS</a> flag set.

2710

</tr>

2711

<tr>

2712

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

2713

<td class="parameter_description">a <a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> for <code>hook_data</code>

2713

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> for <code>hook_data</code>

2714

.</td>

2715

2716

</tr>

2727

2728

<a name="g-signal-remove-emission-hook"></a><h3>g_signal_remove_emission_hook ()</h3>

2729

<pre class="programlisting">void

2730

g_signal_remove_emission_hook (<code><a href="../glib/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

2731

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

2730

g_signal_remove_emission_hook (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> signal_id</code>,

2731

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

2732

Deletes an emission hook.

2733

2734

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

2757

<hr>

2758

2759

<a name="g-signal-parse-name"></a><h3>g_signal_parse_name ()</h3>

2760

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

2761

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

2760

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

2761

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

2762

<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype</code>,

2763

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

2764

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> *detail_p</code>,

2765

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

2763

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

2764

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

2765

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

2766

Internal function to parse a signal name into its <code>signal_id</code>

2767

2768

and <code>detail</code>

2798

</tr>

2799

<tr>

2800

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

2801

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> forces creation of a <a href="../glib/glib-Quarks.html#GQuark">GQuark</a> for the detail.</td>

2801

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> forces creation of a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> for the detail.</td>

2802

2803

</tr>

2804

</tbody>

2816

2817

<a name="g-signal-get-invocation-hint"></a><h3>g_signal_get_invocation_hint ()</h3>

2818

<pre class="programlisting"><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="struct GSignalInvocationHint">GSignalInvocationHint</a> *

2819

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

2819

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

2820

Returns the invocation hint of the innermost signal emission of instance.

2821

2822

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

2844

<a name="g-signal-type-cclosure-new"></a><h3>g_signal_type_cclosure_new ()</h3>

2845

<pre class="programlisting"><a class="link" href="gobject-Closures.html#GClosure" title="struct GClosure">GClosure</a> *

2846

g_signal_type_cclosure_new (<code><a class="link" href="gobject-Type-Information.html#GType" title="GType">GType</a> itype</code>,

2847

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

2847

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

2848

Creates a new closure which invokes the function found at the offset

2849

<code>struct_offset</code>

2850

in the class structure of the interface or classed type

2883

<hr>

2884

2885

<a name="g-signal-accumulator-first-wins"></a><h3>g_signal_accumulator_first_wins ()</h3>

2886

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

2886

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

2887

g_signal_accumulator_first_wins (<code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="struct GSignalInvocationHint">GSignalInvocationHint</a> *ihint</code>,

2888

<code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_accu</code>,

2889

<code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *handler_return</code>,

2890

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

2890

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

2891

A predefined <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> for signals intended to be used as a

2892

hook for application code to provide a particular value. Usually

2893

only one such value is desired and multiple handlers for the same

2939

<hr>

2940

2941

<a name="g-signal-accumulator-true-handled"></a><h3>g_signal_accumulator_true_handled ()</h3>

2942

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

2942

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

2943

g_signal_accumulator_true_handled (<code><a class="link" href="gobject-Signals.html#GSignalInvocationHint" title="struct GSignalInvocationHint">GSignalInvocationHint</a> *ihint</code>,

2944

<code><a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *return_accu</code>,

2945

<code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *handler_return</code>,

2946

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

2946

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

2947

A predefined <a class="link" href="gobject-Signals.html#GSignalAccumulator" title="GSignalAccumulator ()">GSignalAccumulator</a> for signals that return a

2948

boolean values. The behavior that this accumulator gives is

2949

that a return of <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> stops the signal emission: no further

2950

callbacks will be invoked, while a return of <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> allows

2951

the emission to continue. The idea here is that a <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> return

2949

that a return of <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> stops the signal emission: no further

2950

callbacks will be invoked, while a return of <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> allows

2951

the emission to continue. The idea here is that a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> return

2952

indicates that the callback handled the signal, and no further

2953

handling is needed.

2954

3013

</colgroup>

3014

<tbody>

3015

<tr>

3016

<td class="struct_member_name"><a href="../glib/glib-Basic-Types.html#guint">guint</a> <code><a name="GSignalInvocationHint.signal-id"></a>signal_id</code>;</td>

3016

<td class="struct_member_name"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <code><a name="GSignalInvocationHint.signal-id"></a>signal_id</code>;</td>

3017

<td class="struct_member_description">The signal id of the signal invoking the callback</td>

3018

3019

</tr>

3020

<tr>

3021

<td class="struct_member_name"><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> <code><a name="GSignalInvocationHint.detail"></a>detail</code>;</td>

3021

<td class="struct_member_name"><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> <code><a name="GSignalInvocationHint.detail"></a>detail</code>;</td>

3022

<td class="struct_member_description">The detail passed on for this emission</td>

3023

3024

</tr>

3233

</colgroup>

3234

<tbody>

3235

<tr>

3236

<td class="struct_member_name"><a href="../glib/glib-Basic-Types.html#guint">guint</a> <code><a name="GSignalQuery.signal-id"></a>signal_id</code>;</td>

3236

<td class="struct_member_name"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <code><a name="GSignalQuery.signal-id"></a>signal_id</code>;</td>

3237

<td class="struct_member_description">The signal id of the signal being queried, or 0 if the

3238

signal to be queried was unknown.</td>

3239

3240

</tr>

3241

<tr>

3242

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

3242

<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="GSignalQuery.signal-name"></a>signal_name</code>;</td>

3243

<td class="struct_member_description">The signal name.</td>

3244

3245

</tr>

3259

3260

</tr>

3261

<tr>

3262

3263

<td class="struct_member_description">The number of parameters that user callbacks take.</td>

3264

3265

</tr>

3269

user callbacks, note that the effective callback signature is:

3270

3271

<code>return_type</code>

3272

callback (<a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> data1,

3272

callback (<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data1,

3273

[param_types param_names,]

3274

gpointer data2);

3275

</programlisting>. </td>

Older »