Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
QQuickDial Class Reference

#include <qquickdial_p.h>

+ Inheritance diagram for QQuickDial:
+ Collaboration diagram for QQuickDial:

Public Types

enum  SnapMode { NoSnap , SnapAlways , SnapOnRelease }
 
enum  InputMode { Circular , Horizontal , Vertical }
 
enum  WrapDirection { Clockwise , CounterClockwise }
 
- Public Types inherited from QQuickItem
enum  Flag {
  ItemClipsChildrenToShape = 0x01 , ItemIsFocusScope = 0x04 , ItemHasContents = 0x08 , ItemAcceptsDrops = 0x10 ,
  ItemIsViewport = 0x20 , ItemObservesViewport = 0x40
}
 \qmltype Item \nativetype QQuickItem \inherits QtObject \inqmlmodule QtQuick More...
 
enum  ItemChange {
  ItemChildAddedChange , ItemChildRemovedChange , ItemSceneChange , ItemVisibleHasChanged ,
  ItemParentHasChanged , ItemOpacityHasChanged , ItemActiveFocusHasChanged , ItemRotationHasChanged ,
  ItemAntialiasingHasChanged , ItemDevicePixelRatioHasChanged , ItemEnabledHasChanged , ItemScaleHasChanged ,
  ItemTransformHasChanged
}
 Used in conjunction with QQuickItem::itemChange() to notify the item about certain types of changes. More...
 
enum  TransformOrigin {
  TopLeft , Top , TopRight , Left ,
  Center , Right , BottomLeft , Bottom ,
  BottomRight
}
 \variable QQuickItem::ItemChangeData::realValue The numeric value that has changed: \l {QQuickItem::opacity()}{opacity}, \l {QQuickItem::rotation()}{rotation}, or \l {QQuickItem::scale()}{scale}, or \l {QScreen::devicePixelRatio}{device pixel ratio}. More...
 

Public Slots

void increase ()
 \qmlmethod void QtQuick.Controls::Dial::increase()
 
void decrease ()
 \qmlmethod void QtQuick.Controls::Dial::decrease()
 
- Public Slots inherited from QQuickItem
void update ()
 Schedules a call to updatePaintNode() for this item.
 
- Public Slots inherited from QObject
void deleteLater ()
 \threadsafe
 

Signals

void fromChanged ()
 
void toChanged ()
 
void valueChanged ()
 
void positionChanged ()
 
void angleChanged ()
 
void stepSizeChanged ()
 
void snapModeChanged ()
 
void wrapChanged ()
 
void pressedChanged ()
 
void handleChanged ()
 
 Q_REVISION (2, 2) void moved()
 
 Q_REVISION (2, 2) void liveChanged()
 
 Q_REVISION (2, 5) void inputModeChanged()
 
 Q_REVISION (6, 6) void startAngleChanged()
 
 Q_REVISION (6, 6) void endAngleChanged()
 
 Q_REVISION (6, 6) void wrapped(WrapDirection)
 
- Signals inherited from QQuickControl
void fontChanged ()
 
void availableWidthChanged ()
 
void availableHeightChanged ()
 
void paddingChanged ()
 
void topPaddingChanged ()
 
void leftPaddingChanged ()
 
void rightPaddingChanged ()
 
void bottomPaddingChanged ()
 
void spacingChanged ()
 
void localeChanged ()
 
void focusReasonChanged ()
 
void mirroredChanged ()
 
void visualFocusChanged ()
 
void hoveredChanged ()
 
void hoverEnabledChanged ()
 
void wheelEnabledChanged ()
 
void backgroundChanged ()
 
void contentItemChanged ()
 
void baselineOffsetChanged ()
 
 Q_REVISION (2, 5) void horizontalPaddingChanged()
 
 Q_REVISION (2, 5) void verticalPaddingChanged()
 
 Q_REVISION (2, 5) void implicitContentWidthChanged()
 
 Q_REVISION (2, 5) void implicitContentHeightChanged()
 
 Q_REVISION (2, 5) void implicitBackgroundWidthChanged()
 
 Q_REVISION (2, 5) void implicitBackgroundHeightChanged()
 
 Q_REVISION (2, 5) void topInsetChanged()
 
 Q_REVISION (2, 5) void leftInsetChanged()
 
 Q_REVISION (2, 5) void rightInsetChanged()
 
 Q_REVISION (2, 5) void bottomInsetChanged()
 
- Signals inherited from QQuickItem
void childrenRectChanged (const QRectF &)
 
void baselineOffsetChanged (qreal)
 
void stateChanged (const QString &)
 
void focusChanged (bool)
 
void activeFocusChanged (bool)
 
Q_REVISION(6, 7) void focusPolicyChanged(Qt Q_REVISION (2, 1) void activeFocusOnTabChanged(bool)
 
void parentChanged (QQuickItem *)
 
void transformOriginChanged (TransformOrigin)
 
void smoothChanged (bool)
 
void antialiasingChanged (bool)
 
void clipChanged (bool)
 
 Q_REVISION (2, 1) void windowChanged(QQuickWindow *window)
 
void childrenChanged ()
 
void opacityChanged ()
 
void enabledChanged ()
 
void visibleChanged ()
 
void visibleChildrenChanged ()
 
void rotationChanged ()
 
void scaleChanged ()
 
void xChanged ()
 
void yChanged ()
 
void widthChanged ()
 
void heightChanged ()
 
void zChanged ()
 
void implicitWidthChanged ()
 
void implicitHeightChanged ()
 
 Q_REVISION (2, 11) void containmentMaskChanged()
 
 Q_REVISION (6, 0) void paletteChanged()
 
 Q_REVISION (6, 0) void paletteCreated()
 
- Signals inherited from QObject
void destroyed (QObject *=nullptr)
 This signal is emitted immediately before the object obj is destroyed, after any instances of QPointer have been notified, and cannot be blocked.
 
void objectNameChanged (const QString &objectName, QPrivateSignal)
 This signal is emitted after the object's name has been changed.
 

Public Member Functions

 QQuickDial (QQuickItem *parent=nullptr)
 
qreal from () const
 \qmlproperty real QtQuick.Controls::Dial::from
 
void setFrom (qreal from)
 
qreal to () const
 \qmlproperty real QtQuick.Controls::Dial::to
 
void setTo (qreal to)
 
qreal value () const
 \qmlproperty real QtQuick.Controls::Dial::value
 
void setValue (qreal value)
 
qreal position () const
 \qmlproperty real QtQuick.Controls::Dial::position \readonly
 
qreal angle () const
 \qmlproperty real QtQuick.Controls::Dial::angle \readonly
 
qreal stepSize () const
 \qmlproperty real QtQuick.Controls::Dial::stepSize
 
void setStepSize (qreal step)
 
qreal startAngle () const
 \qmlproperty real QtQuick.Controls::Dial::startAngle
 
void setStartAngle (qreal startAngle)
 
qreal endAngle () const
 \qmlproperty real QtQuick.Controls::Dial::endAngle
 
void setEndAngle (qreal endAngle)
 
SnapMode snapMode () const
 \qmlproperty enumeration QtQuick.Controls::Dial::snapMode
 
void setSnapMode (SnapMode mode)
 
bool wrap () const
 \qmlproperty bool QtQuick.Controls::Dial::wrap
 
void setWrap (bool wrap)
 
bool isPressed () const
 \qmlproperty bool QtQuick.Controls::Dial::pressed
 
void setPressed (bool pressed)
 
QQuickItemhandle () const
 \qmlproperty Item QtQuick.Controls::Dial::handle
 
void setHandle (QQuickItem *handle)
 
bool live () const
 
void setLive (bool live)
 
InputMode inputMode () const
 
void setInputMode (InputMode mode)
 
- Public Member Functions inherited from QQuickControl
 QQuickControl (QQuickItem *parent=nullptr)
 
 ~QQuickControl ()
 
QFont font () const
 \qmlproperty font QtQuick.Controls::Control::font
 
void setFont (const QFont &font)
 
void resetFont ()
 
qreal availableWidth () const
 \qmlproperty real QtQuick.Controls::Control::availableWidth \readonly
 
qreal availableHeight () const
 \qmlproperty real QtQuick.Controls::Control::availableHeight \readonly
 
qreal padding () const
 \qmlproperty real QtQuick.Controls::Control::padding
 
void setPadding (qreal padding)
 
void resetPadding ()
 
qreal topPadding () const
 \qmlproperty real QtQuick.Controls::Control::topPadding
 
void setTopPadding (qreal padding)
 
void resetTopPadding ()
 
qreal leftPadding () const
 \qmlproperty real QtQuick.Controls::Control::leftPadding
 
void setLeftPadding (qreal padding)
 
void resetLeftPadding ()
 
qreal rightPadding () const
 \qmlproperty real QtQuick.Controls::Control::rightPadding
 
void setRightPadding (qreal padding)
 
void resetRightPadding ()
 
qreal bottomPadding () const
 \qmlproperty real QtQuick.Controls::Control::bottomPadding
 
void setBottomPadding (qreal padding)
 
void resetBottomPadding ()
 
qreal spacing () const
 \qmlproperty real QtQuick.Controls::Control::spacing
 
void setSpacing (qreal spacing)
 
void resetSpacing ()
 
QLocale locale () const
 \qmlproperty Locale QtQuick.Controls::Control::locale
 
void setLocale (const QLocale &locale)
 
void resetLocale ()
 
bool isMirrored () const
 \qmlproperty bool QtQuick.Controls::Control::mirrored \readonly
 
Qt::FocusReason focusReason () const
 \qmlproperty enumeration QtQuick.Controls::Control::focusReason
 
void setFocusReason (Qt::FocusReason reason)
 
bool hasVisualFocus () const
 \qmlproperty bool QtQuick.Controls::Control::visualFocus \readonly
 
bool isHovered () const
 \qmlproperty bool QtQuick.Controls::Control::hovered \readonly
 
void setHovered (bool hovered)
 
bool isHoverEnabled () const
 \qmlproperty bool QtQuick.Controls::Control::hoverEnabled
 
void setHoverEnabled (bool enabled)
 
void resetHoverEnabled ()
 
bool isWheelEnabled () const
 \qmlproperty bool QtQuick.Controls::Control::wheelEnabled
 
void setWheelEnabled (bool enabled)
 
QQuickItembackground () const
 \qmlproperty Item QtQuick.Controls::Control::background
 
void setBackground (QQuickItem *background)
 
QQuickItemcontentItem () const
 \qmlproperty Item QtQuick.Controls::Control::contentItem
 
void setContentItem (QQuickItem *item)
 
qreal baselineOffset () const
 
void setBaselineOffset (qreal offset)
 
void resetBaselineOffset ()
 
qreal horizontalPadding () const
 
void setHorizontalPadding (qreal padding)
 
void resetHorizontalPadding ()
 
qreal verticalPadding () const
 
void setVerticalPadding (qreal padding)
 
void resetVerticalPadding ()
 
qreal implicitContentWidth () const
 
qreal implicitContentHeight () const
 
qreal implicitBackgroundWidth () const
 
qreal implicitBackgroundHeight () const
 
qreal topInset () const
 
void setTopInset (qreal inset)
 
void resetTopInset ()
 
qreal leftInset () const
 
void setLeftInset (qreal inset)
 
void resetLeftInset ()
 
qreal rightInset () const
 
void setRightInset (qreal inset)
 
void resetRightInset ()
 
qreal bottomInset () const
 
void setBottomInset (qreal inset)
 
void resetBottomInset ()
 
- Public Member Functions inherited from QQuickItem
 QQuickItem (QQuickItem *parent=nullptr)
 Constructs a QQuickItem with the given parent.
 
 ~QQuickItem () override
 Destroys the QQuickItem.
 
QQuickWindowwindow () const
 Returns the window in which this item is rendered.
 
QQuickItemparentItem () const
 
void setParentItem (QQuickItem *parent)
 
void stackBefore (const QQuickItem *)
 Moves the specified sibling item to the index before this item within the list of children.
 
void stackAfter (const QQuickItem *)
 Moves the specified sibling item to the index after this item within the list of children.
 
QRectF childrenRect ()
 \qmlpropertygroup QtQuick::Item::childrenRect \qmlproperty real QtQuick::Item::childrenRect.x \qmlproperty real QtQuick::Item::childrenRect.y \qmlproperty real QtQuick::Item::childrenRect.width \qmlproperty real QtQuick::Item::childrenRect.height \readonly
 
QList< QQuickItem * > childItems () const
 Returns the children of this item.
 
bool clip () const
 \qmlproperty bool QtQuick::Item::clip This property holds whether clipping is enabled.
 
void setClip (bool)
 
QString state () const
 \qmlproperty string QtQuick::Item::state
 
void setState (const QString &)
 
qreal baselineOffset () const
 \qmlproperty int QtQuick::Item::baselineOffset
 
void setBaselineOffset (qreal)
 
QQmlListProperty< QQuickTransformtransform ()
 
qreal x () const
 
qreal y () const
 
QPointF position () const
 
void setX (qreal)
 
void setY (qreal)
 
void setPosition (const QPointF &)
 
QBindable< qrealbindableX ()
 
QBindable< qrealbindableY ()
 
qreal width () const
 
void setWidth (qreal)
 
void resetWidth ()
 
void setImplicitWidth (qreal)
 
qreal implicitWidth () const
 Returns the width of the item that is implied by other properties that determine the content.
 
QBindable< qrealbindableWidth ()
 
qreal height () const
 
void setHeight (qreal)
 
void resetHeight ()
 
void setImplicitHeight (qreal)
 
qreal implicitHeight () const
 
QBindable< qrealbindableHeight ()
 
QSizeF size () const
 
void setSize (const QSizeF &size)
 
TransformOrigin transformOrigin () const
 
void setTransformOrigin (TransformOrigin)
 
QPointF transformOriginPoint () const
 
void setTransformOriginPoint (const QPointF &)
 
qreal z () const
 
void setZ (qreal)
 
qreal rotation () const
 
void setRotation (qreal)
 
qreal scale () const
 
void setScale (qreal)
 
qreal opacity () const
 
void setOpacity (qreal)
 
bool isVisible () const
 
void setVisible (bool)
 
bool isEnabled () const
 
void setEnabled (bool)
 
bool smooth () const
 
void setSmooth (bool)
 
bool activeFocusOnTab () const
 \qmlproperty bool QtQuick::Item::activeFocusOnTab
 
void setActiveFocusOnTab (bool)
 
bool antialiasing () const
 
void setAntialiasing (bool)
 
void resetAntialiasing ()
 
Flags flags () const
 Returns the item flags for this item.
 
void setFlag (Flag flag, bool enabled=true)
 Enables the specified flag for this item if enabled is true; if enabled is false, the flag is disabled.
 
void setFlags (Flags flags)
 Enables the specified flags for this item.
 
virtual QRectF boundingRect () const
 Returns the extents of the item in its own coordinate system: a rectangle from {0, 0} to \l width() and \l height().
 
virtual QRectF clipRect () const
 Returns the rectangular area within this item that is currently visible in \l viewportItem(), if there is a viewport and the \l ItemObservesViewport flag is set; otherwise, the extents of this item in its own coordinate system: a rectangle from {0, 0} to \l width() and \l height().
 
QQuickItemviewportItem () const
 If the \l ItemObservesViewport flag is set, returns the nearest parent with the \l ItemIsViewport flag.
 
bool hasActiveFocus () const
 
bool hasFocus () const
 
void setFocus (bool)
 
void setFocus (bool focus, Qt::FocusReason reason)
 
bool isFocusScope () const
 Returns true if this item is a focus scope, and false otherwise.
 
QQuickItemscopedFocusItem () const
 If this item is a focus scope, this returns the item in its focus chain that currently has focus.
 
Qt::FocusPolicy focusPolicy () const
 
void setFocusPolicy (Qt::FocusPolicy policy)
 Sets the focus policy of this item to policy.
 
bool isAncestorOf (const QQuickItem *child) const
 Returns true if this item is an ancestor of child (i.e., if this item is child's parent, or one of child's parent's ancestors).
 
Qt::MouseButtons acceptedMouseButtons () const
 Returns the mouse buttons accepted by this item.
 
void setAcceptedMouseButtons (Qt::MouseButtons buttons)
 Sets the mouse buttons accepted by this item to buttons.
 
bool acceptHoverEvents () const
 Returns whether hover events are accepted by this item.
 
void setAcceptHoverEvents (bool enabled)
 If enabled is true, this sets the item to accept hover events; otherwise, hover events are not accepted by this item.
 
bool acceptTouchEvents () const
 Returns whether touch events are accepted by this item.
 
void setAcceptTouchEvents (bool accept)
 If enabled is true, this sets the item to accept touch events; otherwise, touch events are not accepted by this item.
 
bool isUnderMouse () const
 
void grabMouse ()
 
void ungrabMouse ()
 
bool keepMouseGrab () const
 Returns whether mouse input should exclusively remain with this item.
 
void setKeepMouseGrab (bool)
 Sets whether the mouse input should remain exclusively with this item.
 
bool filtersChildMouseEvents () const
 Returns whether pointer events intended for this item's children should be filtered through this item.
 
void setFiltersChildMouseEvents (bool filter)
 Sets whether pointer events intended for this item's children should be filtered through this item.
 
void grabTouchPoints (const QList< int > &ids)
 
void ungrabTouchPoints ()
 
bool keepTouchGrab () const
 Returns whether the touch points grabbed by this item should exclusively remain with this item.
 
void setKeepTouchGrab (bool)
 Sets whether the touch points grabbed by this item should remain exclusively with this item.
 
 Q_REVISION (2, 4) Q_INVOKABLE bool grabToImage(const QJSValue &callback
 
QSharedPointer< QQuickItemGrabResultgrabToImage (const QSize &targetSize=QSize())
 Grabs the item into an in-memory image.
 
virtual Q_INVOKABLE bool contains (const QPointF &point) const
 \qmlmethod bool QtQuick::Item::contains(point point)
 
QObjectcontainmentMask () const
 
void setContainmentMask (QObject *mask)
 
QTransform itemTransform (QQuickItem *, bool *) const
 \qmlmethod point QtQuick::Item::mapFromItem(Item item, real x, real y) \qmlmethod point QtQuick::Item::mapFromItem(Item item, point p) \qmlmethod rect QtQuick::Item::mapFromItem(Item item, real x, real y, real width, real height) \qmlmethod rect QtQuick::Item::mapFromItem(Item item, rect r)
 
QPointF mapToScene (const QPointF &point) const
 Maps the given point in this item's coordinate system to the equivalent point within the scene's coordinate system, and returns the mapped coordinate.
 
QRectF mapRectToItem (const QQuickItem *item, const QRectF &rect) const
 Maps the given rect in this item's coordinate system to the equivalent rectangular area within item's coordinate system, and returns the mapped rectangle value.
 
QRectF mapRectToScene (const QRectF &rect) const
 Maps the given rect in this item's coordinate system to the equivalent rectangular area within the scene's coordinate system, and returns the mapped rectangle value.
 
QPointF mapFromScene (const QPointF &point) const
 Maps the given point in the scene's coordinate system to the equivalent point within this item's coordinate system, and returns the mapped coordinate.
 
QRectF mapRectFromItem (const QQuickItem *item, const QRectF &rect) const
 Maps the given rect in item's coordinate system to the equivalent rectangular area within this item's coordinate system, and returns the mapped rectangle value.
 
QRectF mapRectFromScene (const QRectF &rect) const
 Maps the given rect in the scene's coordinate system to the equivalent rectangular area within this item's coordinate system, and returns the mapped rectangle value.
 
void polish ()
 Schedules a polish event for this item.
 
Q_INVOKABLE QPointF mapFromItem (const QQuickItem *item, const QPointF &point) const
 Maps the given point in item's coordinate system to the equivalent point within this item's coordinate system, and returns the mapped coordinate.
 
Q_INVOKABLE QPointF mapFromItem (const QQuickItem *item, qreal x, qreal y)
 
Q_INVOKABLE QRectF mapFromItem (const QQuickItem *item, const QRectF &rect) const
 
Q_INVOKABLE QRectF mapFromItem (const QQuickItem *item, qreal x, qreal y, qreal width, qreal height) const
 
Q_INVOKABLE QPointF mapToItem (const QQuickItem *item, const QPointF &point) const
 Maps the given point in this item's coordinate system to the equivalent point within item's coordinate system, and returns the mapped coordinate.
 
Q_INVOKABLE QPointF mapToItem (const QQuickItem *item, qreal x, qreal y)
 
Q_INVOKABLE QRectF mapToItem (const QQuickItem *item, const QRectF &rect) const
 
Q_INVOKABLE QRectF mapToItem (const QQuickItem *item, qreal x, qreal y, qreal width, qreal height) const
 
 Q_REVISION (2, 7) Q_INVOKABLE QPointF mapFromGlobal(qreal x
 
 Q_REVISION (2, 7) Q_INVOKABLE QPointF mapFromGlobal(const QPointF &point) const
 
 Q_REVISION (2, 7) Q_INVOKABLE QPointF mapToGlobal(qreal x
 
 Q_REVISION (2, 7) Q_INVOKABLE QPointF mapToGlobal(const QPointF &point) const
 
Q_INVOKABLE void forceActiveFocus ()
 \qmlmethod point QtQuick::Item::mapToItem(Item item, real x, real y) \qmlmethod point QtQuick::Item::mapToItem(Item item, point p) \qmlmethod rect QtQuick::Item::mapToItem(Item item, real x, real y, real width, real height) \qmlmethod rect QtQuick::Item::mapToItem(Item item, rect r)
 
Q_INVOKABLE void forceActiveFocus (Qt::FocusReason reason)
 \qmlmethod QtQuick::Item::forceActiveFocus(Qt::FocusReason reason) This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Forces active focus on the item with the given reason.
 
 Q_REVISION (2, 1) Q_INVOKABLE QQuickItem *nextItemInFocusChain(bool forward
 
Q_INVOKABLE QQuickItemchildAt (qreal x, qreal y) const
 \qmlmethod QtQuick::Item::childAt(real x, real y)
 
 Q_REVISION (6, 3) Q_INVOKABLE void ensurePolished()
 
 Q_REVISION (6, 3) Q_INVOKABLE void dumpItemTree() const
 
virtual bool isTextureProvider () const
 Returns true if this item is a texture provider.
 
virtual QSGTextureProvidertextureProvider () const
 Returns the texture provider for an item.
 
- Public Member Functions inherited from QObject
Q_INVOKABLE QObject (QObject *parent=nullptr)
 Constructs an object with parent object parent.
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects.
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 Filters events if this object has been installed as an event filter for the watched object.
 
QString objectName () const
 
Q_WEAK_OVERLOAD void setObjectName (const QString &name)
 Sets the object's name to name.
 
void setObjectName (QAnyStringView name)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 
QBindable< QStringbindableObjectName ()
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false.
 
bool isWindowType () const
 Returns true if the object is a window; otherwise returns false.
 
bool isQuickItemType () const
 Returns true if the object is a QQuickItem; otherwise returns false.
 
bool signalsBlocked () const noexcept
 Returns true if signals are blocked; otherwise returns false.
 
bool blockSignals (bool b) noexcept
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it).
 
QThreadthread () const
 Returns the thread in which the object lives.
 
bool moveToThread (QThread *thread QT6_DECL_NEW_OVERLOAD_TAIL)
 Changes the thread affinity for this object and its children and returns true on success.
 
int startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)
 This is an overloaded function that will start a timer of type timerType and a timeout of interval milliseconds.
 
int startTimer (std::chrono::nanoseconds time, Qt::TimerType timerType=Qt::CoarseTimer)
 
void killTimer (int id)
 Kills the timer with timer identifier, id.
 
void killTimer (Qt::TimerId id)
 
template<typename T >
findChild (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 Returns the child of this object that can be cast into type T and that is called name, or \nullptr if there is no such object.
 
template<typename T >
QList< T > findChildren (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects.
 
template<typename T >
findChild (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 
template<typename T >
QList< T > findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 
const QObjectListchildren () const
 Returns a list of child objects.
 
void setParent (QObject *parent)
 Makes the object a child of parent.
 
void installEventFilter (QObject *filterObj)
 Installs an event filter filterObj on this object.
 
void removeEventFilter (QObject *obj)
 Removes an event filter object obj from this object.
 
QMetaObject::Connection connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=nullptr, const QObject *receiver=nullptr, const char *member=nullptr) const
 
bool disconnect (const QObject *receiver, const char *member=nullptr) const
 
void dumpObjectTree () const
 Dumps a tree of children to the debug output.
 
void dumpObjectInfo () const
 Dumps information about signal connections, etc.
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value.
 
bool setProperty (const char *name, QVariant &&value)
 
QVariant property (const char *name) const
 Returns the value of the object's name property.
 
QList< QByteArraydynamicPropertyNames () const
 
QBindingStoragebindingStorage ()
 
const QBindingStoragebindingStorage () const
 
QObjectparent () const
 Returns a pointer to the parent object.
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false.
 
- Public Member Functions inherited from QQmlParserStatus
 QQmlParserStatus ()
 
virtual ~QQmlParserStatus ()
 

Protected Member Functions

void keyPressEvent (QKeyEvent *event) override
 This event handler can be reimplemented in a subclass to receive key press events for an item.
 
void keyReleaseEvent (QKeyEvent *event) override
 This event handler can be reimplemented in a subclass to receive key release events for an item.
 
void mousePressEvent (QMouseEvent *event) override
 This event handler can be reimplemented in a subclass to receive mouse press events for an item.
 
void mirrorChange () override
 
void componentComplete () override
 Invoked after the root component that caused this instantiation has completed construction.
 
- Protected Member Functions inherited from QQuickControl
virtual QFont defaultFont () const
 
 QQuickControl (QQuickControlPrivate &dd, QQuickItem *parent)
 
void classBegin () override
 Invoked after class creation, but before any properties have been set.
 
void itemChange (ItemChange change, const ItemChangeData &value) override
 Called when change occurs for this item.
 
void focusInEvent (QFocusEvent *event) override
 This event handler can be reimplemented in a subclass to receive focus-in events for an item.
 
void focusOutEvent (QFocusEvent *event) override
 This event handler can be reimplemented in a subclass to receive focus-out events for an item.
 
void mouseMoveEvent (QMouseEvent *event) override
 This event handler can be reimplemented in a subclass to receive mouse move events for an item.
 
void mouseReleaseEvent (QMouseEvent *event) override
 This event handler can be reimplemented in a subclass to receive mouse release events for an item.
 
void mouseUngrabEvent () override
 This event handler can be reimplemented in a subclass to be notified when a mouse ungrab event has occurred on this item.
 
void geometryChange (const QRectF &newGeometry, const QRectF &oldGeometry) override
 
virtual void fontChange (const QFont &newFont, const QFont &oldFont)
 
virtual void spacingChange (qreal newSpacing, qreal oldSpacing)
 
virtual void paddingChange (const QMarginsF &newPadding, const QMarginsF &oldPadding)
 
virtual void contentItemChange (QQuickItem *newItem, QQuickItem *oldItem)
 
virtual void localeChange (const QLocale &newLocale, const QLocale &oldLocale)
 
virtual void insetChange (const QMarginsF &newInset, const QMarginsF &oldInset)
 
virtual void enabledChange ()
 
QString accessibleName () const
 
void maybeSetAccessibleName (const QString &name)
 
QVariant accessibleProperty (const char *propertyName)
 
bool setAccessibleProperty (const char *propertyName, const QVariant &value)
 
- Protected Member Functions inherited from QQuickItem
bool event (QEvent *) override
 \reimp
 
bool isComponentComplete () const
 Returns true if construction of the QML component is complete; otherwise returns false.
 
bool widthValid () const
 Returns whether the width property has been set explicitly.
 
bool heightValid () const
 Returns whether the height property has been set explicitly.
 
void setImplicitSize (qreal, qreal)
 
void classBegin () override
 \reimp Derived classes should call the base class method before adding their own action to perform at classBegin.
 
void componentComplete () override
 \reimp Derived classes should call the base class method before adding their own actions to perform at componentComplete.
 
virtual void mouseDoubleClickEvent (QMouseEvent *event)
 This event handler can be reimplemented in a subclass to receive mouse double-click events for an item.
 
virtual void touchUngrabEvent ()
 This event handler can be reimplemented in a subclass to be notified when a touch ungrab event has occurred on this item.
 
virtual void touchEvent (QTouchEvent *event)
 This event handler can be reimplemented in a subclass to receive touch events for an item.
 
virtual void hoverEnterEvent (QHoverEvent *event)
 This event handler can be reimplemented in a subclass to receive hover-enter events for an item.
 
virtual void hoverMoveEvent (QHoverEvent *event)
 This event handler can be reimplemented in a subclass to receive hover-move events for an item.
 
virtual void hoverLeaveEvent (QHoverEvent *event)
 This event handler can be reimplemented in a subclass to receive hover-leave events for an item.
 
virtual bool childMouseEventFilter (QQuickItem *, QEvent *)
 Reimplement this method to filter the pointer events that are received by this item's children.
 
virtual QSGNodeupdatePaintNode (QSGNode *, UpdatePaintNodeData *)
 Called on the render thread when it is time to sync the state of the item with the scene graph.
 
virtual void releaseResources ()
 This function is called when an item should release graphics resources which are not already managed by the nodes returned from QQuickItem::updatePaintNode().
 
virtual void updatePolish ()
 This function should perform any layout as required for this item.
 
 QQuickItem (QQuickItemPrivate &dd, QQuickItem *parent=nullptr)
 
- Protected Member Functions inherited from QObject
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns \nullptr.
 
int senderSignalIndex () const
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal.
 
bool isSignalConnected (const QMetaMethod &signal) const
 
virtual void timerEvent (QTimerEvent *event)
 This event handler can be reimplemented in a subclass to receive timer events for the object.
 
virtual void childEvent (QChildEvent *event)
 This event handler can be reimplemented in a subclass to receive child events.
 
virtual void customEvent (QEvent *event)
 This event handler can be reimplemented in a subclass to receive custom events.
 
virtual void connectNotify (const QMetaMethod &signal)
 
virtual void disconnectNotify (const QMetaMethod &signal)
 
 QObject (QObjectPrivate &dd, QObject *parent=nullptr)
 

Properties

qreal from
 
qreal to
 
qreal value
 
qreal position
 
qreal angle
 
qreal startAngle
 
qreal endAngle
 
qreal stepSize
 
SnapMode snapMode
 
bool wrap
 
bool pressed
 
QQuickItemhandle
 
bool live
 
InputMode inputMode
 
- Properties inherited from QQuickControl
QFont font
 
qreal availableWidth
 
qreal availableHeight
 
qreal padding
 
qreal topPadding
 
qreal leftPadding
 
qreal rightPadding
 
qreal bottomPadding
 
qreal spacing
 
QLocale locale
 
bool mirrored
 
Qt::FocusReason focusReason
 
bool visualFocus
 
bool hovered
 
bool hoverEnabled
 
bool wheelEnabled
 
QQuickItembackground
 
QQuickItemcontentItem
 
qreal baselineOffset
 
qreal horizontalPadding
 
qreal verticalPadding
 
qreal implicitContentWidth
 
qreal implicitContentHeight
 
qreal implicitBackgroundWidth
 
qreal implicitBackgroundHeight
 
qreal topInset
 
qreal leftInset
 
qreal rightInset
 
qreal bottomInset
 
- Properties inherited from QQuickItem
QQuickItemparent
 \qmlproperty Item QtQuick::Item::parent This property holds the visual parent of the item.
 
qreal x
 \qmlproperty real QtQuick::Item::x \qmlproperty real QtQuick::Item::y \qmlproperty real QtQuick::Item::width \qmlproperty real QtQuick::Item::height
 
qreal y
 Defines the item's y position relative to its parent.
 
qreal z
 \qmlproperty real QtQuick::Item::z
 
qreal width
 This property holds the width of this item.
 
qreal height
 This property holds the height of this item.
 
qreal opacity
 \qmlproperty real QtQuick::Item::opacity
 
bool enabled
 \qmlproperty bool QtQuick::Item::enabled
 
bool visible
 \qmlproperty bool QtQuick::Item::visible
 
Qt::FocusPolicy focusPolicy
 \qmlproperty enumeration QtQuick::Item::focusPolicy
 
qreal rotation
 \qmlproperty real QtQuick::Item::rotation This property holds the rotation of the item in degrees clockwise around its transformOrigin.
 
qreal scale
 \qmlproperty real QtQuick::Item::scale This property holds the scale factor for this item.
 
TransformOrigin transformOrigin
 \qmlproperty enumeration QtQuick::Item::transformOrigin This property holds the origin point around which scale and rotation transform.
 
QPointF transformOriginPoint
 
QQmlListProperty< QQuickTransformtransform
 \qmlproperty list<Transform> QtQuick::Item::transform This property holds the list of transformations to apply.
 
bool smooth
 \qmlproperty bool QtQuick::Item::smooth
 
bool antialiasing
 \qmlproperty bool QtQuick::Item::antialiasing
 
qreal implicitWidth
 
qreal implicitHeight
 
QObjectcontainmentMask
 \qmlproperty QObject* QtQuick::Item::containmentMask
 
- Properties inherited from QObject
QString objectName
 the name of this object
 

Additional Inherited Members

- Static Public Member Functions inherited from QObject
static QMetaObject::Connection connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 \threadsafe
 
static QMetaObject::Connection connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename Func1 , typename Func2 >
static QMetaObject::Connection connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::ContextTypeForFunctor< Func2 >::ContextType *context, Func2 &&slot, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename Func1 , typename Func2 >
static QMetaObject::Connection connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 &&slot)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 \threadsafe
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static bool disconnect (const QMetaObject::Connection &)
 Disconnect a connection.
 
template<typename Func1 , typename Func2 >
static bool disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiver, Func2 slot)
 
template<typename Func1 >
static bool disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *receiver, void **zero)
 
- Public Attributes inherited from QQuickItem
const QSizetargetSize = QSize())
 
qreal y const
 
- Protected Attributes inherited from QObject
QScopedPointer< QObjectDatad_ptr
 

Detailed Description

Definition at line 27 of file qquickdial_p.h.

Member Enumeration Documentation

◆ InputMode

Enumerator
Circular 
Horizontal 
Vertical 

Definition at line 85 of file qquickdial_p.h.

◆ SnapMode

Enumerator
NoSnap 
SnapAlways 
SnapOnRelease 

Definition at line 75 of file qquickdial_p.h.

◆ WrapDirection

Enumerator
Clockwise 
CounterClockwise 

Definition at line 92 of file qquickdial_p.h.

Constructor & Destructor Documentation

◆ QQuickDial()

QQuickDial::QQuickDial ( QQuickItem * parent = nullptr)
explicit

Definition at line 364 of file qquickdial.cpp.

Member Function Documentation

◆ angle()

qreal QQuickDial::angle ( ) const

\qmlproperty real QtQuick.Controls::Dial::angle \readonly

This property holds the clockwise angle of the handle in degrees.

The angle is zero at the 12 o'clock position and the range is from \l startAngle to endAngle.

See also
position, startAngle, endAngle

Definition at line 492 of file qquickdial.cpp.

◆ angleChanged

void QQuickDial::angleChanged ( )
signal

◆ componentComplete()

void QQuickDial::componentComplete ( )
overrideprotectedvirtual

Invoked after the root component that caused this instantiation has completed construction.

At this point all static values and binding values have been assigned to the class.

Reimplemented from QQuickControl.

Definition at line 992 of file qquickdial.cpp.

◆ decrease

void QQuickDial::decrease ( )
slot

\qmlmethod void QtQuick.Controls::Dial::decrease()

Decreases the value by \l stepSize, or 0.1 if stepSize is not defined.

See also
stepSize

Definition at line 866 of file qquickdial.cpp.

◆ endAngle()

qreal QQuickDial::endAngle ( ) const

\qmlproperty real QtQuick.Controls::Dial::endAngle

Since
6.6

This property holds the end angle of the dial in degrees.

This is the \l angle the dial will have for its maximum value, i.e. \l to. The \l endAngle has to be bigger than the \l startAngle, smaller than 720 and smaller or equal than the \l startAngle + 360 degrees.

See also
endAngle, angle

Definition at line 607 of file qquickdial.cpp.

◆ from()

qreal QQuickDial::from ( ) const

\qmlproperty real QtQuick.Controls::Dial::from

This property holds the starting value for the range. The default value is 0.0.

See also
to, value

Definition at line 386 of file qquickdial.cpp.

◆ fromChanged

void QQuickDial::fromChanged ( )
signal

◆ handle()

QQuickItem * QQuickDial::handle ( ) const

\qmlproperty Item QtQuick.Controls::Dial::handle

This property holds the handle of the dial.

The handle acts as a visual indicator of the position of the dial.

See also
{Customizing Dial}

Definition at line 791 of file qquickdial.cpp.

◆ handleChanged

void QQuickDial::handleChanged ( )
signal

◆ increase

void QQuickDial::increase ( )
slot

\qmlmethod void QtQuick.Controls::Dial::increase()

Increases the value by \l stepSize, or 0.1 if stepSize is not defined.

See also
stepSize

Definition at line 852 of file qquickdial.cpp.

◆ inputMode()

QQuickDial::InputMode QQuickDial::inputMode ( ) const
Since
QtQuick.Controls 2.5 (Qt 5.12) \qmlproperty enumeration QtQuick.Controls::Dial::inputMode

This property holds the input mode.

inputMode

The default value is Dial.Circular.

Definition at line 697 of file qquickdial.cpp.

◆ isPressed()

bool QQuickDial::isPressed ( ) const

\qmlproperty bool QtQuick.Controls::Dial::pressed

This property holds whether the dial is pressed.

The dial will be pressed when either the mouse is pressed over it, or a key such as Qt.Key_Left is held down. If you'd prefer not to have the dial be pressed upon key presses (due to styling reasons, for example), you can use the \l {Keys}{Keys attached property}:

Dial {
Keys.onLeftPressed: {}
}

This will result in pressed only being true upon mouse presses.

Definition at line 765 of file qquickdial.cpp.

◆ keyPressEvent()

void QQuickDial::keyPressEvent ( QKeyEvent * event)
overrideprotectedvirtual

This event handler can be reimplemented in a subclass to receive key press events for an item.

The event information is provided by the event parameter.

\input item.qdocinc accepting-events

Reimplemented from QQuickItem.

Definition at line 873 of file qquickdial.cpp.

◆ keyReleaseEvent()

void QQuickDial::keyReleaseEvent ( QKeyEvent * event)
overrideprotectedvirtual

This event handler can be reimplemented in a subclass to receive key release events for an item.

The event information is provided by the event parameter.

\input item.qdocinc accepting-events

Reimplemented from QQuickItem.

Definition at line 915 of file qquickdial.cpp.

◆ live()

bool QQuickDial::live ( ) const
Since
QtQuick.Controls 2.2 (Qt 5.9) \qmlproperty bool QtQuick.Controls::Dial::live

This property holds whether the dial provides live updates for the \l value property while the handle is dragged.

The default value is true.

See also
value

Definition at line 829 of file qquickdial.cpp.

◆ mirrorChange()

void QQuickDial::mirrorChange ( )
overrideprotectedvirtual

Reimplemented from QQuickControl.

Definition at line 986 of file qquickdial.cpp.

◆ mousePressEvent()

void QQuickDial::mousePressEvent ( QMouseEvent * event)
overrideprotectedvirtual

This event handler can be reimplemented in a subclass to receive mouse press events for an item.

The event information is provided by the event parameter.

In order to receive mouse press events, \l acceptedMouseButtons() must return the relevant mouse button.

\input item.qdocinc accepting-events

Reimplemented from QQuickControl.

Definition at line 921 of file qquickdial.cpp.

◆ position()

qreal QQuickDial::position ( ) const

\qmlproperty real QtQuick.Controls::Dial::position \readonly

This property holds the logical position of the handle.

The position is expressed as a fraction of the control's angle range (the range within which the handle can be moved) in the range {0.0 - 1.0}.

See also
value, angle

Definition at line 475 of file qquickdial.cpp.

◆ positionChanged

void QQuickDial::positionChanged ( )
signal

◆ pressedChanged

void QQuickDial::pressedChanged ( )
signal

◆ Q_REVISION [1/6]

QQuickDial::Q_REVISION ( 2 ,
2  )
signal

◆ Q_REVISION [2/6]

QQuickDial::Q_REVISION ( 2 ,
2  )
signal

◆ Q_REVISION [3/6]

QQuickDial::Q_REVISION ( 2 ,
5  )
signal

◆ Q_REVISION [4/6]

QQuickDial::Q_REVISION ( 6 ,
6  )
signal

◆ Q_REVISION [5/6]

QQuickDial::Q_REVISION ( 6 ,
6  )
signal

◆ Q_REVISION [6/6]

QQuickDial::Q_REVISION ( 6 ,
6  )
signal

◆ setEndAngle()

void QQuickDial::setEndAngle ( qreal endAngle)

Definition at line 614 of file qquickdial.cpp.

◆ setFrom()

void QQuickDial::setFrom ( qreal from)

Definition at line 392 of file qquickdial.cpp.

◆ setHandle()

void QQuickDial::setHandle ( QQuickItem * handle)

Definition at line 799 of file qquickdial.cpp.

◆ setInputMode()

void QQuickDial::setInputMode ( QQuickDial::InputMode mode)

Definition at line 703 of file qquickdial.cpp.

◆ setLive()

void QQuickDial::setLive ( bool live)

Definition at line 835 of file qquickdial.cpp.

◆ setPressed()

void QQuickDial::setPressed ( bool pressed)

Definition at line 771 of file qquickdial.cpp.

◆ setSnapMode()

void QQuickDial::setSnapMode ( SnapMode mode)

Definition at line 677 of file qquickdial.cpp.

◆ setStartAngle()

void QQuickDial::setStartAngle ( qreal startAngle)

Definition at line 552 of file qquickdial.cpp.

◆ setStepSize()

void QQuickDial::setStepSize ( qreal step)

Definition at line 522 of file qquickdial.cpp.

◆ setTo()

void QQuickDial::setTo ( qreal to)

Definition at line 421 of file qquickdial.cpp.

◆ setValue()

void QQuickDial::setValue ( qreal value)

Definition at line 450 of file qquickdial.cpp.

◆ setWrap()

void QQuickDial::setWrap ( bool wrap)

Definition at line 737 of file qquickdial.cpp.

◆ snapMode()

QQuickDial::SnapMode QQuickDial::snapMode ( ) const

\qmlproperty enumeration QtQuick.Controls::Dial::snapMode

This property holds the snap mode.

The snap mode works with the \l stepSize to allow the handle to snap to certain points along the dial.

Possible values: \value Dial.NoSnap The dial does not snap (default). \value Dial.SnapAlways The dial snaps while the handle is dragged. \value Dial.SnapOnRelease The dial does not snap while being dragged, but only after the handle is released.

See also
stepSize

Definition at line 671 of file qquickdial.cpp.

◆ snapModeChanged

void QQuickDial::snapModeChanged ( )
signal

◆ startAngle()

qreal QQuickDial::startAngle ( ) const

\qmlproperty real QtQuick.Controls::Dial::startAngle

Since
6.6

This property holds the starting angle of the dial in degrees.

This is the \l angle the dial will have for its minimum value, i.e. \l from. The \l startAngle has to be smaller than the \l endAngle, larger than -360 and larger or equal to the \l endAngle - 360 degrees.

See also
endAngle, angle

Definition at line 546 of file qquickdial.cpp.

◆ stepSize()

qreal QQuickDial::stepSize ( ) const

\qmlproperty real QtQuick.Controls::Dial::stepSize

This property holds the step size.

The step size determines the amount by which the dial's value is increased and decreased when interacted with via the keyboard. For example, a step size of 0.2, will result in the dial's value increasing and decreasing in increments of 0.2.

The step size is only respected for touch and mouse interaction when \l snapMode is set to a value other than Dial.NoSnap.

The default value is 0.0, which results in an effective step size of 0.1 for keyboard interaction.

See also
snapMode, increase(), decrease()

Definition at line 516 of file qquickdial.cpp.

◆ stepSizeChanged

void QQuickDial::stepSizeChanged ( )
signal

◆ to()

qreal QQuickDial::to ( ) const

\qmlproperty real QtQuick.Controls::Dial::to

This property holds the end value for the range. The default value is 1.0.

See also
from, value

Definition at line 415 of file qquickdial.cpp.

◆ toChanged

void QQuickDial::toChanged ( )
signal

◆ value()

qreal QQuickDial::value ( ) const

\qmlproperty real QtQuick.Controls::Dial::value

This property holds the value in the range from - to. The default value is 0.0.

See also
position, live

Definition at line 444 of file qquickdial.cpp.

◆ valueChanged

void QQuickDial::valueChanged ( )
signal

◆ wrap()

bool QQuickDial::wrap ( ) const

\qmlproperty bool QtQuick.Controls::Dial::wrap

This property holds whether the dial wraps when dragged.

For example, when this property is set to true, dragging the dial past the \l to position will result in the handle being positioned at the \l from position, and vice versa:

When this property is false, it's not possible to drag the dial across the from and to values.

The default value is false.

Definition at line 731 of file qquickdial.cpp.

◆ wrapChanged

void QQuickDial::wrapChanged ( )
signal

Property Documentation

◆ angle

qreal QQuickDial::angle
read

Definition at line 34 of file qquickdial_p.h.

◆ endAngle

qreal QQuickDial::endAngle
readwrite

Definition at line 36 of file qquickdial_p.h.

◆ from

qreal QQuickDial::from
readwrite

Definition at line 30 of file qquickdial_p.h.

◆ handle

QQuickItem * QQuickDial::handle
readwrite

Definition at line 41 of file qquickdial_p.h.

◆ inputMode

InputMode QQuickDial::inputMode
readwrite

Definition at line 45 of file qquickdial_p.h.

◆ live

bool QQuickDial::live
readwrite

Definition at line 43 of file qquickdial_p.h.

◆ position

qreal QQuickDial::position
read

Definition at line 33 of file qquickdial_p.h.

◆ pressed

bool QQuickDial::pressed
read

Definition at line 40 of file qquickdial_p.h.

◆ snapMode

SnapMode QQuickDial::snapMode
readwrite

Definition at line 38 of file qquickdial_p.h.

◆ startAngle

qreal QQuickDial::startAngle
readwrite

Definition at line 35 of file qquickdial_p.h.

◆ stepSize

qreal QQuickDial::stepSize
readwrite

Definition at line 37 of file qquickdial_p.h.

◆ to

qreal QQuickDial::to
readwrite

Definition at line 31 of file qquickdial_p.h.

◆ value

qreal QQuickDial::value
readwrite

Definition at line 32 of file qquickdial_p.h.

◆ wrap

bool QQuickDial::wrap
readwrite

Definition at line 39 of file qquickdial_p.h.


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