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

The QAccessibleSlider class implements the QAccessibleInterface for sliders. More...

#include <rangecontrols.h>

Inheritance diagram for QAccessibleSlider:
QAccessibleAbstractSlider QAccessibleWidgetEx QAccessibleValueInterface QAccessibleObjectEx QAccessible2Interface QAccessibleInterfaceEx QAccessibleInterface QAccessible

Public Types

enum  SliderElements { SliderSelf = 0, PageLeft, Position, PageRight }
 This enum identifies the components of the slider. More...
 
- 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...
 

Public Functions

QString actionText (int action, Text t, int child) const
 
int childCount () const
 Reimplemented Function More...
 
int defaultAction (int child) const
 Returns the default action for the given child. More...
 
 QAccessibleSlider (QWidget *w)
 Constructs a QAccessibleScrollBar object for w. More...
 
QRect rect (int child) const
 Reimplemented Function More...
 
Role role (int child) const
 Reimplemented Function More...
 
State state (int child) const
 Reimplemented Function More...
 
QString text (Text t, int child) const
 Reimplemented Function More...
 
- Public Functions inherited from QAccessibleAbstractSlider
QVariant currentValue ()
 
QVariant invokeMethodEx (Method method, int child, const QVariantList &params)
 
QVariant maximumValue ()
 
QVariant minimumValue ()
 
 QAccessibleAbstractSlider (QWidget *w, Role r=Slider)
 
void setCurrentValue (const QVariant &value)
 
- Public Functions inherited from QAccessibleWidgetEx
int childAt (int x, int y) const
 Returns the 1-based index of the child that contains the screen coordinates (x, y). More...
 
bool doAction (int action, int child, const QVariantList &params)
 Asks the object, or the object's child if child is not 0, to execute action using the parameters, params. More...
 
int indexOfChild (const QAccessibleInterface *child) const
 Returns the 1-based index of the object child in this object's children list, or -1 if child is not a child of this object. More...
 
int navigate (RelationFlag rel, int entry, QAccessibleInterface **target) const
 Navigates from this object to an object that has a relationship relation to this object, and returns the respective object in target. More...
 
 QAccessibleWidgetEx (QWidget *o, Role r=Client, const QString &name=QString())
 
Relation relationTo (int child, const QAccessibleInterface *other, int otherChild) const
 
Returns the relationship between this object's \a child and the \a
other object's \a otherChild.
More...
 
- Public Functions inherited from QAccessibleObjectEx
bool isValid () const
 Returns true if all the data necessary to use this interface implementation is valid (e. More...
 
QObjectobject () const
 Returns a pointer to the QObject this interface implementation provides information for. More...
 
 QAccessibleObjectEx (QObject *object)
 
void setText (Text t, int child, const QString &text)
 Sets the text property t of the object, or of the object's child if child is not 0, to text. More...
 
int userActionCount (int child) const
 Returns the number of custom actions of the object, or of the object's child if child is not 0. More...
 
- Public Functions inherited from QAccessibleInterfaceEx
virtual QAccessible2Interfaceinterface_cast (QAccessible2::InterfaceType)
 
virtual QVariant virtual_hook (const QVariant &data)
 
- 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...
 
- Public Functions inherited from QAccessibleValueInterface
QAccessible2InterfaceqAccessibleValueCastHelper ()
 
virtual ~QAccessibleValueInterface ()
 
- Public Functions inherited from QAccessible2Interface
virtual ~QAccessible2Interface ()
 

Protected Functions

QSliderslider () const
 Returns the slider. More...
 
- Protected Functions inherited from QAccessibleAbstractSlider
QAbstractSliderabstractSlider () const
 
- Protected Functions inherited from QAccessibleWidgetEx
void addControllingSignal (const QString &signal)
 
QObjectparentObject () const
 
void setAccelerator (const QString &accel)
 
void setDescription (const QString &desc)
 
void setHelp (const QString &help)
 
void setValue (const QString &value)
 
QWidgetwidget () const
 
 ~QAccessibleWidgetEx ()
 
- Protected Functions inherited from QAccessibleObjectEx
virtual ~QAccessibleObjectEx ()
 

Additional Inherited Members

- 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 QAccessibleSlider class implements the QAccessibleInterface for sliders.

Warning
This function is not part of the public interface.

Definition at line 180 of file rangecontrols.h.

Enumerations

◆ SliderElements

This enum identifies the components of the slider.

  • SliderSelf The slider as a whole.
  • PageLeft The area to the left of the position.
  • Position The position indicator.
  • PageRight The area to the right of the position.
Enumerator
SliderSelf 
PageLeft 
Position 
PageRight 

Definition at line 185 of file rangecontrols.h.

Constructors and Destructors

◆ QAccessibleSlider()

QAccessibleSlider::QAccessibleSlider ( QWidget w)
explicit

Constructs a QAccessibleScrollBar object for w.

name is propagated to the QAccessibleWidgetEx constructor.

Definition at line 659 of file rangecontrols.cpp.

661 {
662  Q_ASSERT(slider());
663  addControllingSignal(QLatin1String("valueChanged(int)"));
664 }
QAccessibleAbstractSlider(QWidget *w, Role r=Slider)
QLatin1String(DBUS_INTERFACE_DBUS))) Q_GLOBAL_STATIC_WITH_ARGS(QString
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
QSlider * slider() const
Returns the slider.
void addControllingSignal(const QString &signal)

Functions

◆ actionText()

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

Reimplemented from QAccessibleWidgetEx.

Definition at line 807 of file rangecontrols.cpp.

808 {
809  return QLatin1String("");
810 }
QLatin1String(DBUS_INTERFACE_DBUS))) Q_GLOBAL_STATIC_WITH_ARGS(QString

◆ childCount()

int QAccessibleSlider::childCount ( ) const
virtual

Reimplemented Function

Reimplemented from QAccessibleWidgetEx.

Definition at line 707 of file rangecontrols.cpp.

708 {
709  return PageRight;
710 }

◆ defaultAction()

int QAccessibleSlider::defaultAction ( int  child) const

Returns the default action for the given child.

The base class implementation returns 0.

Definition at line 791 of file rangecontrols.cpp.

792 {
793 /*
794  switch (child) {
795  case SliderSelf:
796  return SetFocus;
797  case PageLeft:
798  return Press;
799  case PageRight:
800  return Press;
801  }
802 */
803  return 0;
804 }

◆ rect()

QRect QAccessibleSlider::rect ( int  child) const
virtual

Reimplemented Function

Reimplemented from QAccessibleWidgetEx.

Definition at line 673 of file rangecontrols.cpp.

674 {
675  QRect rect;
676  if (!slider()->isVisible())
677  return rect;
679  QRect srect = slider()->style()->subControlRect(QStyle::CC_Slider, &option,
681 
682  switch (child) {
683  case PageLeft:
684  if (slider()->orientation() == Qt::Vertical)
685  rect = QRect(0, 0, slider()->width(), srect.y());
686  else
687  rect = QRect(0, 0, srect.x(), slider()->height());
688  break;
689  case Position:
690  rect = srect;
691  break;
692  case PageRight:
693  if (slider()->orientation() == Qt::Vertical)
694  rect = QRect(0, srect.y() + srect.height(), slider()->width(), slider()->height()- srect.y() - srect.height());
695  else
696  rect = QRect(srect.x() + srect.width(), 0, slider()->width() - srect.x() - srect.width(), slider()->height());
697  break;
698  default:
699  return QAccessibleAbstractSlider::rect(child);
700  }
701 
702  QPoint tp = slider()->mapToGlobal(QPoint(0,0));
703  return QRect(tp.x() + rect.x(), tp.y() + rect.y(), rect.width(), rect.height());
704 }
virtual QRect subControlRect(ComplexControl cc, const QStyleOptionComplex *opt, SubControl sc, const QWidget *widget=0) const =0
Returns the rectangle containing the specified subControl of the given complex control (with the styl...
int width() const
Returns the width of the rectangle.
Definition: qrect.h:303
int height() const
Returns the height of the rectangle.
Definition: qrect.h:306
int height() const
QStyle * style() const
Definition: qwidget.cpp:2742
QRect rect(int child) const
Reimplemented Function
QRect rect(int child) const
Returns the geometry of the object, or of the object&#39;s child if child is not 0.
int width() const
Qt::Orientation orientation() const
QSlider * slider() const
Returns the slider.
int y() const
Returns the y-coordinate of the rectangle&#39;s top edge.
Definition: qrect.h:255
int x() const
Returns the x-coordinate of the rectangle&#39;s left edge.
Definition: qrect.h:252
The QPoint class defines a point in the plane using integer precision.
Definition: qpoint.h:53
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
int y() const
Returns the y coordinate of this point.
Definition: qpoint.h:131
The QStyleOptionSlider class is used to describe the parameters needed for drawing a slider...
Definition: qstyleoption.h:701
int x() const
Returns the x coordinate of this point.
Definition: qpoint.h:128
QStyleOptionSlider Q_GUI_EXPORT qt_qsliderStyleOption(QSlider *slider)
Returns the style option for slider.
Definition: qslider.cpp:684
QPoint mapToGlobal(const QPoint &) const
Translates the widget coordinate pos to global screen coordinates.

◆ role()

QAccessible::Role QAccessibleSlider::role ( int  child) const
virtual

Reimplemented Function

Reimplemented from QAccessibleWidgetEx.

Definition at line 739 of file rangecontrols.cpp.

740 {
741  switch (child) {
742  case PageLeft:
743  case PageRight:
744  return PushButton;
745  case Position:
746  return Indicator;
747  default:
748  return Slider;
749  }
750 }

◆ slider()

QSlider * QAccessibleSlider::slider ( ) const
protected

Returns the slider.

Definition at line 667 of file rangecontrols.cpp.

Referenced by QAccessibleSlider(), rect(), state(), and text().

668 {
669  return qobject_cast<QSlider*>(object());
670 }
T qobject_cast(QObject *object)
Definition: qobject.h:375
QObject * object() const
Returns a pointer to the QObject this interface implementation provides information for...
The QSlider widget provides a vertical or horizontal slider.
Definition: qslider.h:57

◆ state()

QAccessible::State QAccessibleSlider::state ( int  child) const
virtual

Reimplemented Function

Reimplemented from QAccessibleWidgetEx.

Definition at line 753 of file rangecontrols.cpp.

754 {
755  const State parentState = QAccessibleAbstractSlider::state(0);
756 
757  if (child == 0)
758  return parentState;
759 
760  // Inherit the Invisible state from parent.
761  State state = parentState & QAccessible::Invisible;
762 
763  // Disable left/right if we are at the minimum/maximum.
764  const QSlider * const slider = QAccessibleSlider::slider();
765  switch (child) {
766  case PageLeft:
767  if (slider->value() <= slider->minimum())
768  state |= Unavailable;
769  break;
770  case PageRight:
771  if (slider->value() >= slider->maximum())
772  state |= Unavailable;
773  break;
774  case Position:
775  default:
776  break;
777  }
778 
779  return state;
780 }
int minimum() const
State state(int child) const
Reimplemented Function
int value() const
The QSlider widget provides a vertical or horizontal slider.
Definition: qslider.h:57
The State element defines configurations of objects and properties.
QSlider * slider() const
Returns the slider.
int maximum() const
State state(int child) const
Returns the current state of the object, or of the object&#39;s child if child is not 0...

◆ text()

QString QAccessibleSlider::text ( Text  t,
int  child 
) const
virtual

Reimplemented Function

Reimplemented from QAccessibleWidgetEx.

Definition at line 713 of file rangecontrols.cpp.

714 {
715  switch (t) {
716  case Value:
717  if (!child || child == 2)
718  return QString::number(slider()->value());
719  return QString();
720  case Name:
721  switch (child) {
722  case PageLeft:
723  return slider()->orientation() == Qt::Horizontal ?
724  QSlider::tr("Page left") : QSlider::tr("Page up");
725  case Position:
726  return QSlider::tr("Position");
727  case PageRight:
728  return slider()->orientation() == Qt::Horizontal ?
729  QSlider::tr("Page right") : QSlider::tr("Page down");
730  }
731  break;
732  default:
733  break;
734  }
735  return QAccessibleAbstractSlider::text(t, child);
736 }
static QString number(int, int base=10)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: qstring.cpp:6448
QString text(Text t, int child) const
Returns the value of the text property t of the object, or of the object&#39;s child if child is not 0...
static QString tr(const char *sourceText, const char *comment=0, int n=-1)
The QString class provides a Unicode character string.
Definition: qstring.h:83
Qt::Orientation orientation() const
The QSlider widget provides a vertical or horizontal slider.
Definition: qslider.h:57
QSlider * slider() const
Returns the slider.

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