Qt 4.8
Public Functions | Protected Functions | List of all members
QAccessibleIconView Class Reference

The QAccessibleIconView class implements the QAccessibleInterface for icon views. More...

#include <qaccessiblecompat.h>

Inheritance diagram for QAccessibleIconView:
Q3AccessibleScrollView QAccessibleWidget QAccessibleObject QAccessibleInterface QAccessible

Public Functions

void clearSelection ()
 
int itemAt (int x, int y) const
 
int itemCount () const
 
QRect itemRect (int item) const
 
 QAccessibleIconView (QWidget *o)
 Constructs a QAccessibleIconView object for a widget. More...
 
Role role (int child) const
 
QVector< int > selection () const
 
bool setSelected (int child, bool on, bool extend)
 
State state (int child) const
 
QString text (Text t, int child) const
 
- Public Functions inherited from Q3AccessibleScrollView
 Q3AccessibleScrollView (QWidget *w, Role role)
 Constructs a Q3AccessibleScrollView object for a widget. More...
 
- Public Functions inherited from QAccessibleWidget
QString actionText (int action, Text t, int child) const
 Reimplemented Function More...
 
int childAt (int x, int y) const
 Reimplemented Function More...
 
int childCount () const
 Reimplemented Function More...
 
bool doAction (int action, int child, const QVariantList &params)
 Reimplemented Function More...
 
int indexOfChild (const QAccessibleInterface *child) const
 Reimplemented Function More...
 
int navigate (RelationFlag rel, int entry, QAccessibleInterface **target) const
 Reimplemented Function More...
 
 QAccessibleWidget (QWidget *o, Role r=Client, const QString &name=QString())
 Creates a QAccessibleWidget object for widget w. More...
 
QRect rect (int child) const
 Reimplemented Function More...
 
Relation relationTo (int child, const QAccessibleInterface *other, int otherChild) const
 Reimplemented Function More...
 
int userActionCount (int child) const
 Reimplemented Function More...
 
- Public Functions inherited from QAccessibleObject
bool isValid () const
 Reimplemented Function More...
 
QObjectobject () const
 Reimplemented Function More...
 
 QAccessibleObject (QObject *object)
 Creates a QAccessibleObject for object. More...
 
void setText (Text t, int child, const QString &text)
 Reimplemented Function More...
 
- Public Functions inherited from QAccessibleInterface
QAccessibleActionInterfaceactionInterface ()
 
QColor backgroundColor ()
 
QAccessibleEditableTextInterfaceeditableTextInterface ()
 
QColor foregroundColor ()
 
QAccessibleImageInterfaceimageInterface ()
 
QVariant invokeMethod (Method method, int child=0, const QVariantList &params=QVariantList())
 Invokes a method on child with the given parameters params and returns the result of the operation as QVariant. More...
 
QSet< MethodsupportedMethods ()
 Returns a QSet of QAccessible::Method that are supported by this accessible interface. More...
 
QAccessibleTable2Interfacetable2Interface ()
 
QAccessibleTableInterfacetableInterface ()
 
QAccessibleTextInterfacetextInterface ()
 
QAccessibleValueInterfacevalueInterface ()
 
virtual ~QAccessibleInterface ()
 Destroys the object. More...
 

Protected Functions

Q3IconView * iconView () const
 Returns the icon view. More...
 
- Protected Functions inherited from QAccessibleWidget
void addControllingSignal (const QString &signal)
 Registers signal as a controlling signal. More...
 
QObjectparentObject () const
 Returns the associated widget's parent object, which is either the parent widget, or qApp for top-level widgets. More...
 
void setAccelerator (const QString &accel)
 Sets the accelerator of this interface implementation to accel. More...
 
void setDescription (const QString &desc)
 Sets the description of this interface implementation to desc. More...
 
void setHelp (const QString &help)
 Sets the help of this interface implementation to help. More...
 
void setValue (const QString &value)
 Sets the value of this interface implementation to value. More...
 
QWidgetwidget () const
 Returns the associated widget. More...
 
 ~QAccessibleWidget ()
 Destroys this object. More...
 
- Protected Functions inherited from QAccessibleObject
virtual ~QAccessibleObject ()
 Destroys the QAccessibleObject. More...
 

Additional Inherited Members

- Public Types inherited from QAccessible
enum  Action {
  DefaultAction = 0, Press = -1, FirstStandardAction = Press, SetFocus = -2,
  Increase = -3, Decrease = -4, Accept = -5, Cancel = -6,
  Select = -7, ClearSelection = -8, RemoveSelection = -9, ExtendSelection = -10,
  AddToSelection = -11, LastStandardAction = AddToSelection
}
 This enum describes the possible types of action that can occur. More...
 
enum  Event {
  SoundPlayed = 0x0001, Alert = 0x0002, ForegroundChanged = 0x0003, MenuStart = 0x0004,
  MenuEnd = 0x0005, PopupMenuStart = 0x0006, PopupMenuEnd = 0x0007, ContextHelpStart = 0x000C,
  ContextHelpEnd = 0x000D, DragDropStart = 0x000E, DragDropEnd = 0x000F, DialogStart = 0x0010,
  DialogEnd = 0x0011, ScrollingStart = 0x0012, ScrollingEnd = 0x0013, MenuCommand = 0x0018,
  ActionChanged = 0x0101, ActiveDescendantChanged = 0x0102, AttributeChanged = 0x0103, DocumentContentChanged = 0x0104,
  DocumentLoadComplete = 0x0105, DocumentLoadStopped = 0x0106, DocumentReload = 0x0107, HyperlinkEndIndexChanged = 0x0108,
  HyperlinkNumberOfAnchorsChanged = 0x0109, HyperlinkSelectedLinkChanged = 0x010A, HypertextLinkActivated = 0x010B, HypertextLinkSelected = 0x010C,
  HyperlinkStartIndexChanged = 0x010D, HypertextChanged = 0x010E, HypertextNLinksChanged = 0x010F, ObjectAttributeChanged = 0x0110,
  PageChanged = 0x0111, SectionChanged = 0x0112, TableCaptionChanged = 0x0113, TableColumnDescriptionChanged = 0x0114,
  TableColumnHeaderChanged = 0x0115, TableModelChanged = 0x0116, TableRowDescriptionChanged = 0x0117, TableRowHeaderChanged = 0x0118,
  TableSummaryChanged = 0x0119, TextAttributeChanged = 0x011A, TextCaretMoved = 0x011B, TextColumnChanged = 0x011D,
  TextInserted = 0x011E, TextRemoved = 0x011F, TextUpdated = 0x0120, TextSelectionChanged = 0x0121,
  VisibleDataChanged = 0x0122, ObjectCreated = 0x8000, ObjectDestroyed = 0x8001, ObjectShow = 0x8002,
  ObjectHide = 0x8003, ObjectReorder = 0x8004, Focus = 0x8005, Selection = 0x8006,
  SelectionAdd = 0x8007, SelectionRemove = 0x8008, SelectionWithin = 0x8009, StateChanged = 0x800A,
  LocationChanged = 0x800B, NameChanged = 0x800C, DescriptionChanged = 0x800D, ValueChanged = 0x800E,
  ParentChanged = 0x800F, HelpChanged = 0x80A0, DefaultActionChanged = 0x80B0, AcceleratorChanged = 0x80C0
}
 This enum type defines accessible event types. More...
 
typedef QAccessibleInterface *(* InterfaceFactory) (const QString &key, QObject *)
 This is a typedef for a pointer to a function with the following signature: More...
 
enum  Method {
  ListSupportedMethods = 0, SetCursorPosition = 1, GetCursorPosition = 2, ForegroundColor = 3,
  BackgroundColor = 4
}
 This enum describes the possible types of methods that can be invoked on an accessible object. More...
 
enum  RelationFlag {
  Unrelated = 0x00000000, Self = 0x00000001, Ancestor = 0x00000002, Child = 0x00000004,
  Descendent = 0x00000008, Sibling = 0x00000010, HierarchyMask = 0x000000ff, Up = 0x00000100,
  Down = 0x00000200, Left = 0x00000400, Right = 0x00000800, Covers = 0x00001000,
  Covered = 0x00002000, GeometryMask = 0x0000ff00, FocusChild = 0x00010000, Label = 0x00020000,
  Labelled = 0x00040000, Controller = 0x00080000, Controlled = 0x00100000, LogicalMask = 0x00ff0000
}
 This enum type defines bit flags that can be combined to indicate the relationship between two accessible objects. More...
 
enum  Role {
  NoRole = 0x00000000, TitleBar = 0x00000001, MenuBar = 0x00000002, ScrollBar = 0x00000003,
  Grip = 0x00000004, Sound = 0x00000005, Cursor = 0x00000006, Caret = 0x00000007,
  AlertMessage = 0x00000008, Window = 0x00000009, Client = 0x0000000A, PopupMenu = 0x0000000B,
  MenuItem = 0x0000000C, ToolTip = 0x0000000D, Application = 0x0000000E, Document = 0x0000000F,
  Pane = 0x00000010, Chart = 0x00000011, Dialog = 0x00000012, Border = 0x00000013,
  Grouping = 0x00000014, Separator = 0x00000015, ToolBar = 0x00000016, StatusBar = 0x00000017,
  Table = 0x00000018, ColumnHeader = 0x00000019, RowHeader = 0x0000001A, Column = 0x0000001B,
  Row = 0x0000001C, Cell = 0x0000001D, Link = 0x0000001E, HelpBalloon = 0x0000001F,
  Assistant = 0x00000020, List = 0x00000021, ListItem = 0x00000022, Tree = 0x00000023,
  TreeItem = 0x00000024, PageTab = 0x00000025, PropertyPage = 0x00000026, Indicator = 0x00000027,
  Graphic = 0x00000028, StaticText = 0x00000029, EditableText = 0x0000002A, PushButton = 0x0000002B,
  CheckBox = 0x0000002C, RadioButton = 0x0000002D, ComboBox = 0x0000002E, ProgressBar = 0x00000030,
  Dial = 0x00000031, HotkeyField = 0x00000032, Slider = 0x00000033, SpinBox = 0x00000034,
  Canvas = 0x00000035, Animation = 0x00000036, Equation = 0x00000037, ButtonDropDown = 0x00000038,
  ButtonMenu = 0x00000039, ButtonDropGrid = 0x0000003A, Whitespace = 0x0000003B, PageTabList = 0x0000003C,
  Clock = 0x0000003D, Splitter = 0x0000003E, LayeredPane = 0x0000003F, Terminal = 0x00000040,
  Desktop = 0x00000041, UserRole = 0x0000ffff
}
 This enum defines the role of an accessible object. More...
 
typedef void(* RootObjectHandler) (QObject *)
 A function pointer type. More...
 
enum  StateFlag {
  Normal = 0x00000000, Unavailable = 0x00000001, Selected = 0x00000002, Focused = 0x00000004,
  Pressed = 0x00000008, Checked = 0x00000010, Mixed = 0x00000020, ReadOnly = 0x00000040,
  HotTracked = 0x00000080, DefaultButton = 0x00000100, Expanded = 0x00000200, Collapsed = 0x00000400,
  Busy = 0x00000800, Marqueed = 0x00002000, Animated = 0x00004000, Invisible = 0x00008000,
  Offscreen = 0x00010000, Sizeable = 0x00020000, Movable = 0x00040000, SelfVoicing = 0x00080000,
  Focusable = 0x00100000, Selectable = 0x00200000, Linked = 0x00400000, Traversed = 0x00800000,
  MultiSelectable = 0x01000000, ExtSelectable = 0x02000000, Protected = 0x20000000, HasPopup = 0x40000000,
  Modal = 0x80000000, HasInvokeExtension = 0x10000000
}
 This enum type defines bit flags that can be combined to indicate the state of an accessible object. More...
 
enum  Text {
  Name = 0, Description, Value, Help,
  Accelerator, UserText = 0x0000ffff
}
 This enum specifies string information that an accessible object returns. More...
 
typedef void(* UpdateHandler) (QObject *, int who, Event reason)
 A function pointer type. More...
 
- Static Public Functions inherited from QAccessible
static void cleanup ()
 
static void initialize ()
 
static void installFactory (InterfaceFactory)
 Installs the InterfaceFactory factory. More...
 
static RootObjectHandler installRootObjectHandler (RootObjectHandler)
 Installs the given handler as the function to be used by setRootObject(), and returns the previously installed handler. More...
 
static UpdateHandler installUpdateHandler (UpdateHandler)
 Installs the given handler as the function to be used by updateAccessibility(), and returns the previously installed handler. More...
 
static bool isActive ()
 Returns true if an accessibility implementation has been requested during the runtime of the application; otherwise returns false. More...
 
static QAccessibleInterfacequeryAccessibleInterface (QObject *)
 If a QAccessibleInterface implementation exists for the given object, this function returns a pointer to the implementation; otherwise it returns 0. More...
 
static void removeFactory (InterfaceFactory)
 Removes factory from the list of installed InterfaceFactories. More...
 
static void setRootObject (QObject *)
 Sets the root accessible object of this application to object. More...
 
static void updateAccessibility (QObject *, int who, Event reason)
 Notifies accessibility clients about a change in object's accessibility information. More...
 

Detailed Description

The QAccessibleIconView class implements the QAccessibleInterface for icon views.

Warning
This function is not part of the public interface.

Definition at line 87 of file qaccessiblecompat.h.

Constructors and Destructors

◆ QAccessibleIconView()

QAccessibleIconView::QAccessibleIconView ( QWidget o)
explicit

Constructs a QAccessibleIconView object for a widget.

Definition at line 344 of file qaccessiblecompat.cpp.

346 {
347  Q_ASSERT(widget()->inherits("Q3IconView"));
348 }
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
QWidget * widget() const
Returns the associated widget.
Q3AccessibleScrollView(QWidget *w, Role role)
Constructs a Q3AccessibleScrollView object for a widget.

Functions

◆ clearSelection()

void QAccessibleIconView::clearSelection ( )
Warning
This function is not part of the public interface.

Definition at line 497 of file qaccessiblecompat.cpp.

498 {
499  iconView()->clearSelection();
500 }
Q3IconView * iconView() const
Returns the icon view.

◆ iconView()

Q3IconView * QAccessibleIconView::iconView ( ) const
protected

Returns the icon view.

Definition at line 351 of file qaccessiblecompat.cpp.

Referenced by clearSelection(), itemAt(), itemCount(), itemRect(), selection(), setSelected(), state(), and text().

352 {
353  return (Q3IconView*)widget();
354 }
QWidget * widget() const
Returns the associated widget.

◆ itemAt()

int QAccessibleIconView::itemAt ( int  x,
int  y 
) const
virtual
Warning
This function is not part of the public interface.

Reimplemented from Q3AccessibleScrollView.

Definition at line 357 of file qaccessiblecompat.cpp.

358 {
359  Q3IconViewItem *item = iconView()->findItem(QPoint(x, y));
360  return iconView()->index(item) + 1;
361 }
Q3IconView * iconView() const
Returns the icon view.
The QPoint class defines a point in the plane using integer precision.
Definition: qpoint.h:53

◆ itemCount()

int QAccessibleIconView::itemCount ( ) const
virtual
Warning
This function is not part of the public interface.

Reimplemented from Q3AccessibleScrollView.

Definition at line 374 of file qaccessiblecompat.cpp.

375 {
376  return iconView()->count();
377 }
Q3IconView * iconView() const
Returns the icon view.

◆ itemRect()

QRect QAccessibleIconView::itemRect ( int  child) const
virtual
Warning
This function is not part of the public interface.

Reimplemented from Q3AccessibleScrollView.

Definition at line 364 of file qaccessiblecompat.cpp.

365 {
366  Q3IconViewItem *item = findIVItem(iconView(), child);
367 
368  if (!item)
369  return QRect();
370  return item->rect();
371 }
Q3IconView * iconView() const
Returns the icon view.
static Q3IconViewItem * findIVItem(Q3IconView *iconView, int child)
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58

◆ role()

QAccessible::Role QAccessibleIconView::role ( int  child) const
virtual
Warning
This function is not part of the public interface.

Reimplemented from QAccessibleWidget.

Definition at line 392 of file qaccessiblecompat.cpp.

393 {
394  if (!child)
395  return Q3AccessibleScrollView::role(child);
396  return ListItem;
397 }
Role role(int child) const
Reimplemented Function

◆ selection()

QVector< int > QAccessibleIconView::selection ( ) const
Warning
This function is not part of the public interface.

Definition at line 503 of file qaccessiblecompat.cpp.

504 {
505  QVector<int> array;
506  uint size = 0;
507  int id = 1;
508  array.resize(iconView()->count());
509  Q3IconViewItem *item = iconView()->firstItem();
510  while (item) {
511  if (item->isSelected()) {
512  ++size;
513  array[(int)size-1] = id;
514  }
515  item = item->nextItem();
516  ++id;
517  }
518  array.resize(size);
519  return array;
520 }
Q3IconView * iconView() const
Returns the icon view.
void resize(int size)
Sets the size of the vector to size.
Definition: qvector.h:342
unsigned int uint
Definition: qglobal.h:996

◆ setSelected()

bool QAccessibleIconView::setSelected ( int  child,
bool  on,
bool  extend 
)
Warning
This function is not part of the public interface.

Definition at line 454 of file qaccessiblecompat.cpp.

455 {
456  if (!child || (extend &&
457  iconView()->selectionMode() != Q3IconView::Extended &&
458  iconView()->selectionMode() != Q3IconView::Multi))
459  return false;
460 
461  Q3IconViewItem *item = findIVItem(iconView(), child);
462  if (!item)
463  return false;
464  if (!extend) {
465  iconView()->setSelected(item, on, true);
466  } else {
467  Q3IconViewItem *current = iconView()->currentItem();
468  if (!current)
469  return false;
470  bool down = false;
471  Q3IconViewItem *temp = current;
472  while ((temp = temp->nextItem())) {
473  if (temp == item) {
474  down = true;
475  break;
476  }
477  }
478  temp = current;
479  if (down) {
480  while ((temp = temp->nextItem())) {
481  iconView()->setSelected(temp, on, true);
482  if (temp == item)
483  break;
484  }
485  } else {
486  while ((temp = temp->prevItem())) {
487  iconView()->setSelected(temp, on, true);
488  if (temp == item)
489  break;
490  }
491  }
492  }
493  return true;
494 }
Q3IconView * iconView() const
Returns the icon view.
static Q3IconViewItem * findIVItem(Q3IconView *iconView, int child)

◆ state()

QAccessible::State QAccessibleIconView::state ( int  child) const
virtual
Warning
This function is not part of the public interface.

Reimplemented from QAccessibleWidget.

Definition at line 400 of file qaccessiblecompat.cpp.

401 {
403  Q3IconViewItem *item;
404  if (!child || !(item = findIVItem(iconView(), child)))
405  return state;
406 
407  if (item->isSelectable()) {
408  if (iconView()->selectionMode() == Q3IconView::Multi)
409  state |= MultiSelectable;
410  else if (iconView()->selectionMode() == Q3IconView::Extended)
411  state |= ExtSelectable;
412  else if (iconView()->selectionMode() == Q3IconView::Single)
413  state |= Selectable;
414  if (item->isSelected())
415  state |= Selected;
416  }
417  if (iconView()->itemsMovable())
418  state |= Movable;
419  if (iconView()->focusPolicy() != Qt::NoFocus) {
420  state |= Focusable;
421  if (item == iconView()->currentItem())
422  state |= Focused;
423  }
424 
425  return state;
426 }
Q3IconView * iconView() const
Returns the icon view.
State state(int child) const
The State element defines configurations of objects and properties.
static Q3IconViewItem * findIVItem(Q3IconView *iconView, int child)
State state(int child) const
Reimplemented Function

◆ text()

QString QAccessibleIconView::text ( Text  t,
int  child 
) const
virtual
Warning
This function is not part of the public interface.

Reimplemented from QAccessibleWidget.

Definition at line 380 of file qaccessiblecompat.cpp.

381 {
382  if (!child || t != Name)
383  return Q3AccessibleScrollView::text(t, child);
384 
385  Q3IconViewItem *item = findIVItem(iconView(), child);
386  if (!item)
387  return QString();
388  return item->text();
389 }
Q3IconView * iconView() const
Returns the icon view.
The QString class provides a Unicode character string.
Definition: qstring.h:83
static Q3IconViewItem * findIVItem(Q3IconView *iconView, int child)
QString text(Text t, int child) const
Reimplemented Function

The documentation for this class was generated from the following files: