qcoreevent.cpp

\value ThreadChange The object is moved to another thread. This is the last event sent to this object in the previous thread. See QObject::moveToThread().

-

221

\value Timer Regular timer events (QTimerEvent).

-

222

\value ToolBarChange The toolbar button is toggled on \macos.

-

223

\value ToolTip A tooltip was requested (QHelpEvent).

-

224

\value ToolTipChange The widget's tooltip has changed.

-

225

\value TouchBegin Beginning of a sequence of touch-screen or track-pad events (QTouchEvent).

-

226

\value TouchCancel Cancellation of touch-event sequence (QTouchEvent).

-

227

\value TouchEnd End of touch-event sequence (QTouchEvent).

-

228

\value TouchUpdate Touch-screen event (QTouchEvent).

-

229

\value UngrabKeyboard Item loses keyboard grab (QGraphicsItem only).

-

230

\value UngrabMouse Item loses mouse grab (QGraphicsItem, QQuickItem).

-

231

\value UpdateLater The widget should be queued to be repainted at a later time.

-

232

\value UpdateRequest The widget should be repainted.

-

233

\value WhatsThis The widget should reveal "What's This?" help (QHelpEvent).

-

234

\value WhatsThisClicked A link in a widget's "What's This?" help was clicked.

-

235

\value Wheel Mouse wheel rolled (QWheelEvent).

-

236

\value WinEventAct A Windows-specific activation event has occurred.

-

237

\value WindowActivate Window was activated.

-

238

\value WindowBlocked The window is blocked by a modal dialog.

-

239

\value WindowDeactivate Window was deactivated.

-

240

\value WindowIconChange The window's icon has changed.

-

241

\value WindowStateChange The \l{QWindow::windowState()}{window's state} (minimized, maximized or full-screen) has changed (QWindowStateChangeEvent).

-

242

\value WindowTitleChange The window title has changed.

-

243

\value WindowUnblocked The window is unblocked after a modal dialog exited.

-

244

\value WinIdChange The window system identifer for this native widget has changed.

-

245

\value ZOrderChange The widget's z-order has changed. This event is never sent to top level windows.

-

246

-

247

User events should have values between \c User and \c{MaxUser}:

-

248

-

249

\value User User-defined event.

-

250

\value MaxUser Last user event ID.

-

251

-

252

For convenience, you can use the registerEventType() function to

-

253

register and reserve a custom event type for your

-

254

application. Doing so will allow you to avoid accidentally

-

255

re-using a custom event type already in use elsewhere in your

-

256

application.

-

257

-

258

\omitvalue AcceptDropsChange

-

259

\omitvalue ActivateControl

-

260

\omitvalue Create

-

261

\omitvalue DeactivateControl

-

262

\omitvalue Destroy

-

263

\omitvalue DragResponse

-

264

\omitvalue EmbeddingControl

-

265

\omitvalue HelpRequest

-

266

\omitvalue Quit

-

267

\omitvalue ShowWindowRequest

-

268

\omitvalue Speech

-

269

\omitvalue Style

-

270

\omitvalue StyleAnimationUpdate

-

271

\omitvalue ZeroTimerEvent

-

272

\omitvalue ApplicationActivate

-

273

\omitvalue ApplicationActivated

-

274

\omitvalue ApplicationDeactivate

-

275

\omitvalue ApplicationDeactivated

-

276

\omitvalue MacGLWindowChange

-

277

\omitvalue MacGLClearDrawable

-

278

\omitvalue NetworkReplyUpdated

-

279

\omitvalue FutureCallOut

-

280

\omitvalue NativeGesture

-

281

\omitvalue WindowChangeInternal

-

282

\omitvalue ScreenChangeInternal

-

283

*/

-

284

-

285

/*!

-

286

Contructs an event object of type \a type.

-

287

*/

-

288

QEvent::QEvent(Type type)

-

289

: d(0), t(type), posted(false), spont(false), m_accept(true)

-

290

{}

-

291

-

292

/*!

-

293

\internal

-

294

Attempts to copy the \a other event.

-

295

-

296

Copying events is a bad idea, yet some Qt 4 code does it (notably,

-

297

QApplication and the state machine).

-

298

*/

-

299

QEvent::QEvent(const QEvent &other)

-

300

: d(other.d), t(other.t), posted(other.posted), spont(other.spont),

-

301

m_accept(other.m_accept)

-

302

{

-

303

// if QEventPrivate becomes available, make sure to implement a

-

304

// virtual QEventPrivate *clone() const; function so we can copy here

-

305

Q_ASSERT_X(!d, "QEvent", "Impossible, this can't happen: QEventPrivate isn't defined anywhere");

-

306

}

-

307

-

308

/*!

-

309

\internal

-

310

Attempts to copy the \a other event.

-

311

-

312

Copying events is a bad idea, yet some Qt 4 code does it (notably,

-

313

QApplication and the state machine).

-

314

*/

-

315

QEvent &QEvent::operator=(const QEvent &other)

-

316

{

-

317

// if QEventPrivate becomes available, make sure to implement a

-

318

// virtual QEventPrivate *clone() const; function so we can copy here

-

319

Q_ASSERT_X(!other.d, "QEvent", "Impossible, this can't happen: QEventPrivate isn't defined anywhere");

-

320

-

321

t = other.t;

-

322

posted = other.posted;

-

323

spont = other.spont;

-

324

m_accept = other.m_accept;

-

325

return *this;

-

326

}

-

327

-

328

/*!

-

329

Destroys the event. If it was \l{QCoreApplication::postEvent()}{posted},

-

330

it will be removed from the list of events to be posted.

-

331

*/

-

332

-

333

QEvent::~QEvent()

-

334

{

-

335

if (posted && QCoreApplication::instance())

-

336

QCoreApplicationPrivate::removePostedEvent(this);

-

337

Q_ASSERT_X(!d, "QEvent", "Impossible, this can't happen: QEventPrivate isn't defined anywhere");

-

338

}

-

339

-

340

-

341

/*!

-

342

\property QEvent::accepted

-

343

the accept flag of the event object

-

344

-

345

Setting the accept parameter indicates that the event receiver

-

346

wants the event. Unwanted events might be propagated to the parent

-

347

widget. By default, isAccepted() is set to true, but don't rely on

-

348

this as subclasses may choose to clear it in their constructor.

-

349

-

350

For convenience, the accept flag can also be set with accept(),

-

351

and cleared with ignore().

-

352

*/

-

353

-

354

/*!

-

355

\fn void QEvent::accept()

-

356

-

357

Sets the accept flag of the event object, the equivalent of

-

358

calling setAccepted(true).

-

359

-

360

Setting the accept parameter indicates that the event receiver

-

361

wants the event. Unwanted events might be propagated to the parent

-

362

widget.

-

363

-

364

\sa ignore()

-

365

*/

-

366

-

367

-

368

/*!

-

369

\fn void QEvent::ignore()

-

370

-

371

Clears the accept flag parameter of the event object, the

-

372

equivalent of calling setAccepted(false).

-

373

-

374

Clearing the accept parameter indicates that the event receiver

-

375

does not want the event. Unwanted events might be propagated to the

-

376

parent widget.

-

377

-

378

\sa accept()

-

379

*/

-

380

-

381

-

382

/*!

-

383

\fn QEvent::Type QEvent::type() const

-

384

-

385

Returns the event type.

-

386

*/

-

387

-

388

/*!

-

389

\fn bool QEvent::spontaneous() const

-

390

-

391

Returns \c true if the event originated outside the application (a

-

392

system event); otherwise returns \c false.

-

393

-

394

The return value of this function is not defined for paint events.

-

395

*/

-

396

-

397

namespace {

-

398

template <size_t N>

-

399

struct QBasicAtomicBitField {

-

400

enum {

-

401

BitsPerInt = std::numeric_limits<uint>::digits,

-

402

NumInts = (N + BitsPerInt - 1) / BitsPerInt,

-

403

NumBits = N

-

404

};

-

405

-

406

// This atomic int points to the next (possibly) free ID saving

-

407

// the otherwise necessary scan through 'data':

-

408

QBasicAtomicInteger<uint> next;

-

409

QBasicAtomicInteger<uint> data[NumInts];

-

410

-

411

bool allocateSpecific(int which) Q_DECL_NOTHROW

-

412

{

-

413

QBasicAtomicInteger<uint> &entry = data[which / BitsPerInt];

-

414

const uint old = entry.load();

-

415

const uint bit = 1U << (which % BitsPerInt);

-

416

return !(old & bit) // wasn't taken

executed 129072 times by 3 tests: return !(old & bit) && entry.testAndSetRelaxed(old, old | bit);

Executed by:

tst_Gestures
tst_QEvent
tst_QWidget_window

129072

417

&& entry.testAndSetRelaxed(old, old | bit); // still wasn't taken

executed 129072 times by 3 tests: return !(old & bit) && entry.testAndSetRelaxed(old, old | bit);

Executed by:

tst_Gestures
tst_QEvent
tst_QWidget_window

129072

418

-

419

// don't update 'next' here - it's unlikely that it will need

-

420

// to be updated, in the general case, and having 'next'

-

421

// trailing a bit is not a problem, as it is just a starting

-

422

// hint for allocateNext(), which, when wrong, will just

-

423

// result in a few more rounds through the allocateNext()

-

424

// loop.

-

425

}

-

426

-

427

int allocateNext() Q_DECL_NOTHROW

-

428

{

-

429

// Unroll loop to iterate over ints, then bits? Would save

-

430

// potentially a lot of cmpxchgs, because we can scan the

-

431

// whole int before having to load it again.

-

432

-

433

// Then again, this should never execute many iterations, so

-

434

// leave like this for now:

-

435

for (uint i = next.load(); i < NumBits; ++i) {

i < NumBits	Description
TRUE	evaluated 64538 times by 3 tests Evaluated by: tst_Gestures tst_QEvent tst_QWidget_window
FALSE	evaluated 1 time by 1 test Evaluated by: tst_QEvent

1-64538

436

if (allocateSpecific(i)) {

allocateSpecific(i)	Description
TRUE	evaluated 7 times by 3 tests Evaluated by: tst_Gestures tst_QEvent tst_QWidget_window
FALSE	evaluated 64531 times by 1 test Evaluated by: tst_QEvent

7-64531

437

// remember next (possibly) free id:

-

438

const uint oldNext = next.load();

-

439

next.testAndSetRelaxed(oldNext, qMax(i + 1, oldNext));

-

440

return i;

executed 7 times by 3 tests: return i;

Executed by:

tst_Gestures
tst_QEvent
tst_QWidget_window

7

441

}

-

442

}

executed 64531 times by 1 test: end of block

Executed by:

tst_QEvent

64531

443

return -1;

executed 1 time by 1 test: return -1;

Executed by:

tst_QEvent

1

444

}

-

445

};

-

446

-

447

} // unnamed namespace

-

448

-

449

typedef QBasicAtomicBitField<QEvent::MaxUser - QEvent::User + 1> UserEventTypeRegistry;

-

450

-

451

static UserEventTypeRegistry userEventTypeRegistry;

-

452

-

453

static inline int registerEventTypeZeroBased(int id) Q_DECL_NOTHROW

-

454

{

-

455

// if the type hint hasn't been registered yet, take it:

-

456

if (id < UserEventTypeRegistry::NumBits && id >= 0 && userEventTypeRegistry.allocateSpecific(id))

id < UserEvent...istry::NumBits	Description
TRUE	evaluated 64535 times by 1 test Evaluated by: tst_QEvent
FALSE	evaluated 4 times by 3 tests Evaluated by: tst_Gestures tst_QEvent tst_QWidget_window

id >= 0	Description
TRUE	evaluated 64534 times by 1 test Evaluated by: tst_QEvent
FALSE	evaluated 1 time by 1 test Evaluated by: tst_QEvent

userEventTypeR...teSpecific(id)	Description
TRUE	evaluated 64531 times by 1 test Evaluated by: tst_QEvent
FALSE	evaluated 3 times by 1 test Evaluated by: tst_QEvent

1-64535

457

return id;

executed 64531 times by 1 test: return id;

Executed by:

tst_QEvent

64531

458

-

459

// otherwise, ignore hint:

-

460

return userEventTypeRegistry.allocateNext();

executed 8 times by 3 tests: return userEventTypeRegistry.allocateNext();

Executed by:

tst_Gestures
tst_QEvent
tst_QWidget_window

8

461

}

-

462

-

463

/*!

-

464

\since 4.4

-

465

\threadsafe

-

466

-

467

Registers and returns a custom event type. The \a hint provided

-

468

will be used if it is available, otherwise it will return a value

-

469

between QEvent::User and QEvent::MaxUser that has not yet been

-

470

registered. The \a hint is ignored if its value is not between

-

471

QEvent::User and QEvent::MaxUser.

-

472

-

473

Returns -1 if all available values are already taken or the

-

474

program is shutting down.

-

475

*/

-

476

int QEvent::registerEventType(int hint) Q_DECL_NOTHROW

-

477

{

-

478

const int result = registerEventTypeZeroBased(QEvent::MaxUser - hint);

-

479

return result < 0 ? -1 : QEvent::MaxUser - result ;

executed 64539 times by 3 tests: return result < 0 ? -1 : QEvent::MaxUser - result ;

Executed by:

tst_Gestures
tst_QEvent
tst_QWidget_window

64539

480

}

-

481

-

482

/*!

-

483

\class QTimerEvent

-

484

\inmodule QtCore

-

485

\brief The QTimerEvent class contains parameters that describe a

-

486

timer event.

-

487

-

488

\ingroup events

-

489

-

490

Timer events are sent at regular intervals to objects that have

-

491

started one or more timers. Each timer has a unique identifier. A

-

492

timer is started with QObject::startTimer().

-

493

-

494

The QTimer class provides a high-level programming interface that

-

495

uses signals instead of events. It also provides single-shot timers.

-

496

-

497

The event handler QObject::timerEvent() receives timer events.

-

498

-

499

\sa QTimer, QObject::timerEvent(), QObject::startTimer(),

-

500

QObject::killTimer()

-

501

*/

-

502

-

503

/*!

-

504

Constructs a timer event object with the timer identifier set to

-

505

\a timerId.

-

506

*/

-

507

QTimerEvent::QTimerEvent(int timerId)

-

508

: QEvent(Timer), id(timerId)

-

509

{}

-

510

-

511

/*!

-

512

\internal

-

513

*/

-

514

QTimerEvent::~QTimerEvent()

-

515

{

-

516

}

-

517

-

518

/*!

-

519

\fn int QTimerEvent::timerId() const

-

520

-

521

Returns the unique timer identifier, which is the same identifier

-

522

as returned from QObject::startTimer().

-

523

*/

-

524

-

525

/*!

-

526

\class QChildEvent

-

527

\inmodule QtCore

-

528

\brief The QChildEvent class contains event parameters for child object

-

529

events.

-

530

-

531

\ingroup events

-

532

-

533

Child events are sent immediately to objects when children are

-

534

added or removed.

-

535

-

536

In both cases you can only rely on the child being a QObject (or,

-

537

if QObject::isWidgetType() returns \c true, a QWidget). This is

-

538

because in the QEvent::ChildAdded case the child is not yet fully

-

539

constructed; in the QEvent::ChildRemoved case it might have

-

540

already been destructed.

-

541

-

542

The handler for these events is QObject::childEvent().

-

543

*/

-

544

-

545

/*!

-

546

Constructs a child event object of a particular \a type for the

-

547

\a child.

-

548

-

549

\a type can be QEvent::ChildAdded, QEvent::ChildRemoved,

-

550

or QEvent::ChildPolished.

-

551

-

552

\sa child()

-

553

*/

-

554

QChildEvent::QChildEvent(Type type, QObject *child)

-

555

: QEvent(type), c(child)

-

556

{}

-

557

-

558

/*!

-

559

\internal

-

560

*/

-

561

QChildEvent::~QChildEvent()

-

562

{

-

563

}

-

564

-

565

/*!

-

566

\fn QObject *QChildEvent::child() const

-

567

-

568

Returns the child object that was added or removed.

-

569

*/

-

570

-

571

/*!

-

572

\fn bool QChildEvent::added() const

-

573

-

574

Returns \c true if type() is QEvent::ChildAdded; otherwise returns

-

575

false.

-

576

*/

-

577

-

578

/*!

-

579

\fn bool QChildEvent::removed() const

-

580

-

581

Returns \c true if type() is QEvent::ChildRemoved; otherwise returns

-

582

false.

-

583

*/

-

584

-

585

/*!

-

586

\fn bool QChildEvent::polished() const

-

587

-

588

Returns \c true if type() is QEvent::ChildPolished; otherwise returns

-

589

false.

-

590

*/

-

591

-

592

-

593

/*!

-

594

\class QDynamicPropertyChangeEvent

-

595

\inmodule QtCore

-

596

\since 4.2

-

597

\brief The QDynamicPropertyChangeEvent class contains event parameters for dynamic

-

598

property change events.

-

599

-

600

\ingroup events

-

601

-

602

Dynamic property change events are sent to objects when properties are

-

603

dynamically added, changed or removed using QObject::setProperty().

-

604

*/

-

605

-

606

/*!

-

607

Constructs a dynamic property change event object with the property name set to

-

608

\a name.

-

609

*/

-

610

QDynamicPropertyChangeEvent::QDynamicPropertyChangeEvent(const QByteArray &name)

-

611

: QEvent(QEvent::DynamicPropertyChange), n(name)

-

612

{

-

613

}

-

614

-

615

/*!

-

616

\internal

-

617

*/

-

618

QDynamicPropertyChangeEvent::~QDynamicPropertyChangeEvent()

-

619

{

-

620

}

-

621

-

622

/*!

-

623

\fn QByteArray QDynamicPropertyChangeEvent::propertyName() const

-

624

-

625

Returns the name of the dynamic property that was added, changed or

-

626

removed.

-

627

-

628

\sa QObject::setProperty(), QObject::dynamicPropertyNames()

-

629

*/

-

630

-

631

/*!

-

632

Constructs a deferred delete event with an initial loopLevel() of zero.

-

633

*/

-

634

QDeferredDeleteEvent::QDeferredDeleteEvent()

-

635

: QEvent(QEvent::DeferredDelete)

-

636

, level(0)

-

637

{ }

-

638

-

639

/*!

-

640

\internal

-

641

*/

-

642

QDeferredDeleteEvent::~QDeferredDeleteEvent()

-

643

{ }

-

644

-

645

/*! \fn int QDeferredDeleteEvent::loopLevel() const

-

646

-

647

Returns the loop-level in which the event was posted. The

-

648

loop-level is set by QCoreApplication::postEvent().

-

649

-

650

\sa QObject::deleteLater()

-

651

*/

-

652

-

653

QT_END_NAMESPACE

-