Doc: corrected link/example errors
Update pro files after move gestures folder Update snippet statements Corrected path in imagegestures.pro Task-number: QTBUG-34749 Change-Id: Icc19908914e36507e412ab63bf0cc2809aa48e17 Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
This commit is contained in:
parent
14addd2cbb
commit
0b26ad05bb
@ -4,7 +4,6 @@ CONFIG += no_docs_target
|
|||||||
SUBDIRS = \
|
SUBDIRS = \
|
||||||
dbus \
|
dbus \
|
||||||
embedded \
|
embedded \
|
||||||
gestures \
|
|
||||||
gui \
|
gui \
|
||||||
ipc \
|
ipc \
|
||||||
json \
|
json \
|
||||||
|
@ -63,7 +63,7 @@
|
|||||||
\endlist
|
\endlist
|
||||||
|
|
||||||
In this example, we will demonstrate the asynchronous approach. The
|
In this example, we will demonstrate the asynchronous approach. The
|
||||||
\l{blockingfortuneclient}{Blocking Fortune Client} example
|
\l{blockingfortuneclient}{Blocking Fortune Client Example}
|
||||||
illustrates the synchronous approach.
|
illustrates the synchronous approach.
|
||||||
|
|
||||||
Our class contains some data and a few private slots:
|
Our class contains some data and a few private slots:
|
||||||
|
@ -33,7 +33,7 @@
|
|||||||
|
|
||||||
This example is intended to be run alongside the
|
This example is intended to be run alongside the
|
||||||
\l{fortuneclient}{Fortune Client} example or the
|
\l{fortuneclient}{Fortune Client} example or the
|
||||||
\l{blockingfortuneclient}{Blocking Fortune Client} example.
|
\l{blockingfortuneclient}{Blocking Fortune Client Example}.
|
||||||
|
|
||||||
\image fortuneserver-example.png Screenshot of the Fortune Server example
|
\image fortuneserver-example.png Screenshot of the Fortune Server example
|
||||||
|
|
||||||
|
@ -47,7 +47,7 @@
|
|||||||
large set of problems, including synchronous network I/O and
|
large set of problems, including synchronous network I/O and
|
||||||
database access, where the user interface must remain responsive
|
database access, where the user interface must remain responsive
|
||||||
while some heavy operation is taking place. The \l
|
while some heavy operation is taking place. The \l
|
||||||
network/blockingfortuneclient example shows the same principle at
|
{Blocking Fortune Client Example} shows the same principle at
|
||||||
work in a TCP client.
|
work in a TCP client.
|
||||||
|
|
||||||
The Mandelbrot application supports zooming and scrolling using
|
The Mandelbrot application supports zooming and scrolling using
|
||||||
|
@ -316,7 +316,7 @@
|
|||||||
\title Plug & Paint Basic Tools Example
|
\title Plug & Paint Basic Tools Example
|
||||||
|
|
||||||
The Basic Tools example is a static plugin for the
|
The Basic Tools example is a static plugin for the
|
||||||
\l{plugandpaint}{Plug & Paint} example. It provides a set
|
\l{tools/plugandpaint}{Plug & Paint} example. It provides a set
|
||||||
of basic brushes, shapes, and filters. Through the Basic Tools
|
of basic brushes, shapes, and filters. Through the Basic Tools
|
||||||
example, we will review the four steps involved in writing a Qt
|
example, we will review the four steps involved in writing a Qt
|
||||||
plugin:
|
plugin:
|
||||||
@ -333,7 +333,7 @@
|
|||||||
\snippet tools/plugandpaintplugins/basictools/basictoolsplugin.h 0
|
\snippet tools/plugandpaintplugins/basictools/basictoolsplugin.h 0
|
||||||
|
|
||||||
We start by including \c interfaces.h, which defines the plugin
|
We start by including \c interfaces.h, which defines the plugin
|
||||||
interfaces for the \l{plugandpaint}{Plug & Paint}
|
interfaces for the \l{tools/plugandpaint}{Plug & Paint}
|
||||||
application. For the \c #include to work, we need to add an \c
|
application. For the \c #include to work, we need to add an \c
|
||||||
INCLUDEPATH entry to the \c .pro file with the path to Qt's \c
|
INCLUDEPATH entry to the \c .pro file with the path to Qt's \c
|
||||||
examples/tools directory.
|
examples/tools directory.
|
||||||
@ -344,7 +344,7 @@
|
|||||||
The \c Q_INTERFACES() macro is necessary to tell \l{moc}, Qt's
|
The \c Q_INTERFACES() macro is necessary to tell \l{moc}, Qt's
|
||||||
meta-object compiler, that the base classes are plugin
|
meta-object compiler, that the base classes are plugin
|
||||||
interfaces. Without the \c Q_INTERFACES() macro, we couldn't use
|
interfaces. Without the \c Q_INTERFACES() macro, we couldn't use
|
||||||
\l qobject_cast() in the \l{plugandpaint}{Plug & Paint}
|
\l qobject_cast() in the \l{tools/plugandpaint}{Plug & Paint}
|
||||||
application to detect interfaces.
|
application to detect interfaces.
|
||||||
For an explanation for the \c Q_PLUGIN_METADATA() macro see
|
For an explanation for the \c Q_PLUGIN_METADATA() macro see
|
||||||
\l {Exporting the Plugin}.
|
\l {Exporting the Plugin}.
|
||||||
@ -501,7 +501,7 @@
|
|||||||
\title Plug & Paint Extra Filters Example
|
\title Plug & Paint Extra Filters Example
|
||||||
|
|
||||||
The Extra Filters example is a plugin for the
|
The Extra Filters example is a plugin for the
|
||||||
\l{plugandpaint}{Plug & Paint} example. It provides a set
|
\l{tools/plugandpaint}{Plug & Paint} example. It provides a set
|
||||||
of filters in addition to those provided by the
|
of filters in addition to those provided by the
|
||||||
\l{tools/plugandpaintplugins/basictools}{Basic Tools} plugin.
|
\l{tools/plugandpaintplugins/basictools}{Basic Tools} plugin.
|
||||||
|
|
||||||
|
@ -43,9 +43,9 @@
|
|||||||
The \c ImageWidget class is a simple QWidget subclass that reimplements the general
|
The \c ImageWidget class is a simple QWidget subclass that reimplements the general
|
||||||
QWidget::event() handler function in addition to several more specific event handlers:
|
QWidget::event() handler function in addition to several more specific event handlers:
|
||||||
|
|
||||||
\snippet examples/gestures/imagegestures/imagewidget.h class definition begin
|
\snippet gestures/imagegestures/imagewidget.h class definition begin
|
||||||
\dots
|
\dots
|
||||||
\snippet examples/gestures/imagegestures/imagewidget.h class definition end
|
\snippet gestures/imagegestures/imagewidget.h class definition end
|
||||||
|
|
||||||
We also implement a private helper function, \c gestureEvent(), to help manage
|
We also implement a private helper function, \c gestureEvent(), to help manage
|
||||||
gesture events delivered to the widget, and three functions to perform actions
|
gesture events delivered to the widget, and three functions to perform actions
|
||||||
@ -56,7 +56,7 @@
|
|||||||
In the widget's constructor, we begin by setting up various parameters that will
|
In the widget's constructor, we begin by setting up various parameters that will
|
||||||
be used to control the way images are displayed.
|
be used to control the way images are displayed.
|
||||||
|
|
||||||
\snippet examples/gestures/imagegestures/imagewidget.cpp constructor
|
\snippet gestures/imagegestures/imagewidget.cpp constructor
|
||||||
|
|
||||||
We enable three of the standard gestures for the widget by calling QWidget::grabGesture()
|
We enable three of the standard gestures for the widget by calling QWidget::grabGesture()
|
||||||
with the types of gesture we need. These will be recognized by the application's
|
with the types of gesture we need. These will be recognized by the application's
|
||||||
@ -65,7 +65,7 @@
|
|||||||
Since QWidget does not define a specific event handler for gestures, the widget
|
Since QWidget does not define a specific event handler for gestures, the widget
|
||||||
needs to reimplement the general QWidget::event() to receive gesture events.
|
needs to reimplement the general QWidget::event() to receive gesture events.
|
||||||
|
|
||||||
\snippet examples/gestures/imagegestures/imagewidget.cpp event handler
|
\snippet gestures/imagegestures/imagewidget.cpp event handler
|
||||||
|
|
||||||
We implement the event handler to delegate gesture events to a private function
|
We implement the event handler to delegate gesture events to a private function
|
||||||
specifically written for the task, and pass all other events to QWidget's
|
specifically written for the task, and pass all other events to QWidget's
|
||||||
@ -76,7 +76,7 @@
|
|||||||
used on a widget at any particular time, we can check for each gesture type
|
used on a widget at any particular time, we can check for each gesture type
|
||||||
using the QGestureEvent::gesture() function:
|
using the QGestureEvent::gesture() function:
|
||||||
|
|
||||||
\snippet examples/gestures/imagegestures/imagewidget.cpp gesture event handler
|
\snippet gestures/imagegestures/imagewidget.cpp gesture event handler
|
||||||
|
|
||||||
If a QGesture object is supplied for a certain type of gesture, we call a special
|
If a QGesture object is supplied for a certain type of gesture, we call a special
|
||||||
purpose function to deal with it, casting the gesture object to the appropriate
|
purpose function to deal with it, casting the gesture object to the appropriate
|
||||||
@ -87,7 +87,7 @@
|
|||||||
gesture associated with a brushing or swiping motion on the user's display or
|
gesture associated with a brushing or swiping motion on the user's display or
|
||||||
input device:
|
input device:
|
||||||
|
|
||||||
\snippet examples/gestures/imagegestures/imagewidget.cpp swipe function
|
\snippet gestures/imagegestures/imagewidget.cpp swipe function
|
||||||
|
|
||||||
The QSwipeGesture class provides specialized functions and defines a enum
|
The QSwipeGesture class provides specialized functions and defines a enum
|
||||||
to make it more convenient for developers to discover which direction, if
|
to make it more convenient for developers to discover which direction, if
|
@ -7,6 +7,6 @@ SOURCES = imagewidget.cpp \
|
|||||||
mainwidget.cpp
|
mainwidget.cpp
|
||||||
|
|
||||||
# install
|
# install
|
||||||
target.path = $$[QT_INSTALL_EXAMPLES]/gestures/imagegestures
|
target.path = $$[QT_INSTALL_EXAMPLES]/widgets/gestures/imagegestures
|
||||||
INSTALLS += target
|
INSTALLS += target
|
||||||
|
|
@ -9,6 +9,7 @@ SUBDIRS = \
|
|||||||
dialogs \
|
dialogs \
|
||||||
draganddrop \
|
draganddrop \
|
||||||
effects \
|
effects \
|
||||||
|
gestures \
|
||||||
graphicsview \
|
graphicsview \
|
||||||
itemviews \
|
itemviews \
|
||||||
layouts \
|
layouts \
|
||||||
|
@ -34,7 +34,7 @@
|
|||||||
\image opengl-examples.png
|
\image opengl-examples.png
|
||||||
|
|
||||||
These examples describe how to use the Qt OpenGL Module. For new code,
|
These examples describe how to use the Qt OpenGL Module. For new code,
|
||||||
please use the OpenGL classes in the \l {Qt GUI Module}.
|
please use the OpenGL classes in the \l QtGui module.
|
||||||
|
|
||||||
|
|
||||||
Qt provides support for integration with OpenGL implementations on all
|
Qt provides support for integration with OpenGL implementations on all
|
||||||
|
@ -56,7 +56,7 @@
|
|||||||
|
|
||||||
\list
|
\list
|
||||||
\li \l{Qt Test C++ Classes}{C++ Classes}
|
\li \l{Qt Test C++ Classes}{C++ Classes}
|
||||||
\li \l{Qt Quick Test}{QML Types}
|
\li \l{Qt Quick Test QML Types}{QML Types}
|
||||||
\endlist
|
\endlist
|
||||||
|
|
||||||
*/
|
*/
|
||||||
|
@ -27,7 +27,7 @@ qhp.QtWidgets.subprojects.classes.sortPages = true
|
|||||||
|
|
||||||
tagfile = ../../../doc/qtwidgets/qtwidgets.tags
|
tagfile = ../../../doc/qtwidgets/qtwidgets.tags
|
||||||
|
|
||||||
depends += qtcore qtgui qtdoc qtsql qtdesigner
|
depends += qtcore qtgui qtdoc qtsql qtdesigner qtquick
|
||||||
|
|
||||||
headerdirs += ..
|
headerdirs += ..
|
||||||
|
|
||||||
|
@ -67,7 +67,7 @@
|
|||||||
required gesture type. The standard types are defined by the Qt::GestureType
|
required gesture type. The standard types are defined by the Qt::GestureType
|
||||||
enum and include many commonly used gestures.
|
enum and include many commonly used gestures.
|
||||||
|
|
||||||
\snippet ../../../examples/gestures/imagegestures/imagewidget.cpp enable gestures
|
\snippet gestures/imagegestures/imagewidget.cpp enable gestures
|
||||||
|
|
||||||
In the above code, the gestures are set up in the constructor of the target object
|
In the above code, the gestures are set up in the constructor of the target object
|
||||||
itself.
|
itself.
|
||||||
@ -124,18 +124,18 @@
|
|||||||
\l{QWidget::}{event()} handler function and delegates gesture events to a
|
\l{QWidget::}{event()} handler function and delegates gesture events to a
|
||||||
specialized gestureEvent() function:
|
specialized gestureEvent() function:
|
||||||
|
|
||||||
\snippet ../../../examples/gestures/imagegestures/imagewidget.cpp event handler
|
\snippet gestures/imagegestures/imagewidget.cpp event handler
|
||||||
|
|
||||||
The gesture events delivered to the target object can be examined individually
|
The gesture events delivered to the target object can be examined individually
|
||||||
and dealt with appropriately:
|
and dealt with appropriately:
|
||||||
|
|
||||||
\snippet ../../../examples/gestures/imagegestures/imagewidget.cpp gesture event handler
|
\snippet gestures/imagegestures/imagewidget.cpp gesture event handler
|
||||||
|
|
||||||
Responding to a gesture is simply a matter of obtaining the QGesture object
|
Responding to a gesture is simply a matter of obtaining the QGesture object
|
||||||
delivered in the QGestureEvent sent to the target object and examining the
|
delivered in the QGestureEvent sent to the target object and examining the
|
||||||
information it contains.
|
information it contains.
|
||||||
|
|
||||||
\snippet ../../../examples/gestures/imagegestures/imagewidget.cpp swipe function
|
\snippet gestures/imagegestures/imagewidget.cpp swipe function
|
||||||
|
|
||||||
Here, we examine the direction in which the user swiped the widget and modify
|
Here, we examine the direction in which the user swiped the widget and modify
|
||||||
its contents accordingly.
|
its contents accordingly.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user