~ubuntu-branches/ubuntu/wily/qtbase-opensource-src/wily

// more and not included here: http://developer.apple.com/library/mac/#documentation/UserExperience/Reference/Accessibility_RoleAttribute_Ref/Attributes.html

212

213

// MSAA

214

// quint64 alertLow : 1;

215

// quint64 alertMedium : 1;

216

// quint64 alertHigh : 1;

217

218

State() {

219

memset(this, 0, sizeof(State));

220

}

221

};

222

223

224

225

226

227

enum Role {

228

NoRole = 0x00000000,

229

TitleBar = 0x00000001,

230

MenuBar = 0x00000002,

231

ScrollBar = 0x00000003,

232

Grip = 0x00000004,

233

Sound = 0x00000005,

234

Cursor = 0x00000006,

235

Caret = 0x00000007,

236

AlertMessage = 0x00000008,

237

Window = 0x00000009,

238

Client = 0x0000000A,

239

PopupMenu = 0x0000000B,

240

MenuItem = 0x0000000C,

241

ToolTip = 0x0000000D,

242

Application = 0x0000000E,

243

Document = 0x0000000F,

244

Pane = 0x00000010,

245

Chart = 0x00000011,

246

Dialog = 0x00000012,

247

Border = 0x00000013,

248

Grouping = 0x00000014,

249

Separator = 0x00000015,

250

ToolBar = 0x00000016,

251

StatusBar = 0x00000017,

252

Table = 0x00000018,

253

ColumnHeader = 0x00000019,

254

RowHeader = 0x0000001A,

255

Column = 0x0000001B,

256

Row = 0x0000001C,

257

Cell = 0x0000001D,

258

Link = 0x0000001E,

259

HelpBalloon = 0x0000001F,

260

Assistant = 0x00000020,

261

List = 0x00000021,

262

ListItem = 0x00000022,

263

Tree = 0x00000023,

264

TreeItem = 0x00000024,

265

PageTab = 0x00000025,

266

PropertyPage = 0x00000026,

267

Indicator = 0x00000027,

268

Graphic = 0x00000028,

269

StaticText = 0x00000029,

270

EditableText = 0x0000002A, // Editable, selectable, etc.

271

Button = 0x0000002B,

272

#ifndef Q_QDOC

273

PushButton = Button, // deprecated

274

#endif

275

CheckBox = 0x0000002C,

276

RadioButton = 0x0000002D,

277

ComboBox = 0x0000002E,

278

// DropList = 0x0000002F,

279

ProgressBar = 0x00000030,

280

Dial = 0x00000031,

281

HotkeyField = 0x00000032,

282

Slider = 0x00000033,

283

SpinBox = 0x00000034,

284

Canvas = 0x00000035,

285

Animation = 0x00000036,

286

Equation = 0x00000037,

287

ButtonDropDown = 0x00000038,

288

ButtonMenu = 0x00000039,

289

ButtonDropGrid = 0x0000003A,

290

Whitespace = 0x0000003B,

291

PageTabList = 0x0000003C,

292

Clock = 0x0000003D,

293

Splitter = 0x0000003E,

294

// Reserved space in case MSAA roles needs to be added

295

296

// Additional Qt roles where enum value does not map directly to MSAA:

297

LayeredPane = 0x00000080,

298

Terminal = 0x00000081,

299

Desktop = 0x00000082,

300

UserRole = 0x0000ffff

301

};

302

303

enum Text {

304

Name = 0,

305

Description,

306

Value,

307

Help,

308

Accelerator,

309

DebugDescription,

310

UserText = 0x0000ffff

311

};

312

313

enum RelationFlag {

314

Label = 0x00000001,

315

Labelled = 0x00000002,

316

Controller = 0x00000004,

317

Controlled = 0x00000008,

318

AllRelations = 0xffffffff

319

};

320

Q_DECLARE_FLAGS(Relation, RelationFlag)

321

322

enum InterfaceType

323

{

324

TextInterface,

325

EditableTextInterface,

326

ValueInterface,

327

ActionInterface,

328

ImageInterface,

329

TableInterface,

330

TableCellInterface

331

};

332

333

typedef QAccessibleInterface*(*InterfaceFactory)(const QString &key, QObject*);

334

typedef void(*UpdateHandler)(QAccessibleEvent *event);

335

typedef void(*RootObjectHandler)(QObject*);

336

337

static void installFactory(InterfaceFactory);

338

static void removeFactory(InterfaceFactory);

339

static UpdateHandler installUpdateHandler(UpdateHandler);

340

static RootObjectHandler installRootObjectHandler(RootObjectHandler);

341

342

static QAccessibleInterface *queryAccessibleInterface(QObject *);

343

#if QT_DEPRECATED_SINCE(5, 0)

344

QT_DEPRECATED static inline void updateAccessibility(QObject *object, int child, Event reason);

345

#endif

346

static void updateAccessibility(QAccessibleEvent *event);

347

348

static bool isActive();

349

static void setRootObject(QObject *object);

350

351

static void cleanup();

352

353

private:

354

static UpdateHandler updateHandler;

355

static RootObjectHandler rootObjectHandler;

356

357

/*! @internal

358

This class is purely a collection of enums and static functions,

359

it is not supposed to be instantiated.

360

361

QAccessible() {}

362

};

363

364

Q_GUI_EXPORT bool operator==(const QAccessible::State &first, const QAccessible::State &second);

365

366

Q_DECLARE_OPERATORS_FOR_FLAGS(QAccessible::Relation)

367

368

class QAccessible2Interface;

369

class QAccessibleTextInterface;

370

class QAccessibleEditableTextInterface;

371

class QAccessibleValueInterface;

372

class QAccessibleActionInterface;

373

class QAccessibleImageInterface;

374

class QAccessibleTableInterface;

375

class QAccessibleTableCellInterface;

376

377

class Q_GUI_EXPORT QAccessibleInterface

378

{

379

public:

380

virtual ~QAccessibleInterface() {}

381

// check for valid pointers

382

virtual bool isValid() const = 0;

383

virtual QObject *object() const = 0;

384

virtual QWindow *window() const;

385

386

// relations

387

virtual QVector<QPair<QAccessibleInterface*, QAccessible::Relation> > relations(QAccessible::Relation match = QAccessible::AllRelations) const;

388

virtual QAccessibleInterface *focusChild() const;

389

390

virtual QAccessibleInterface *childAt(int x, int y) const = 0;

391

392

// navigation, hierarchy

393

virtual QAccessibleInterface *parent() const = 0;

394

virtual QAccessibleInterface *child(int index) const = 0;

395

virtual int childCount() const = 0;

396

virtual int indexOfChild(const QAccessibleInterface *) const = 0;

397

398

// properties and state

399

virtual QString text(QAccessible::Text t) const = 0;

400

virtual void setText(QAccessible::Text t, const QString &text) = 0;

401

virtual QRect rect() const = 0;

402

virtual QAccessible::Role role() const = 0;

403

virtual QAccessible::State state() const = 0;

404

405

virtual QColor foregroundColor() const;

406

virtual QColor backgroundColor() const;

407

408

inline QAccessibleTextInterface *textInterface()

409

{ return reinterpret_cast<QAccessibleTextInterface *>(interface_cast(QAccessible::TextInterface)); }

410

411

inline QAccessibleEditableTextInterface *editableTextInterface()

412

{ return reinterpret_cast<QAccessibleEditableTextInterface *>(interface_cast(QAccessible::EditableTextInterface)); }

413

414

inline QAccessibleValueInterface *valueInterface()

415

{ return reinterpret_cast<QAccessibleValueInterface *>(interface_cast(QAccessible::ValueInterface)); }

416

417

inline QAccessibleActionInterface *actionInterface()

418

{ return reinterpret_cast<QAccessibleActionInterface *>(interface_cast(QAccessible::ActionInterface)); }

419

420

inline QAccessibleImageInterface *imageInterface()

421

{ return reinterpret_cast<QAccessibleImageInterface *>(interface_cast(QAccessible::ImageInterface)); }

422

423

inline QAccessibleTableInterface *tableInterface()

424

{ return reinterpret_cast<QAccessibleTableInterface *>(interface_cast(QAccessible::TableInterface)); }

425

426

inline QAccessibleTableCellInterface *tableCellInterface()

427

{ return reinterpret_cast<QAccessibleTableCellInterface *>(interface_cast(QAccessible::TableCellInterface)); }

428

429

virtual void virtual_hook(int id, void *data);

430

431

virtual void *interface_cast(QAccessible::InterfaceType)

432

{ return 0; }

433

private:

434

};

435

436

class Q_GUI_EXPORT QAccessibleEvent

437

{

438

Q_DISABLE_COPY(QAccessibleEvent)

439

public:

440

inline QAccessibleEvent(QObject *obj, QAccessible::Event typ)

441

: m_type(typ), m_object(obj), m_child(-1)

442

{

443

Q_ASSERT(obj);

444

// All events below have a subclass of QAccessibleEvent.

445

// Use the subclass, since it's expected that it's possible to cast to that.

446

Q_ASSERT(m_type != QAccessible::ValueChanged);

447

Q_ASSERT(m_type != QAccessible::StateChanged);

448

Q_ASSERT(m_type != QAccessible::TextCaretMoved);

449

Q_ASSERT(m_type != QAccessible::TextSelectionChanged);

450

Q_ASSERT(m_type != QAccessible::TextInserted);

451

Q_ASSERT(m_type != QAccessible::TextRemoved);

452

Q_ASSERT(m_type != QAccessible::TextUpdated);

453

Q_ASSERT(m_type != QAccessible::TableModelChanged);

454

}

455

456

virtual ~QAccessibleEvent()

457

{}

458

459

QAccessible::Event type() const { return m_type; }

460

QObject *object() const { return m_object; }

461

462

void setChild(int chld) { m_child = chld; }

463

int child() const { return m_child; }

464

465

virtual QAccessibleInterface *accessibleInterface() const;

466

467

protected:

468

QAccessible::Event m_type;

469

QObject *m_object;

470

int m_child;

471

};

472

473

class Q_GUI_EXPORT QAccessibleStateChangeEvent :public QAccessibleEvent

474

{

475

public:

476

inline QAccessibleStateChangeEvent(QObject *obj, QAccessible::State state)

477

: QAccessibleEvent(obj, QAccessible::InvalidEvent), m_changedStates(state)

478

{

479

m_type = QAccessible::StateChanged;

480

}

481

482

QAccessible::State changedStates() const {

483

return m_changedStates;

484

}

485

486

protected:

487

QAccessible::State m_changedStates;

488

};

489

490

// Update the cursor and optionally the selection.

491

class Q_GUI_EXPORT QAccessibleTextCursorEvent : public QAccessibleEvent

492

{

493

public:

494

inline QAccessibleTextCursorEvent(QObject *obj, int cursorPos)

495

: QAccessibleEvent(obj, QAccessible::InvalidEvent)

496

, m_cursorPosition(cursorPos)

497

{

498

m_type = QAccessible::TextCaretMoved;

499

}

500

501

void setCursorPosition(int position) { m_cursorPosition = position; }

502

int cursorPosition() const { return m_cursorPosition; }

503

504

protected:

505

int m_cursorPosition;

506

};

507

508

// Updates the cursor position simultaneously. By default the cursor is set to the end of the selection.

509

class Q_GUI_EXPORT QAccessibleTextSelectionEvent : public QAccessibleTextCursorEvent

510

{

511

public:

512

inline QAccessibleTextSelectionEvent(QObject *obj, int start, int end)

513

: QAccessibleTextCursorEvent(obj, (start == -1) ? 0 : end)

514

, m_selectionStart(start), m_selectionEnd(end)

515

{

516

m_type = QAccessible::TextSelectionChanged;

517

}

518

519

void setSelection(int start, int end) {

520

m_selectionStart = start;

521

m_selectionEnd = end;

522

}

523

524

int selectionStart() const { return m_selectionStart; }

525

int selectionEnd() const { return m_selectionEnd; }

526

527

protected:

528

int m_selectionStart;

529

int m_selectionEnd;

530

};

531

532

class Q_GUI_EXPORT QAccessibleTextInsertEvent : public QAccessibleTextCursorEvent

533

{

534

public:

535

inline QAccessibleTextInsertEvent(QObject *obj, int position, const QString &text)

536

: QAccessibleTextCursorEvent(obj, position + text.length())

537

, m_position(position), m_text(text)

538

{

539

m_type = QAccessible::TextInserted;

540

}

541

542

QString textInserted() const {

543

return m_text;

544

}

545

int changePosition() const {

546

return m_position;

547

}

548

549

protected:

550

int m_position;

551

QString m_text;

552

};

553

554

class Q_GUI_EXPORT QAccessibleTextRemoveEvent : public QAccessibleTextCursorEvent

555

{

556

public:

557

inline QAccessibleTextRemoveEvent(QObject *obj, int position, const QString &text)

558

: QAccessibleTextCursorEvent(obj, position)

559

, m_position(position), m_text(text)

560

{

561

m_type = QAccessible::TextRemoved;

562

}

563

564

QString textRemoved() const {

565

return m_text;

566

}

567

int changePosition() const {

568

return m_position;

569

}

570

571

protected:

572

int m_position;

573

QString m_text;

574

};

575

576

class Q_GUI_EXPORT QAccessibleTextUpdateEvent : public QAccessibleTextCursorEvent

577

{

578

public:

579

inline QAccessibleTextUpdateEvent(QObject *obj, int position, const QString &oldText, const QString &text)

580

: QAccessibleTextCursorEvent(obj, position + text.length())

581

, m_position(position), m_oldText(oldText), m_text(text)

582

{

583

m_type = QAccessible::TextUpdated;

584

}

585

QString textRemoved() const {

586

return m_oldText;

587

}

588

QString textInserted() const {

589

return m_text;

590

}

591

int changePosition() const {

592

return m_position;

593

}

594

595

protected:

596

int m_position;

597

QString m_oldText;

598

QString m_text;

599

};

600

601

class Q_GUI_EXPORT QAccessibleValueChangeEvent : public QAccessibleEvent

602

{

603

public:

604

inline QAccessibleValueChangeEvent(QObject *obj, const QVariant &val)

605

: QAccessibleEvent(obj, QAccessible::InvalidEvent)

606

, m_value(val)

607

{

608

m_type = QAccessible::ValueChanged;

609

}

610

611

void setValue(const QVariant & val) { m_value= val; }

612

QVariant value() const { return m_value; }

613

614

protected:

615

QVariant m_value;

616

};

617

618

class Q_GUI_EXPORT QAccessibleTableModelChangeEvent : public QAccessibleEvent

619

{

620

public:

621

enum ModelChangeType {

622

ModelReset,

623

DataChanged,

624

RowsInserted,

625

ColumnsInserted,

626

RowsRemoved,

627

ColumnsRemoved

628

};

629

630

inline QAccessibleTableModelChangeEvent(QObject *obj, ModelChangeType changeType)

631

: QAccessibleEvent(obj, QAccessible::InvalidEvent)

632

, m_modelChangeType(changeType)

633

, m_firstRow(-1), m_firstColumn(-1), m_lastRow(-1), m_lastColumn(-1)

634

{

635

m_type = QAccessible::TableModelChanged;

636

}

637

void setModelChangeType(ModelChangeType changeType) { m_modelChangeType = changeType; }

638

ModelChangeType modelChangeType() const { return m_modelChangeType; }

639

640

void setFirstRow(int row) { m_firstRow = row; }

641

void setFirstColumn(int col) { m_firstColumn = col; }

642

void setLastRow(int row) { m_lastRow = row; }

643

void setLastColumn(int col) { m_lastColumn = col; }

644

int firstRow() const { return m_firstRow; }

645

int firstColumn() const { return m_firstColumn; }

646

int lastRow() const { return m_lastRow; }

647

int lastColumn() const { return m_lastColumn; }

648

649

protected:

650

ModelChangeType m_modelChangeType;

651

int m_firstRow;

652

int m_firstColumn;

653

int m_lastRow;

654

int m_lastColumn;

655

};

656

657

#define QAccessibleInterface_iid "org.qt-project.Qt.QAccessibleInterface"

658

Q_DECLARE_INTERFACE(QAccessibleInterface, QAccessibleInterface_iid)

659

660

Q_GUI_EXPORT const char *qAccessibleRoleString(QAccessible::Role role);

661

Q_GUI_EXPORT const char *qAccessibleEventString(QAccessible::Event event);

662

663

#ifndef QT_NO_DEBUG_STREAM

664

Q_GUI_EXPORT QDebug operator<<(QDebug d, const QAccessibleInterface *iface);

665

Q_GUI_EXPORT QDebug operator<<(QDebug d, const QAccessibleEvent &ev);

666

#endif

667

668

#if QT_DEPRECATED_SINCE(5, 0)

669

inline void QAccessible::updateAccessibility(QObject *object, int child, Event reason)

670

{

671

Q_ASSERT(object);

672

673

QAccessibleEvent ev(object, reason);

674

ev.setChild(child);

675

updateAccessibility(&ev);

676

}

677

#endif

678

679

QT_END_NAMESPACE

680

681

QT_END_HEADER

682

683

#endif // QACCESSIBLE_H

Older »