summaryrefslogtreecommitdiffstats
path: root/src/corelib/doc/snippets
diff options
context:
space:
mode:
authorVolker Hilsheimer <volker.hilsheimer@qt.io>2025-06-20 13:30:09 +0200
committerVolker Hilsheimer <volker.hilsheimer@qt.io>2025-06-20 20:05:10 +0200
commitfb7b848fe6103d89ae5590e594d0f28e73a75913 (patch)
tree35d781f7f0a8a345a11f3fead7388d8014fb92fc /src/corelib/doc/snippets
parentcca658d4821b6d7378df13c29d1dab53c44359ac (diff)
QRangeModel: fix indentation of snippets
qdoc will use the indent level of the //! tag to "normalize" the indentation of the code, so use that instead of using no indentation, which is hard-to-follow. Pick-to: 6.10 Change-Id: I2b273854f3b3549574d549bb2b67ee43023bbb00 Reviewed-by: Artem Dyomin <artem.dyomin@qt.io>
Diffstat (limited to 'src/corelib/doc/snippets')
-rw-r--r--src/corelib/doc/snippets/qrangemodel/main.cpp270
1 files changed, 134 insertions, 136 deletions
diff --git a/src/corelib/doc/snippets/qrangemodel/main.cpp b/src/corelib/doc/snippets/qrangemodel/main.cpp
index faaf895696e..962693fca8f 100644
--- a/src/corelib/doc/snippets/qrangemodel/main.cpp
+++ b/src/corelib/doc/snippets/qrangemodel/main.cpp
@@ -17,104 +17,104 @@ void array()
{
QListView listView;
-//! [array]
-std::array<int, 5> numbers = {1, 2, 3, 4, 5};
-QRangeModel model(numbers);
-listView.setModel(&model);
-//! [array]
+ //! [array]
+ std::array<int, 5> numbers = {1, 2, 3, 4, 5};
+ QRangeModel model(numbers);
+ listView.setModel(&model);
+ //! [array]
}
void construct_by()
{
std::vector<int> numbers = {1, 2, 3, 4, 5};
-{
-//! [value]
- QRangeModel model(numbers);
-//! [value]
-}
+ {
+ //! [value]
+ QRangeModel model(numbers);
+ //! [value]
+ }
-{
-//! [pointer]
- QRangeModel model(&numbers);
-//! [pointer]
-}
+ {
+ //! [pointer]
+ QRangeModel model(&numbers);
+ //! [pointer]
+ }
-{
-//! [reference_wrapper]
- QRangeModel model(std::ref(numbers));
-//! [reference_wrapper]
-}
+ {
+ //! [reference_wrapper]
+ QRangeModel model(std::ref(numbers));
+ //! [reference_wrapper]
+ }
-{
-//! [smart_pointer]
- auto shared_numbers = std::make_shared<std::vector<int>>(numbers);
- QRangeModel model(shared_numbers);
-//! [smart_pointer]
-}
+ {
+ //! [smart_pointer]
+ auto shared_numbers = std::make_shared<std::vector<int>>(numbers);
+ QRangeModel model(shared_numbers);
+ //! [smart_pointer]
+ }
}
void const_array()
{
-//! [const_array]
-const std::array<int, 5> numbers = {1, 2, 3, 4, 5};
-//! [const_array]
-QRangeModel model(numbers);
+ //! [const_array]
+ const std::array<int, 5> numbers = {1, 2, 3, 4, 5};
+ //! [const_array]
+ QRangeModel model(numbers);
}
void const_values()
{
-//! [const_values]
-std::array<const int, 5> numbers = {1, 2, 3, 4, 5};
-//! [const_values]
-QRangeModel model(numbers);
+ //! [const_values]
+ std::array<const int, 5> numbers = {1, 2, 3, 4, 5};
+ //! [const_values]
+ QRangeModel model(numbers);
}
void const_ref()
{
std::vector<int> numbers = {1, 2, 3, 4, 5};
-//! [const_ref]
+ //! [const_ref]
QRangeModel model(std::cref(numbers));
-//! [const_ref]
+ //! [const_ref]
}
void list_of_int()
{
-//! [list_of_int]
-QList<int> numbers = {1, 2, 3, 4, 5};
-QRangeModel model(numbers); // columnCount() == 1
-QListView listView;
-listView.setModel(&model);
-//! [list_of_int]
+ //! [list_of_int]
+ QList<int> numbers = {1, 2, 3, 4, 5};
+ QRangeModel model(numbers); // columnCount() == 1
+ QListView listView;
+ listView.setModel(&model);
+ //! [list_of_int]
}
void grid_of_numbers()
{
-//! [grid_of_numbers]
-std::vector<std::vector<int>> gridOfNumbers = {
- {1, 2, 3, 4, 5},
- {6, 7, 8, 9, 10},
- {11, 12, 13, 14, 15},
-};
-QRangeModel model(&gridOfNumbers); // columnCount() == 5
-QTableView tableView;
-tableView.setModel(&model);
-//! [grid_of_numbers]
+ //! [grid_of_numbers]
+ std::vector<std::vector<int>> gridOfNumbers = {
+ {1, 2, 3, 4, 5},
+ {6, 7, 8, 9, 10},
+ {11, 12, 13, 14, 15},
+ };
+ QRangeModel model(&gridOfNumbers); // columnCount() == 5
+ QTableView tableView;
+ tableView.setModel(&model);
+ //! [grid_of_numbers]
}
void pair_int_QString()
{
-//! [pair_int_QString]
-using TableRow = std::tuple<int, QString>;
-QList<TableRow> numberNames = {
- {1, "one"},
- {2, "two"},
- {3, "three"}
-};
-QRangeModel model(&numberNames); // columnCount() == 2
-QTableView tableView;
-tableView.setModel(&model);
-//! [pair_int_QString]
+ //! [pair_int_QString]
+ using TableRow = std::tuple<int, QString>;
+ QList<TableRow> numberNames = {
+ {1, "one"},
+ {2, "two"},
+ {3, "three"}
+ };
+ QRangeModel model(&numberNames); // columnCount() == 2
+ QTableView tableView;
+ tableView.setModel(&model);
+ //! [pair_int_QString]
}
#if defined(__cpp_concepts) && defined(__cpp_lib_forward_like)
@@ -235,35 +235,33 @@ public:
void tree_protocol()
{
-//! [tree_protocol_5]
-Tree tree = {
- {"..."},
- {"..."},
- {"..."},
-};
-
-// each toplevel row has three children
-tree[0].addChild("...");
-tree[0].addChild("...");
-tree[0].addChild("...");
-
-tree[1].addChild("...");
-tree[1].addChild("...");
-tree[1].addChild("...");
-
-tree[2].addChild("...");
-tree[2].addChild("...");
-tree[2].addChild("...");
-//! [tree_protocol_5]
-
-{
-//! [tree_protocol_6]
-// instantiate the model with a pointer to the tree, not a copy!
-QRangeModel model(&tree);
-QTreeView view;
-view.setModel(&model);
-//! [tree_protocol_6]
-}
+ //! [tree_protocol_5]
+ Tree tree = {
+ {"..."},
+ {"..."},
+ {"..."},
+ };
+
+ // each toplevel row has three children
+ tree[0].addChild("...");
+ tree[0].addChild("...");
+ tree[0].addChild("...");
+
+ tree[1].addChild("...");
+ tree[1].addChild("...");
+ tree[1].addChild("...");
+
+ tree[2].addChild("...");
+ tree[2].addChild("...");
+ tree[2].addChild("...");
+ //! [tree_protocol_5]
+
+ //! [tree_protocol_6]
+ // instantiate the model with a pointer to the tree, not a copy!
+ QRangeModel model(&tree);
+ QTreeView view;
+ view.setModel(&model);
+ //! [tree_protocol_6]
}
//! [explicit_tree_protocol_0]
@@ -278,10 +276,10 @@ struct TreeTraversal
//! [explicit_tree_protocol_0]
void explicit_tree_protocol()
{
-Tree tree;
-//! [explicit_tree_protocol_1]
-QRangeModel model(&tree, TreeTraversal{});
-//! [explicit_tree_protocol_1]
+ Tree tree;
+ //! [explicit_tree_protocol_1]
+ QRangeModel model(&tree, TreeTraversal{});
+ //! [explicit_tree_protocol_1]
}
} // namespace tree_protocol
@@ -331,19 +329,19 @@ private:
Tree make_tree_of_pointers()
{
-//! [tree_of_pointers_2]
-Tree tree = {
- new TreeRow("1"),
- new TreeRow("2"),
- new TreeRow("3"),
- new TreeRow("4"),
-};
-tree[0]->addChild("1.1");
-tree[1]->addChild("2.1");
-tree[2]->addChild("3.1")->addChild("3.1.1");
-tree[3]->addChild("4.1");
-//! [tree_of_pointers_2]
-return tree;
+ //! [tree_of_pointers_2]
+ Tree tree = {
+ new TreeRow("1"),
+ new TreeRow("2"),
+ new TreeRow("3"),
+ new TreeRow("4"),
+ };
+ tree[0]->addChild("1.1");
+ tree[1]->addChild("2.1");
+ tree[2]->addChild("3.1")->addChild("3.1.1");
+ tree[3]->addChild("4.1");
+ //! [tree_of_pointers_2]
+ return tree;
}
//! [tree_of_pointers_3]
@@ -379,22 +377,22 @@ int main(int argc, char **argv)
void color_map()
{
-//! [color_map]
-using ColorEntry = QMap<Qt::ItemDataRole, QVariant>;
-
-const QStringList colorNames = QColor::colorNames();
-QList<ColorEntry> colors;
-colors.reserve(colorNames.size());
-for (const QString &name : colorNames) {
- const QColor color = QColor::fromString(name);
- colors << ColorEntry{{Qt::DisplayRole, name},
- {Qt::DecorationRole, color},
- {Qt::ToolTipRole, color.name()}};
-}
-QRangeModel colorModel(colors);
-QListView list;
-list.setModel(&colorModel);
-//! [color_map]
+ //! [color_map]
+ using ColorEntry = QMap<Qt::ItemDataRole, QVariant>;
+
+ const QStringList colorNames = QColor::colorNames();
+ QList<ColorEntry> colors;
+ colors.reserve(colorNames.size());
+ for (const QString &name : colorNames) {
+ const QColor color = QColor::fromString(name);
+ colors << ColorEntry{{Qt::DisplayRole, name},
+ {Qt::DecorationRole, color},
+ {Qt::ToolTipRole, color.name()}};
+ }
+ QRangeModel colorModel(colors);
+ QListView list;
+ list.setModel(&colorModel);
+ //! [color_map]
}
namespace multirole_gadget {
@@ -425,17 +423,17 @@ private:
//! [color_gadget_0]
void color_list() {
-//! [color_gadget_1]
-const QStringList colorNames = QColor::colorNames();
-QList<QRangeModel::SingleColumn<ColorEntry>> colors;
-colors.reserve(colorNames.size());
-for (const QString &name : colorNames)
- colors << ColorEntry{name};
-
-QRangeModel colorModel(colors);
-QListView list;
-list.setModel(&colorModel);
-//! [color_gadget_1]
+ //! [color_gadget_1]
+ const QStringList colorNames = QColor::colorNames();
+ QList<QRangeModel::SingleColumn<ColorEntry>> colors;
+ colors.reserve(colorNames.size());
+ for (const QString &name : colorNames)
+ colors << ColorEntry{name};
+
+ QRangeModel colorModel(colors);
+ QListView list;
+ list.setModel(&colorModel);
+ //! [color_gadget_1]
}
} // namespace multirole_gadget
generated by cgit v1.2.3 (git 2.25.1) at 2025-12-18 18:41:04 +0000