~bratsche/ubuntu/maverick/gtk+2.0/menu-activation-fix

in conjunction with <a href="gdk-Threads.html#gdk-threads-enter"><code class="function">gdk_threads_enter()</code></a> and <a href="gdk-Threads.html#gdk-threads-leave"><code class="function">gdk_threads_leave()</code></a>.

332

347

</div>

333

348

<hr>

334

349

335

350

336

351

<a name="gdk-threads-enter"></a>gdk_threads_enter ()</h3>

337

<a class="indexterm" name="id2792964"></a><pre class="programlisting">void gdk_threads_enter (void);</pre>

352

<a class="indexterm" name="id2850711"></a><pre class="programlisting">void gdk_threads_enter (void);</pre>

338

353

<p>

339

354

This macro marks the beginning of a critical section

340

355

in which GDK and GTK+ functions can be called.

344

359

</div>

345

360

<hr>

346

361

347

362

348

363

<a name="gdk-threads-leave"></a>gdk_threads_leave ()</h3>

349

<a class="indexterm" name="id2793001"></a><pre class="programlisting">void gdk_threads_leave (void);</pre>

364

<a class="indexterm" name="id2850748"></a><pre class="programlisting">void gdk_threads_leave (void);</pre>

350

365

<p>

351

366

Leaves a critical region begun with <a href="gdk-Threads.html#gdk-threads-enter"><code class="function">gdk_threads_enter()</code></a>.

352

367

</p>

353

368

</div>

354

369

<hr>

355

370

356

371

357

372

<a name="gdk-threads-mutex"></a>gdk_threads_mutex</h3>

358

<a class="indexterm" name="id2793049"></a><pre class="programlisting">extern GMutex *gdk_threads_mutex; /* private */

373

<a class="indexterm" name="id2850796"></a><pre class="programlisting">extern GMutex *gdk_threads_mutex; /* private */

359

374

</pre>

360

375

361

376

<h3 class="title">Warning</h3>

368

383

</div>

369

384

<hr>

370

385

371

386

372

387

<a name="gdk-threads-set-lock-functions"></a>gdk_threads_set_lock_functions ()</h3>

373

<a class="indexterm" name="id2793123"></a><pre class="programlisting">void gdk_threads_set_lock_functions (GCallback enter_fn,

388

<a class="indexterm" name="id2850871"></a><pre class="programlisting">void gdk_threads_set_lock_functions (GCallback enter_fn,

374

389

GCallback leave_fn);</pre>

375

390

<p>

376

391

Allows the application to replace the standard method that

419

434

<p class="since">Since 2.4

420

435

</p>

421

436

</div>

437

<hr>

438

439

440

<a name="gdk-threads-add-idle"></a>gdk_threads_add_idle ()</h3>

441

<a class="indexterm" name="id2851064"></a><pre class="programlisting">guint gdk_threads_add_idle (GSourceFunc function,

442

gpointer data);</pre>

443

<p>

444

A wrapper for the common usage of <a href="gdk-Threads.html#gdk-threads-add-idle-full"><code class="function">gdk_threads_add_idle_full()</code></a>

445

assigning the default priority, <span class="type">G_PRIORITY_DEFAULT_IDLE</span>.

446

</p>

447

<p>

448

See <a href="gdk-Threads.html#gdk-threads-add-idle-full"><code class="function">gdk_threads_add_idle_full()</code></a>.</p>

449

<p>

450

451

</p>

452

453

454

<tbody>

455

<tr>

456

<td><span class="term"><em class="parameter"><code>function</code></em> :</span></td>

457

<td> function to call

458

</td>

459

</tr>

460

<tr>

461

462

<td> data to pass to <em class="parameter"><code>function</code></em>

463

</td>

464

</tr>

465

<tr>

466

<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

467

<td> the ID (greater than 0) of the event source.

468

469

</td>

470

</tr>

471

</tbody>

472

</table></div>

473

<p class="since">Since 2.12

474

</p>

475

</div>

476

<hr>

477

478

479

<a name="gdk-threads-add-idle-full"></a>gdk_threads_add_idle_full ()</h3>

480

<a class="indexterm" name="id2851213"></a><pre class="programlisting">guint gdk_threads_add_idle_full (gint priority,

481

GSourceFunc function,

482

gpointer data,

483

GDestroyNotify notify);</pre>

484

<p>

485

Adds a function to be called whenever there are no higher priority

486

events pending. If the function returns <code class="literal">FALSE</code> it is automatically

487

removed from the list of event sources and will not be called again.

488

</p>

489

<p>

490

This variant of <code class="function">g_idle_add_full()</code> calls <em class="parameter"><code>function</code></em> with the GDK lock

491

held. It can be thought of a MT-safe version for GTK+ widgets for the

492

following use case, where you have to worry about <code class="function">idle_callback()</code>

493

running in thread A and accessing <em class="parameter"><code>self</code></em> after it has been finalized

494

in thread B:

495

</p>

496

<p>

497

</p>

498

499

static gboolean idle_callback (gpointer data)

500

{

501

SomeWidget *self = data;

502

503

/* do stuff with self */

504

505

self->idle_id = 0;

506

507

return FALSE;

508

}

509

510

static void some_widget_do_stuff_later (SomeWidget *self)

511

{

512

self->idle_id = g_idle_add (idle_callback, self)

513

}

514

515

static void some_widget_finalize (GObject *object)

516

{

517

SomeWidget *self = SOME_WIDGET(object);

518

519

if (self->idle_id)

520

g_source_remove (self->idle_id);

521

522

G_OBJECT_CLASS (parent_class)->finalize (object);

523

}

524

</pre></div>

525

<p>

526

527

</p>

528

529

530

<tbody>

531

<tr>

532

<td><span class="term"><em class="parameter"><code>priority</code></em> :</span></td>

533

<td> the priority of the idle source. Typically this will be in the

534

range btweeen <span class="type">G_PRIORITY_DEFAULT_IDLE</span> and <span class="type">G_PRIORITY_HIGH_IDLE</span>

535

</td>

536

</tr>

537

<tr>

538

<td><span class="term"><em class="parameter"><code>function</code></em> :</span></td>

539

<td> function to call

540

</td>

541

</tr>

542

<tr>

543

544

<td> data to pass to <em class="parameter"><code>function</code></em>

545

</td>

546

</tr>

547

<tr>

548

<td><span class="term"><em class="parameter"><code>notify</code></em> :</span></td>

549

<td> function to call when the idle is removed, or <a

550

href="../liboil/liboil-liboiljunk.html#NULL:CAPS"

551

><code class="literal">NULL</code></a>

552

</td>

553

</tr>

554

<tr>

555

<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

556

<td> the ID (greater than 0) of the event source.

557

558

</td>

559

</tr>

560

</tbody>

561

</table></div>

562

<p class="since">Since 2.12

563

</p>

564

</div>

565

<hr>

566

567

568

<a name="gdk-threads-add-timeout"></a>gdk_threads_add_timeout ()</h3>

569

<a class="indexterm" name="id2851478"></a><pre class="programlisting">guint gdk_threads_add_timeout (guint interval,

570

GSourceFunc function,

571

gpointer data);</pre>

572

<p>

573

A wrapper for the common usage of <a href="gdk-Threads.html#gdk-threads-add-timeout-full"><code class="function">gdk_threads_add_timeout_full()</code></a>

574

assigning the default priority, <span class="type">G_PRIORITY_DEFAULT</span>.

575

</p>

576

<p>

577

See <a href="gdk-Threads.html#gdk-threads-add-timeout-full"><code class="function">gdk_threads_add_timeout_full()</code></a>.</p>

578

<p>

579

580

</p>

581

582

583

<tbody>

584

<tr>

585

<td><span class="term"><em class="parameter"><code>interval</code></em> :</span></td>

586

<td> the time between calls to the function, in milliseconds

587

(1/1000ths of a second)

588

</td>

589

</tr>

590

<tr>

591

<td><span class="term"><em class="parameter"><code>function</code></em> :</span></td>

592

<td> function to call

593

</td>

594

</tr>

595

<tr>

596

597

<td> data to pass to <em class="parameter"><code>function</code></em>

598

</td>

599

</tr>

600

<tr>

601

<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

602

<td> the ID (greater than 0) of the event source.

603

604

</td>

605

</tr>

606

</tbody>

607

</table></div>

608

<p class="since">Since 2.12

609

</p>

610

</div>

611

<hr>

612

613

614

<a name="gdk-threads-add-timeout-full"></a>gdk_threads_add_timeout_full ()</h3>

615

<a class="indexterm" name="id2851649"></a><pre class="programlisting">guint gdk_threads_add_timeout_full (gint priority,

616

guint interval,

617

GSourceFunc function,

618

gpointer data,

619

GDestroyNotify notify);</pre>

620

<p>

621

Sets a function to be called at regular intervals holding the GDK lock,

622

with the given priority. The function is called repeatedly until it

623

returns <code class="literal">FALSE</code>, at which point the timeout is automatically destroyed

624

and the function will not be called again. The <em class="parameter"><code>notify</code></em> function is

625

called when the timeout is destroyed. The first call to the

626

function will be at the end of the first <em class="parameter"><code>interval</code></em>.

627

</p>

628

<p>

629

Note that timeout functions may be delayed, due to the processing of other

630

event sources. Thus they should not be relied on for precise timing.

631

After each call to the timeout function, the time of the next

632

timeout is recalculated based on the current time and the given interval

633

(it does not try to 'catch up' time lost in delays).

634

</p>

635

<p>

636

This variant of <code class="function">g_timeout_add_full()</code> can be thought of a MT-safe version

637

for GTK+ widgets for the following use case:

638

</p>

639

<p>

640

</p>

641

642

static gboolean timeout_callback (gpointer data)

643

{

644

SomeWidget *self = data;

645

646

/* do stuff with self */

647

648

self->timeout_id = 0;

649

650

return FALSE;

651

}

652

653

static void some_widget_do_stuff_later (SomeWidget *self)

654

{

655

self->timeout_id = g_timeout_add (timeout_callback, self)

656

}

657

658

static void some_widget_finalize (GObject *object)

659

{

660

SomeWidget *self = SOME_WIDGET(object);

661

662

if (self->timeout_id)

663

g_source_remove (self->timeout_id);

664

665

G_OBJECT_CLASS (parent_class)->finalize (object);

666

}

667

</pre></div>

668

<p>

669

670

</p>

671

672

673

<tbody>

674

<tr>

675

<td><span class="term"><em class="parameter"><code>priority</code></em> :</span></td>

676

<td> the priority of the timeout source. Typically this will be in the

677

range between <span class="type">G_PRIORITY_DEFAULT_IDLE</span> and <span class="type">G_PRIORITY_HIGH_IDLE</span>.

678

</td>

679

</tr>

680

<tr>

681

<td><span class="term"><em class="parameter"><code>interval</code></em> :</span></td>

682

<td> the time between calls to the function, in milliseconds

683

(1/1000ths of a second)

684

</td>

685

</tr>

686

<tr>

687

<td><span class="term"><em class="parameter"><code>function</code></em> :</span></td>

688

<td> function to call

689

</td>

690

</tr>

691

<tr>

692

693

<td> data to pass to <em class="parameter"><code>function</code></em>

694

</td>

695

</tr>

696

<tr>

697

<td><span class="term"><em class="parameter"><code>notify</code></em> :</span></td>

698

<td> function to call when the timeout is removed, or <a

699

href="../liboil/liboil-liboiljunk.html#NULL:CAPS"

700

><code class="literal">NULL</code></a>

701

</td>

702

</tr>

703

<tr>

704

<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>

705

<td> the ID (greater than 0) of the event source.

706

707

</td>

708

</tr>

709

</tbody>

710

</table></div>

711

<p class="since">Since 2.12

712

</p>

713

</div>

422

714

</div>

423

715

</div>

424

716

</body>

Older »