summaryrefslogtreecommitdiffstats
path: root/examples/widgets/doc/src
diff options
context:
space:
mode:
authorJerome Pasion <jerome.pasion@qt.io>2025-04-30 16:13:39 +0200
committerJerome Pasion <jerome.pasion@qt.io>2025-10-09 16:04:44 +0000
commit87806f5cad6e4ce75a899598c15c126995682562 (patch)
treec415590ca720b9ec3a1cd2c7cba224e5a64f997d /examples/widgets/doc/src
parent1084ef0094e152aa4a89e1f5519ced8d865c68d1 (diff)
Doc: Add alternate text for Qt Widgets images
Alternate text (alt text) improves the documentation experience for screen readers and for other accessibility tools. Pick-to: 6.9 6.10 Task-number: QTBUG-135124 Change-Id: Ic481c1468548d197a69c9e19703c5773226fbd39 Reviewed-by: Alexei Cazacov <alexei.cazacov@qt.io>
Diffstat (limited to 'examples/widgets/doc/src')
-rw-r--r--examples/widgets/doc/src/addressbook.qdoc16
-rw-r--r--examples/widgets/doc/src/affine.qdoc2
-rw-r--r--examples/widgets/doc/src/analogclock.qdoc4
-rw-r--r--examples/widgets/doc/src/basicdrawing.qdoc1
-rw-r--r--examples/widgets/doc/src/calculator.qdoc4
-rw-r--r--examples/widgets/doc/src/calendarwidget.qdoc3
-rw-r--r--examples/widgets/doc/src/chip.qdoc1
-rw-r--r--examples/widgets/doc/src/collidingmice-example.qdoc1
-rw-r--r--examples/widgets/doc/src/combowidgetmapper.qdoc2
-rw-r--r--examples/widgets/doc/src/completer.qdoc3
-rw-r--r--examples/widgets/doc/src/composition.qdoc1
-rw-r--r--examples/widgets/doc/src/cuberhiwidget.qdoc1
-rw-r--r--examples/widgets/doc/src/deform.qdoc1
-rw-r--r--examples/widgets/doc/src/diagramscene.qdoc1
-rw-r--r--examples/widgets/doc/src/dragdroprobot.qdoc1
-rw-r--r--examples/widgets/doc/src/draggableicons.qdoc1
-rw-r--r--examples/widgets/doc/src/draggabletext.qdoc1
-rw-r--r--examples/widgets/doc/src/easing.qdoc1
-rw-r--r--examples/widgets/doc/src/editabletreemodel.qdoc5
-rw-r--r--examples/widgets/doc/src/elasticnodes.qdoc1
-rw-r--r--examples/widgets/doc/src/fetchmore.qdoc1
-rw-r--r--examples/widgets/doc/src/frozencolumn.qdoc5
-rw-r--r--examples/widgets/doc/src/gradients.qdoc1
-rw-r--r--examples/widgets/doc/src/graphicsview-simpleanchorlayout.qdoc2
-rw-r--r--examples/widgets/doc/src/imagecomposition.qdoc1
-rw-r--r--examples/widgets/doc/src/licensewizard.qdoc4
-rw-r--r--examples/widgets/doc/src/lineedits.qdoc3
-rw-r--r--examples/widgets/doc/src/menus.qdoc1
-rw-r--r--examples/widgets/doc/src/orderform.qdoc2
-rw-r--r--examples/widgets/doc/src/painterpaths.qdoc1
-rw-r--r--examples/widgets/doc/src/pathstroke.qdoc1
-rw-r--r--examples/widgets/doc/src/regularexpression.qdoc1
-rw-r--r--examples/widgets/doc/src/screenshot.qdoc1
-rw-r--r--examples/widgets/doc/src/shapedclock.qdoc4
-rw-r--r--examples/widgets/doc/src/shortcuteditor.qdoc2
-rw-r--r--examples/widgets/doc/src/simplerhiwidget.qdoc1
-rw-r--r--examples/widgets/doc/src/simpletreemodel.qdoc2
-rw-r--r--examples/widgets/doc/src/sliders.qdoc3
-rw-r--r--examples/widgets/doc/src/spinboxes.qdoc2
-rw-r--r--examples/widgets/doc/src/spreadsheet.qdoc1
-rw-r--r--examples/widgets/doc/src/standarddialogs.qdoc2
-rw-r--r--examples/widgets/doc/src/syntaxhighlighter.qdoc1
-rw-r--r--examples/widgets/doc/src/tabdialog.qdoc2
-rw-r--r--examples/widgets/doc/src/tablet.qdoc2
-rw-r--r--examples/widgets/doc/src/transformations.qdoc1
-rw-r--r--examples/widgets/doc/src/treemodelcompleter.qdoc1
-rw-r--r--examples/widgets/doc/src/trivialwizard.qdoc7
-rw-r--r--examples/widgets/doc/src/windowflags.qdoc7
48 files changed, 84 insertions, 29 deletions
diff --git a/examples/widgets/doc/src/addressbook.qdoc b/examples/widgets/doc/src/addressbook.qdoc
index 8f2512298b4..58d7e010fdb 100644
--- a/examples/widgets/doc/src/addressbook.qdoc
+++ b/examples/widgets/doc/src/addressbook.qdoc
@@ -9,7 +9,7 @@
\brief The address book example shows how to use proxy models to display
different views onto data from a single model.
- \image addressbook-example.png Screenshot of the Address Book example
+ \image addressbook-example.png {Address book showing contacts and addresses}
This example provides an address book that allows contacts to be
grouped alphabetically into 9 groups: ABC, DEF, GHI, ... , VW,
@@ -25,7 +25,7 @@
\c AddDialog. The \c MainWindow class uses \c AddressWidget as
its central widget and provides \uicontrol File and \uicontrol Tools menus.
- \image addressbook-classes.png Diagram for Address Book example
+ \image addressbook-classes.png {Address book main classes and elements}
The \c AddressWidget class is a QTabWidget subclass that is used
to manipulate the 10 tabs displayed in the example: the 9
@@ -205,7 +205,7 @@
QTabWidget with the relevant label, obtained from the QStringList
of groups.
- \image addressbook-signals.png Signals and Slots Connections
+ \image addressbook-signals.png {Address book signals and slots connections}
We provide two \c addEntry() functions: One which is intended to be
used to accept user input, and the other which performs the actual
@@ -253,7 +253,7 @@
\snippet itemviews/addressbook/addresswidget.cpp 4b
- \image addressbook-editdialog.png Screenshot of Dialog to Edit a Contact
+ \image addressbook-editdialog.png {Dialog for editing name and address}
Entries are removed using the \c removeEntry() function.
The selected row is removed by accessing it through the
@@ -287,7 +287,7 @@
disappears according to the contents of the address book, as
mentioned in \c{AddressWidget}'s implementation.
- \image addressbook-newaddresstab.png Screenshot of NewAddressTab
+ \image addressbook-newaddresstab.png {Tab for adding new contacts}
The \c NewAddressTab class extends QWidget and contains a QLabel
and QPushButton.
@@ -311,7 +311,7 @@
\snippet itemviews/addressbook/newaddresstab.cpp 1
- \image signals-n-slots-aw-nat.png
+ \image signals-n-slots-aw-nat.png {Function calls for adding a new contact}
\section1 AddDialog Class Definition
@@ -322,7 +322,7 @@
\snippet itemviews/addressbook/adddialog.h 0
- \image addressbook-adddialog.png
+ \image addressbook-adddialog.png {Dialog for adding a new name and address}
\section1 AddDialog Class Implementation
@@ -346,7 +346,9 @@
\table
\row \li \inlineimage addressbook-filemenu.png
+ {Open, Save, and Exit items in File menu}
\li \inlineimage addressbook-toolsmenu.png
+ {Add Entry, Edit Entry, and Remove Entry in Tools menu}
\endtable
\snippet itemviews/addressbook/mainwindow.h 0
diff --git a/examples/widgets/doc/src/affine.qdoc b/examples/widgets/doc/src/affine.qdoc
index 2ec3a4fc4d9..47aeaac5e13 100644
--- a/examples/widgets/doc/src/affine.qdoc
+++ b/examples/widgets/doc/src/affine.qdoc
@@ -11,7 +11,7 @@
\brief In this example we show Qt's ability to perform affine transformations
on painting operations.
- \image affine-demo.png
+ \image affine-demo.png {Demonstration of affine transformations on an image}
Transformations can be performed on any kind of graphics drawn using QPainter.
The transformations used to display the vector graphics, images, and text can be adjusted
diff --git a/examples/widgets/doc/src/analogclock.qdoc b/examples/widgets/doc/src/analogclock.qdoc
index aeaddd4b936..78a6b1d7d78 100644
--- a/examples/widgets/doc/src/analogclock.qdoc
+++ b/examples/widgets/doc/src/analogclock.qdoc
@@ -11,7 +11,8 @@
\brief The Analog Clock example shows how to draw the contents of a
custom widget.
- \borderedimage analogclock-example.png
+ \image analogclock-example.png
+ {Analog clock with hour, minute, and seconds hands}
\caption Screenshot of the Analog Clock example
This example also demonstrates how the transformation and scaling
@@ -93,6 +94,7 @@
manual calculations just to draw the contents of a custom widget.
\image analogclock-viewport.png
+ {Shows widget coordinate system and origin on clock face}
We set the pen to be Qt::NoPen because we don't want any outline,
and we use a solid brush with the color appropriate for
diff --git a/examples/widgets/doc/src/basicdrawing.qdoc b/examples/widgets/doc/src/basicdrawing.qdoc
index bbdd19ff22c..9d046a87b79 100644
--- a/examples/widgets/doc/src/basicdrawing.qdoc
+++ b/examples/widgets/doc/src/basicdrawing.qdoc
@@ -20,6 +20,7 @@
but it can in addition do view and world transformation.
\image basicdrawing-example.png
+ {Window with various options for changing the drawing}
The example provides a render area, displaying the currently
active shape, and lets the user manipulate the rendered shape and
diff --git a/examples/widgets/doc/src/calculator.qdoc b/examples/widgets/doc/src/calculator.qdoc
index c59d3cd1619..31e6c6e99ea 100644
--- a/examples/widgets/doc/src/calculator.qdoc
+++ b/examples/widgets/doc/src/calculator.qdoc
@@ -11,7 +11,7 @@
functionality of a calculator widget, and how to use QGridLayout
to place child widgets in a grid.
- \borderedimage calculator-example.png
+ \image calculator-example.png {Basic calculator application}
\caption Screenshot of the Calculator example
The example consists of two classes:
@@ -352,7 +352,7 @@
QSizePolicy::Expanding in the constructor and if we didn't
reimplement QWidget::sizeHint().
- \borderedimage calculator-ugly.png
+ \image calculator-ugly.png {Calculator with misaligned buttons}
\caption The Calculator example with default size policies and size hints
*/
diff --git a/examples/widgets/doc/src/calendarwidget.qdoc b/examples/widgets/doc/src/calendarwidget.qdoc
index 01c6df6926d..840f2c9001a 100644
--- a/examples/widgets/doc/src/calendarwidget.qdoc
+++ b/examples/widgets/doc/src/calendarwidget.qdoc
@@ -9,7 +9,8 @@
\ingroup examples-layout
\brief The Calendar Widget example shows use of QCalendarWidget.
- \borderedimage calendarwidgetexample.png
+ \image calendarwidgetexample.png
+ {Calendar widget showing various calendar settings}
QCalendarWidget displays one calendar month
at a time and lets the user select a date.
diff --git a/examples/widgets/doc/src/chip.qdoc b/examples/widgets/doc/src/chip.qdoc
index 2c69c10f39f..498ff786449 100644
--- a/examples/widgets/doc/src/chip.qdoc
+++ b/examples/widgets/doc/src/chip.qdoc
@@ -13,4 +13,5 @@
views independently, and you can select and move items around the scene.
\image chip-demo.png
+ {Application showing computer chips and graphics options}
*/
diff --git a/examples/widgets/doc/src/collidingmice-example.qdoc b/examples/widgets/doc/src/collidingmice-example.qdoc
index a1b8e0e1412..b34232283a7 100644
--- a/examples/widgets/doc/src/collidingmice-example.qdoc
+++ b/examples/widgets/doc/src/collidingmice-example.qdoc
@@ -13,6 +13,7 @@
items.
\image collidingmice-example.png
+ {Application running with mice and cheese graphics}
Graphics View provides the QGraphicsScene class for managing and
interacting with a large number of custom-made 2D graphical items
diff --git a/examples/widgets/doc/src/combowidgetmapper.qdoc b/examples/widgets/doc/src/combowidgetmapper.qdoc
index aae546005c1..c06e21c066d 100644
--- a/examples/widgets/doc/src/combowidgetmapper.qdoc
+++ b/examples/widgets/doc/src/combowidgetmapper.qdoc
@@ -10,6 +10,7 @@
map information from a model to specific widgets on a form.
\image combowidgetmapper-example.png
+ {Application with various fields such as Name, Address, and Type}
We create a \c Window class with an almost identical user interface,
except that, instead of providing a spin box so that each person's age
@@ -78,6 +79,7 @@
delegate is used.
\image widgetmapper-combo-mapping.png
+ {Mapping of the model to the view using a delegate}
We show the implementation of the \c{updateButtons()} slot for
completeness:
diff --git a/examples/widgets/doc/src/completer.qdoc b/examples/widgets/doc/src/completer.qdoc
index f3e4fe8f0e5..1ae2576acc3 100644
--- a/examples/widgets/doc/src/completer.qdoc
+++ b/examples/widgets/doc/src/completer.qdoc
@@ -11,6 +11,7 @@
for an input widget based on data provided by a model.
\image completer-example.png
+ {Application showing various options and settings}
This example uses a custom item model, \c FileSystemModel, and a QCompleter object.
QCompleter is a class that provides completions based on an item model. The
@@ -184,6 +185,7 @@
The screenshot below shows the Completer with the country list model.
\image completer-example-country.png
+ {Application showing the country list model contents}
If \c case is 3, we attempt to complete words. This is done using a
QStringListModel that contains data extracted from \e{words.txt}. The
@@ -193,6 +195,7 @@
The screenshot below shows the Completer with the word list model.
\image completer-example-word.png
+ {Application showing the word list model contents}
Once the model type is selected, we call the \c changeMode() function and
the \c changeCase() function and set the wrap option accordingly. The
diff --git a/examples/widgets/doc/src/composition.qdoc b/examples/widgets/doc/src/composition.qdoc
index a8adcd25496..a3543f73429 100644
--- a/examples/widgets/doc/src/composition.qdoc
+++ b/examples/widgets/doc/src/composition.qdoc
@@ -11,6 +11,7 @@
\brief This demo shows some of the more advanced composition modes supported by Qt.
\image composition-demo.png
+ {Application that applies composition modes to image layers}
The two most common forms of composition are \b{Source} and \b{SourceOver}.
\b{Source} is used to draw opaque objects onto a paint device. In this mode,
diff --git a/examples/widgets/doc/src/cuberhiwidget.qdoc b/examples/widgets/doc/src/cuberhiwidget.qdoc
index a3c05ad800e..697c987afd4 100644
--- a/examples/widgets/doc/src/cuberhiwidget.qdoc
+++ b/examples/widgets/doc/src/cuberhiwidget.qdoc
@@ -9,6 +9,7 @@
\brief Shows how to render a textured cube and integrate with QPainter and widgets, using QRhi Qt's 3D API and shading language abstraction layer.
\image cuberhiwidget-example.jpg
+ {Application showing complex rendering overlays}
\caption Screenshot of the Cube RHI Widget example
This example builds on the \l{Simple RHI Widget Example}. While the simple
diff --git a/examples/widgets/doc/src/deform.qdoc b/examples/widgets/doc/src/deform.qdoc
index f33522fa3b5..82a3f60d682 100644
--- a/examples/widgets/doc/src/deform.qdoc
+++ b/examples/widgets/doc/src/deform.qdoc
@@ -12,6 +12,7 @@
using a \c QPainterPath.
\image deform-demo.png
+ {Application showing various vector deformation settings}
We define a vector deformation field in the shape of a lens and apply
this to all points in a path. This means that what is rendered on
diff --git a/examples/widgets/doc/src/diagramscene.qdoc b/examples/widgets/doc/src/diagramscene.qdoc
index 6f307ef97c1..70dc5cf2dfb 100644
--- a/examples/widgets/doc/src/diagramscene.qdoc
+++ b/examples/widgets/doc/src/diagramscene.qdoc
@@ -9,6 +9,7 @@
\brief Demonstrate how to use the Graphics View framework.
\image diagramscene.png
+ {Application with various flowchart graphics and icons}
The Diagram Scene example is an application in which you can
create a flowchart diagram. It is possible to add flowchart shapes
diff --git a/examples/widgets/doc/src/dragdroprobot.qdoc b/examples/widgets/doc/src/dragdroprobot.qdoc
index c9ff04574b3..0402e466487 100644
--- a/examples/widgets/doc/src/dragdroprobot.qdoc
+++ b/examples/widgets/doc/src/dragdroprobot.qdoc
@@ -13,6 +13,7 @@
\l{Animation Framework}.
\image dragdroprobot-example.png
+ {Application of a robot that responds to drag and drop events}
Graphics View provides the QGraphicsScene class for managing and
interacting with a large number of custom-made 2D graphical items derived
diff --git a/examples/widgets/doc/src/draggableicons.qdoc b/examples/widgets/doc/src/draggableicons.qdoc
index fd4f9e69e33..0f1feacb7fb 100644
--- a/examples/widgets/doc/src/draggableicons.qdoc
+++ b/examples/widgets/doc/src/draggableicons.qdoc
@@ -10,6 +10,7 @@
in the same application, and between different applications.
\image draggableicons-example.png
+ {Application with icons that respond to drag and drop events}
In many situations where drag and drop is used, the user starts dragging from
a particular widget and drops the payload onto another widget. In this example,
diff --git a/examples/widgets/doc/src/draggabletext.qdoc b/examples/widgets/doc/src/draggabletext.qdoc
index 6e15e7f9465..3609ed5a1a1 100644
--- a/examples/widgets/doc/src/draggabletext.qdoc
+++ b/examples/widgets/doc/src/draggabletext.qdoc
@@ -11,4 +11,5 @@
in the same application, and between different applications.
\image draggabletext-example.png
+ {Application with moveable text using drag and drop events}
*/
diff --git a/examples/widgets/doc/src/easing.qdoc b/examples/widgets/doc/src/easing.qdoc
index b1eefeee259..730f5c16da1 100644
--- a/examples/widgets/doc/src/easing.qdoc
+++ b/examples/widgets/doc/src/easing.qdoc
@@ -10,6 +10,7 @@
control the speed of an animation.
\image easing-example.png
+ {Application that applies different easing curves to an animation}
See \l QEasingCurve for a detailed description on how to use the class's
functionalities.
diff --git a/examples/widgets/doc/src/editabletreemodel.qdoc b/examples/widgets/doc/src/editabletreemodel.qdoc
index 20136a02f8c..eaba87863e5 100644
--- a/examples/widgets/doc/src/editabletreemodel.qdoc
+++ b/examples/widgets/doc/src/editabletreemodel.qdoc
@@ -10,6 +10,7 @@
be used with other classes in the model/view framework.
\image itemviews-editabletreemodel.png
+ {Application that show editing of a tree model}
The model supports editable items, custom headers, and the ability to
insert and remove rows and columns. With these features, it is also
@@ -56,6 +57,7 @@
\target Relations-between-internal-items
\table
\row \li \inlineimage itemviews-editabletreemodel-items.png
+ {Diagram of the relationship among root, parent, and child items}
\li \b{Relations between internal items}
When designing a data structure for use with a custom model, it is useful
@@ -100,6 +102,7 @@
\table
\row \li \inlineimage itemviews-editabletreemodel-model.png
+ {Diagram of the tree model with row and column indexes}
\li \b{Accessing data via the model}
In the case shown in the diagram, the piece of information represented
@@ -157,6 +160,7 @@
exposed by each column in a given row in the model.
\li \inlineimage itemviews-editabletreemodel-values.png
+ {Diagram of a possible data structure using QVariant}
\endtable
Since the \c TreeModel implementation has been designed for use with
@@ -180,6 +184,7 @@
\table
\row
\li \inlineimage itemviews-editabletreemodel-indexes.png
+ {Diagram of accessing the tree model using model indexes}
\li \b{Relating items using model indexes}
As with the \l{itemviews/simpletreemodel}{Simple Tree Model} example,
diff --git a/examples/widgets/doc/src/elasticnodes.qdoc b/examples/widgets/doc/src/elasticnodes.qdoc
index c25fd680096..a6224b17c2a 100644
--- a/examples/widgets/doc/src/elasticnodes.qdoc
+++ b/examples/widgets/doc/src/elasticnodes.qdoc
@@ -15,6 +15,7 @@
as you zoom in, the graphics remain crisp.
\image elasticnodes-example.png
+ {Application with a graph of interactive nodes and edges}
Graphics View provides the QGraphicsScene class for managing and
interacting with a large number of custom-made 2D graphical items derived
diff --git a/examples/widgets/doc/src/fetchmore.qdoc b/examples/widgets/doc/src/fetchmore.qdoc
index d8dae18f33e..192c6a08e43 100644
--- a/examples/widgets/doc/src/fetchmore.qdoc
+++ b/examples/widgets/doc/src/fetchmore.qdoc
@@ -10,6 +10,7 @@
model on demand.
\image fetchmore-example.png
+ {Application that fetches and adds more items into the view model}
When you have large - or perhaps even infinite - data sets, you
will need to add items to the model in batches, and preferably only
diff --git a/examples/widgets/doc/src/frozencolumn.qdoc b/examples/widgets/doc/src/frozencolumn.qdoc
index c213ba1779d..05590b0b265 100644
--- a/examples/widgets/doc/src/frozencolumn.qdoc
+++ b/examples/widgets/doc/src/frozencolumn.qdoc
@@ -8,7 +8,8 @@
\ingroup examples-itemviews
\brief This example demonstrates how to freeze a column within a QTableView.
- \image frozencolumn-example.png "Screenshot of the example"
+ \image frozencolumn-example.png
+ {Application showing a frozen column in a table}
We use Qt's model/view framework to implement a table with its first
column frozen. This technique can be applied to several columns or rows,
@@ -22,7 +23,7 @@
the coming sections.
\image frozencolumn-tableview.png
-
+ {The layout of the table view, headers, and scrollbars}
\section1 FreezeTableWidget Class Definition
diff --git a/examples/widgets/doc/src/gradients.qdoc b/examples/widgets/doc/src/gradients.qdoc
index e2ad68db1ae..3003fce0448 100644
--- a/examples/widgets/doc/src/gradients.qdoc
+++ b/examples/widgets/doc/src/gradients.qdoc
@@ -12,6 +12,7 @@
be used in Qt.
\image gradients-demo.png
+ {Application with different settings for applying gradients}
There are three types of gradients:
diff --git a/examples/widgets/doc/src/graphicsview-simpleanchorlayout.qdoc b/examples/widgets/doc/src/graphicsview-simpleanchorlayout.qdoc
index ce5fe8934a2..72954e427f0 100644
--- a/examples/widgets/doc/src/graphicsview-simpleanchorlayout.qdoc
+++ b/examples/widgets/doc/src/graphicsview-simpleanchorlayout.qdoc
@@ -12,6 +12,8 @@
QGraphicsAnchorLayout class.
\image graphicssimpleanchorlayout-example.png
+ {Application using anchor layouts to place widgets}
+
The example starts by creating a QGraphicsScene (\c scene), 3 widgets
(\c a, \c b, and \c c), and a QGraphicsAnchorlayout (\c layout).
diff --git a/examples/widgets/doc/src/imagecomposition.qdoc b/examples/widgets/doc/src/imagecomposition.qdoc
index 9eec57ca889..077238fe2a4 100644
--- a/examples/widgets/doc/src/imagecomposition.qdoc
+++ b/examples/widgets/doc/src/imagecomposition.qdoc
@@ -14,6 +14,7 @@
in detail in \l{QPainter#Composition Modes}{Composition Modes}.
\image imagecomposition-example.png
+ {Application that combines two images using composition modes}
\section1 Setting Up The Resource File
diff --git a/examples/widgets/doc/src/licensewizard.qdoc b/examples/widgets/doc/src/licensewizard.qdoc
index 8965ef56240..955dd5af4fa 100644
--- a/examples/widgets/doc/src/licensewizard.qdoc
+++ b/examples/widgets/doc/src/licensewizard.qdoc
@@ -10,7 +10,7 @@
\brief The License Wizard example shows how to implement complex wizards in
Qt.
- \image licensewizard-example.png Screenshot of the License Wizard example
+ \image licensewizard-example.png {First wizard page of license wizard}
Most wizards have a linear structure, with page 1 followed by
page 2 and so on until the last page. The
@@ -23,7 +23,7 @@
wizard pages; depending on which options are selected, the user
can reach different pages.
- \image licensewizard-flow.png The License Wizard pages
+ \image licensewizard-flow.png {Complex wizard page flow chart}
The example consists of the following classes:
diff --git a/examples/widgets/doc/src/lineedits.qdoc b/examples/widgets/doc/src/lineedits.qdoc
index 7065a5f4256..2f078564a20 100644
--- a/examples/widgets/doc/src/lineedits.qdoc
+++ b/examples/widgets/doc/src/lineedits.qdoc
@@ -11,7 +11,8 @@
on the input and output supplied by the user.
- \borderedimage lineedits-example.png
+ \image lineedits-example.png
+ {Application with various types and uses of line edits}
The example consists of a single \c Window class, containing a selection of
line edits with different input constraints and display properties that can be
diff --git a/examples/widgets/doc/src/menus.qdoc b/examples/widgets/doc/src/menus.qdoc
index b78d3946917..e6de6a78df8 100644
--- a/examples/widgets/doc/src/menus.qdoc
+++ b/examples/widgets/doc/src/menus.qdoc
@@ -18,6 +18,7 @@
special keyboard key or by right-clicking.
\image menus-example.png
+ {Application with the Edit menu open}
A menu consists of a list of \e action items. In applications,
many common commands can be invoked via menus, toolbar buttons as
diff --git a/examples/widgets/doc/src/orderform.qdoc b/examples/widgets/doc/src/orderform.qdoc
index 7ae89dfda8e..97570bcec9d 100644
--- a/examples/widgets/doc/src/orderform.qdoc
+++ b/examples/widgets/doc/src/orderform.qdoc
@@ -17,6 +17,7 @@
to a QTabWidget for easy access.
\image orderform-example.png
+ {Application showing a completed order form for a customer}
\section1 DetailsDialog Definition
@@ -42,6 +43,7 @@
The screenshot below shows the \c DetailsDialog we intend to create.
\image orderform-example-detailsdialog.png
+ {Dialog for entering customer order information}
\section1 DetailsDialog Implementation
diff --git a/examples/widgets/doc/src/painterpaths.qdoc b/examples/widgets/doc/src/painterpaths.qdoc
index 305a7608e59..dcc95c7290e 100644
--- a/examples/widgets/doc/src/painterpaths.qdoc
+++ b/examples/widgets/doc/src/painterpaths.qdoc
@@ -10,6 +10,7 @@
to build complex shapes for rendering.
\image painterpaths-example.png
+ {Application showing various shapes and graphical options}
The QPainterPath class provides a container for painting
operations, enabling graphical shapes to be constructed and
diff --git a/examples/widgets/doc/src/pathstroke.qdoc b/examples/widgets/doc/src/pathstroke.qdoc
index bc4001ebb5e..6c714b8cb5d 100644
--- a/examples/widgets/doc/src/pathstroke.qdoc
+++ b/examples/widgets/doc/src/pathstroke.qdoc
@@ -13,6 +13,7 @@
used in Qt.
\image pathstroke-demo.png
+ {Application showing an adjustable curve and curve style options}
Qt defines cap styles for how the end points are treated and join
styles for how path segments are joined together. A standard set of
diff --git a/examples/widgets/doc/src/regularexpression.qdoc b/examples/widgets/doc/src/regularexpression.qdoc
index f6f1e876893..4a3a57e4e6f 100644
--- a/examples/widgets/doc/src/regularexpression.qdoc
+++ b/examples/widgets/doc/src/regularexpression.qdoc
@@ -18,5 +18,6 @@
and partial/incremental matching.
\image regularexpression-example.png
+ {Application with various fields for testing regular expressions}
*/
diff --git a/examples/widgets/doc/src/screenshot.qdoc b/examples/widgets/doc/src/screenshot.qdoc
index 2e2b3123ef7..84ef1712e26 100644
--- a/examples/widgets/doc/src/screenshot.qdoc
+++ b/examples/widgets/doc/src/screenshot.qdoc
@@ -16,6 +16,7 @@
that an application resizes smoothly and without data loss.
\image screenshot-example.png
+ {Application with options for taking desktop screenshots}
With the application the users can take a screenshot of their
desktop. They are provided with a couple of options:
diff --git a/examples/widgets/doc/src/shapedclock.qdoc b/examples/widgets/doc/src/shapedclock.qdoc
index 4bcd04683c5..46bc5561cb8 100644
--- a/examples/widgets/doc/src/shapedclock.qdoc
+++ b/examples/widgets/doc/src/shapedclock.qdoc
@@ -9,7 +9,8 @@
\brief The example shows how to make a round window with a translucent
background.
- \borderedimage shapedclock-example.png
+ \image shapedclock-example.png
+ {Translucent clock overlaid on text}
Widgets that set their background to be translucent will be transparent for all
unpainted pixels, and the background will shine through pixels painted with an
@@ -68,6 +69,7 @@
on the event, we accept it by calling its \l{QEvent::accept()}{accept()} function.
\image shapedclock-dragging.png
+ {The drag position relative to the clock face}
The \c mouseMoveEvent() handler is called if the mouse is moved over the widget.
diff --git a/examples/widgets/doc/src/shortcuteditor.qdoc b/examples/widgets/doc/src/shortcuteditor.qdoc
index b17835ba168..b9de1178520 100644
--- a/examples/widgets/doc/src/shortcuteditor.qdoc
+++ b/examples/widgets/doc/src/shortcuteditor.qdoc
@@ -12,6 +12,7 @@
Programming} overview.
\image shortcuteditor-example.png
+ {List of actions and their assigned keyboard shortcuts}
Qt's model/view architecture provides a standard way for views to
manipulate information in a data source, using an abstract model
@@ -31,6 +32,7 @@
\table
\row \li \inlineimage treemodel-structure.svg
+ {Structure of the shortcut model in rows}
\li \b{Shortcut Editor Structure}
The data is stored internally in the model using ShortcutEditorModelItem
diff --git a/examples/widgets/doc/src/simplerhiwidget.qdoc b/examples/widgets/doc/src/simplerhiwidget.qdoc
index 81ada91178a..bf2bb871a07 100644
--- a/examples/widgets/doc/src/simplerhiwidget.qdoc
+++ b/examples/widgets/doc/src/simplerhiwidget.qdoc
@@ -9,6 +9,7 @@
\brief Shows how to render a triangle using QRhi, Qt's 3D API and shading language abstraction layer.
\image simplerhiwidget-example.jpg
+ {Colored triangle on a green background}
\caption Screenshot of the Simple RHI Widget example
This example is, in many ways, the counterpart of the \l{RHI Window
diff --git a/examples/widgets/doc/src/simpletreemodel.qdoc b/examples/widgets/doc/src/simpletreemodel.qdoc
index be4889adbe9..ee09a140e0b 100644
--- a/examples/widgets/doc/src/simpletreemodel.qdoc
+++ b/examples/widgets/doc/src/simpletreemodel.qdoc
@@ -16,6 +16,7 @@
\l{Model/View Programming} overview.
\image simpletreemodel-example.png
+ {Documentation structure with chapter titles and brief descriptions}
Qt's model/view architecture provides a standard way for views to
manipulate information in a data source, using an abstract model
@@ -41,6 +42,7 @@
\target SimpleTreeModelStructure
\table
\row \li \inlineimage treemodel-structure.svg
+ {Tree structure with root and tree items}
\li \b{Simple Tree Model Structure}
The data is stored internally in the model using \c TreeItem objects that
diff --git a/examples/widgets/doc/src/sliders.qdoc b/examples/widgets/doc/src/sliders.qdoc
index 9bfb4abdc44..b0fcac4c280 100644
--- a/examples/widgets/doc/src/sliders.qdoc
+++ b/examples/widgets/doc/src/sliders.qdoc
@@ -21,7 +21,8 @@
synchronize the behavior of two or more widgets, and how to override
\l{QWidget::}{resizeEvent()} to implement a responsive layout.
- \borderedimage sliders-example.png
+ \image sliders-example.png
+ {Gallery of different sliders, scroll bars, and dials}
\caption Screenshot of the Sliders example
The Sliders example consists of two classes:
diff --git a/examples/widgets/doc/src/spinboxes.qdoc b/examples/widgets/doc/src/spinboxes.qdoc
index eb42696c48e..8379cd48766 100644
--- a/examples/widgets/doc/src/spinboxes.qdoc
+++ b/examples/widgets/doc/src/spinboxes.qdoc
@@ -10,7 +10,7 @@
spin boxes available in Qt, from a simple QSpinBox widget to more complex
editors like the QDateTimeEdit widget.
- \borderedimage spinboxes-example.png
+ \image spinboxes-example.png {Gallery of different types of spin boxes}
The example consists of a single \c Window class that is used to display the
different spin box-based widgets available with Qt.
diff --git a/examples/widgets/doc/src/spreadsheet.qdoc b/examples/widgets/doc/src/spreadsheet.qdoc
index 02d5e0a957b..39f8d144967 100644
--- a/examples/widgets/doc/src/spreadsheet.qdoc
+++ b/examples/widgets/doc/src/spreadsheet.qdoc
@@ -13,4 +13,5 @@
types of data in distinctive colors.
\image spreadsheet-demo.png
+ {Spreadsheet application with cells, rows, and columns}
*/
diff --git a/examples/widgets/doc/src/standarddialogs.qdoc b/examples/widgets/doc/src/standarddialogs.qdoc
index 396f1d1044a..70b33f79795 100644
--- a/examples/widgets/doc/src/standarddialogs.qdoc
+++ b/examples/widgets/doc/src/standarddialogs.qdoc
@@ -9,5 +9,5 @@
\brief The Standard Dialogs example shows the standard dialogs that are provided by Qt.
- \image standarddialogs-example.png
+ \image standarddialogs-example.png {Dialog requesting for integer input}
*/
diff --git a/examples/widgets/doc/src/syntaxhighlighter.qdoc b/examples/widgets/doc/src/syntaxhighlighter.qdoc
index 17bcc1fa06d..26f11c67e59 100644
--- a/examples/widgets/doc/src/syntaxhighlighter.qdoc
+++ b/examples/widgets/doc/src/syntaxhighlighter.qdoc
@@ -13,6 +13,7 @@
highlighting by subclassing the QSyntaxHighlighter class.
\image syntaxhighlighter-example.png
+ {Text editor with syntax highlighting}
The Syntax Highlighter application displays C++ files with custom
syntax highlighting.
diff --git a/examples/widgets/doc/src/tabdialog.qdoc b/examples/widgets/doc/src/tabdialog.qdoc
index fb45bbae046..54e0e5f91d5 100644
--- a/examples/widgets/doc/src/tabdialog.qdoc
+++ b/examples/widgets/doc/src/tabdialog.qdoc
@@ -16,7 +16,7 @@
dialog, information can be split into different categories, while
remaining accessible.
- \image tabdialog-example.png
+ \image tabdialog-example.png {File information on different tabs}
The Tab Dialog example consists of a single \c TabDialog class that
provides three tabs, each containing information about a particular
diff --git a/examples/widgets/doc/src/tablet.qdoc b/examples/widgets/doc/src/tablet.qdoc
index 9d49d8dec82..a18eb3249e7 100644
--- a/examples/widgets/doc/src/tablet.qdoc
+++ b/examples/widgets/doc/src/tablet.qdoc
@@ -8,7 +8,7 @@
\ingroup examples-widgets
\brief This example shows how to use a Wacom tablet in Qt applications.
- \image tabletexample.png
+ \image tabletexample.png {Application displaying a drawing area}
When you use a tablet with Qt applications, \l{QTabletEvent}s are
generated. You need to reimplement the \l{QWidget::}{tabletEvent()} event
diff --git a/examples/widgets/doc/src/transformations.qdoc b/examples/widgets/doc/src/transformations.qdoc
index f8a29407c83..e9f3b452397 100644
--- a/examples/widgets/doc/src/transformations.qdoc
+++ b/examples/widgets/doc/src/transformations.qdoc
@@ -14,6 +14,7 @@
it shows how the order of transformations affect the result.
\image transformations-example.png
+ {Application displaying different customizable text transformations}
The application allows the user to manipulate the rendering of a
shape by changing the translation, rotation and scale of
diff --git a/examples/widgets/doc/src/treemodelcompleter.qdoc b/examples/widgets/doc/src/treemodelcompleter.qdoc
index ae7c18f442e..a0a1ba4d58f 100644
--- a/examples/widgets/doc/src/treemodelcompleter.qdoc
+++ b/examples/widgets/doc/src/treemodelcompleter.qdoc
@@ -12,6 +12,7 @@
to access Child, GrandChild and GrandGrandChild level objects.
\image treemodelcompleter-example.png
+ {Visualization of a tree model and various options for the completer}
Similar to the \l{Completer Example}, we provide QComboBox objects to
enable selection for completion mode and case sensitivity, as well as
diff --git a/examples/widgets/doc/src/trivialwizard.qdoc b/examples/widgets/doc/src/trivialwizard.qdoc
index 75d007f3881..ea9145dcda7 100644
--- a/examples/widgets/doc/src/trivialwizard.qdoc
+++ b/examples/widgets/doc/src/trivialwizard.qdoc
@@ -12,10 +12,11 @@
of QWizard.
\image trivialwizard-example-flow.png
+ {Flow from introduction, to registration, and to the conclusion page}
\section1 Introduction Page
- \image trivialwizard-example-introduction.png
+ \image trivialwizard-example-introduction.png {Introduction wizard page}
The introduction page is created with the \c createIntroPage()
function where a QWizardPage is created and its title is set to
@@ -27,7 +28,7 @@
\section1 Registration Page
- \image trivialwizard-example-registration.png
+ \image trivialwizard-example-registration.png {Registration wizard page}
The registration page is created with the \c createRegistrationPage()
function. QLineEdit objects are used to allow the user to input a name
@@ -38,7 +39,7 @@
\section1 Conclusion Page
- \image trivialwizard-example-conclusion.png
+ \image trivialwizard-example-conclusion.png {Conclusion wizard page}
The conclusion page is created in the \c createConclusionPage()
function. This function's content is similar to \c createIntroPage(). A
diff --git a/examples/widgets/doc/src/windowflags.qdoc b/examples/widgets/doc/src/windowflags.qdoc
index 10b04967282..31f936fa977 100644
--- a/examples/widgets/doc/src/windowflags.qdoc
+++ b/examples/widgets/doc/src/windowflags.qdoc
@@ -18,7 +18,7 @@
A widget's flags are stored in a Qt::WindowFlags type which stores
an OR combination of the flags.
- \borderedimage windowflags-example.png
+ \image windowflags-example.png {Controller window and preview window}
\caption Screenshot of the Window Flags example
The example consists of two classes:
@@ -57,7 +57,8 @@
an associated \c PreviewWindow to show the effect of the currently
chosen window flags.
- \image windowflags_controllerwindow.png Screenshot of the Controller Window
+ \image windowflags_controllerwindow.png
+ {Controller window with the different flag types and hints}
\section1 ControllerWindow Class Implementation
@@ -163,7 +164,7 @@
the text editor, and the QWidget::setWindowFlags() function to
display the names of the window flags.
- \image windowflags_previewwindow.png Screenshot of the Preview Window
+ \image windowflags_previewwindow.png {Preview window showing window flags}
\section1 PreviewWindow Class Implementation