Update

.github/workflows/linux.yml

@@ -4,8 +4,13 @@ on:
   workflow_dispatch:
   push:
     branches: [main, develop]
+    paths-ignore:
+      - '*.md'
+
   pull_request:
     branches: [main, develop]
+    paths-ignore:
+      - '*.md'
 
 jobs:
   get-matrix:

.github/workflows/macos.yml

@@ -4,8 +4,13 @@ on:
   workflow_dispatch:
   push:
     branches: [main, develop]
+    paths-ignore:
+      - '*.md'
+
   pull_request:
     branches: [main, develop]
+    paths-ignore:
+      - '*.md'
 
 jobs:
   get-matrix:

.github/workflows/windows.yml

@@ -4,8 +4,13 @@ on:
   workflow_dispatch:
   push:
     branches: [main, develop]
+    paths-ignore:
+      - '*.md'
+
   pull_request:
     branches: [main, develop]
+    paths-ignore:
+      - '*.md'
 
 jobs:
   get-matrix:

CMakeLists.txt

@@ -10,5 +10,10 @@ set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_EXTENSIONS OFF)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 
+option(PM_BUILD_PROPERTY_GRID_EXAMPLES "Determines whether or not the example projects should be built with the library" ON)
+
 add_subdirectory(src)
-add_subdirectory(examples)
+
+if(PM_BUILD_PROPERTY_GRID_EXAMPLES)
+    add_subdirectory(examples)
+endif()

README.md

@@ -16,49 +16,10 @@ This library provides a flexible and customizable property editor that displays
 > **Current Status:**
 > - ✅ **API is stable** - Safe to use in your projects without worrying about breaking changes
 > - ⚠️ **Implementation is not fully polished** - Some features may have rough edges
-> - 🚧 **Work in progress** - Actively being improved in my free time to become production-ready
+> - 🚧 **Work in progress** - Actively being improved to become production-ready
 > 
 > Feel free to use it, report issues, and contribute! The core functionality works well, and the API won't change in ways that break your code.
 
-## Features
-
-- **Comprehensive Type Support**: Built-in support for all major Qt types including:
-  - Basic types: `int`, `bool`, `QString`, `double`
-  - Geometric types: `QPoint`, `QPointF`, `QSize`, `QSizeF`, `QRect`, `QRectF`, `QLine`, `QLineF`
-  - Graphics types: `QColor`, `QFont`, `QIcon`, `QPixmap`, `QBitmap`, `QImage`
-  - Advanced types: `QVector2D`, `QVector3D`, `QVector4D`, `QMatrix4x4`, `QPolygon`, `QPolygonF`
-  - Date/Time types: `QDate`, `QTime`, `QDateTime`
-  - UI types: `QKeySequence`, `QCursor`, `QChar`
-  - Object types: `QObject*` and custom enums
-
-- **Property Attributes**: Rich attribute system for enhanced property configuration:
-  - `DescriptionAttribute`: Add helpful descriptions to properties
-  - `DefaultValueAttribute`: Define default values for properties
-  - `CategoryAttribute`: Organize properties into collapsible categories
-  - `ReadOnlyAttribute`: Mark properties as read-only
-
-- **Flexible API**: Multiple ways to add properties:
-  - Simple property addition with automatic type detection
-  - Detailed property configuration with attributes
-  - Batch property addition with categories
-
-- **Interactive Features**:
-  - Collapsible categories for better organization
-  - Real-time property value change notifications
-  - Support for custom property editors
-  - Responsive tree-based layout
-
-- **Cross-Platform**: Compatible with Qt 5.9+ on Windows, macOS, and Linux
-
-- **Wide Qt Compatibility**: Designed to work with all Qt versions from Qt 5.9 onward, ensuring maximum compatibility across projects
-
-## Requirements
-
-- **CMake**: 3.10 or higher
-- **Qt**: 5.9+ (Widgets module required)
-- **C++ Standard**: C++17 (can work on C++14 if you have a replacement implementation for `std::variant`)
-- **Compiler**: MSVC 2019, GCC, or Clang with C++17 support
-
 ## Quick Start
 
 ```cpp
@@ -71,14 +32,6 @@ int main(int argc, char *argv[])
     QApplication app(argc, argv);
 
     PM::PropertyGrid propertyGrid;
-    //
-    // ONLY FOR NOW...
-    //
-    // Add editors for the property types that you're using
-    // This won't be required in the future
-    // 
-    propertyGrid.addPropertyEditor<PM::BoolPropertyEditor>();
-    propertyGrid.addPropertyEditor<PM::ColorPropertyEditor>();
 
     // Add simple properties
     propertyGrid.addProperty("Name", QString("My Object"));
@@ -107,6 +60,45 @@ int main(int argc, char *argv[])
 }
 ```
 
+## Features
+
+- **Comprehensive Type Support**: Planned Built-in support for all major Qt types including:
+  - [x] **Basic types**: `int`, `bool`, `QString`, `double`
+  - [ ] **Geometric types**: `QPoint`, `QPointF`, `QSize`, `QSizeF`, `QRect`, `QRectF`, `QLine`, `QLineF`
+  - [x] **Graphics types**: `QColor`, `QFont`, `QIcon`, `QPixmap`, `QBitmap`, `QImage`
+  - [ ] **Advanced types**: `QVector2D`, `QVector3D`, `QVector4D`, `QMatrix4x4`, `QPolygon`, `QPolygonF`
+  - [x] **Date/Time types**: `QDate`, `QTime`, `QDateTime`
+  - [ ] **UI types** (partial): `QKeySequence`, `QCursor`, `QChar`
+  - [ ] **Object types**: `QObject*` and custom enums
+
+- **Property Attributes**: Rich attribute system for enhanced property configuration:
+  - `DescriptionAttribute`: Add helpful descriptions to properties
+  - `DefaultValueAttribute`: Define default values for properties
+  - `CategoryAttribute`: Organize properties into collapsible categories
+  - `ReadOnlyAttribute`: Mark properties as read-only
+
+- **Flexible API**: Multiple ways to add properties:
+  - Simple property addition with automatic type detection
+  - Detailed property configuration with attributes
+  - Batch property addition with categories
+
+- **Interactive Features**:
+  - Collapsible categories for better organization
+  - Real-time property value change notifications
+  - Support for custom property editors
+  - Responsive tree-based layout
+
+- **Cross-Platform**: Compatible with Qt 5.9+ on Windows, macOS, and Linux
+
+- **Wide Qt Compatibility**: Designed to work with all Qt versions from Qt 5.9 onward, ensuring maximum compatibility across projects
+
+## Requirements
+
+- **CMake**: 3.10 or higher
+- **Qt**: 5.9+ (Widgets module required)
+- **C++ Standard**: C++17 (can work on C++14 if you have a replacement implementation for `std::variant`)
+- **Compiler**: MSVC 2019, GCC, or Clang with C++17 support
+
 ## API Overview
 
 ### Core Classes
@@ -148,7 +140,8 @@ cmake --build .
 You can easily integrate PmPropertyGrid into your CMake project using `add_subdirectory`:
 
 ```cmake
-# Add PmPropertyGrid as a subdirectory
+# Add PmPropertyGrid as a subdirectory and disable examples
+set(PM_BUILD_PROPERTY_GRID_EXAMPLES OFF)
 add_subdirectory(path/to/PmPropertyGrid)
 
 # Link against your target
@@ -168,6 +161,7 @@ find_package(QT NAMES Qt6 Qt5 COMPONENTS Widgets REQUIRED)
 find_package(Qt${QT_VERSION_MAJOR} COMPONENTS Widgets REQUIRED)
 
 # Add PmPropertyGrid
+set(PM_BUILD_PROPERTY_GRID_EXAMPLES OFF)
 add_subdirectory(third_party/PmPropertyGrid)
 
 # Create your executable
@@ -196,6 +190,7 @@ PmPropertyGrid/
 ├── src/                        # Core library source code
 │   ├── PropertyGrid.h/cpp      # Main property grid widget
 │   ├── Property.h/cpp          # Property definition and attributes
+│   ├── PropertyContext.h/cpp   # Property definition, value and associated meta info
 │   └── PropertyEditor.h/cpp    # Property editor framework
 ├── examples/                   # Example applications
 │   └── property_grid_showcase/ # Comprehensive demo

examples/CMakeLists.txt

@@ -1,3 +1,2 @@
-include_directories(${CMAKE_SOURCE_DIR}/src)
-
 add_subdirectory(property_grid_showcase)
+add_subdirectory(object_property_grid)

examples/object_property_grid/CMakeLists.txt

@@ -0,0 +1,20 @@
+set(CMAKE_AUTOUIC ON)
+set(CMAKE_AUTOMOC ON)
+set(CMAKE_AUTORCC ON)
+
+find_package(QT NAMES Qt6 Qt5 COMPONENTS Core Widgets REQUIRED)
+find_package(Qt${QT_VERSION_MAJOR} COMPONENTS Core Widgets REQUIRED)
+find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS Core)
+
+add_executable(object_property_grid
+    main.cpp
+    ObjectPropertyGrid.h ObjectPropertyGrid.cpp
+
+    MainWindow.h MainWindow.cpp MainWindow.ui
+)
+
+target_link_libraries(object_property_grid
+    PRIVATE
+        PM::PropertyGrid
+)
+target_link_libraries(object_property_grid PRIVATE Qt${QT_VERSION_MAJOR}::Core)

examples/object_property_grid/MainWindow.cpp

@@ -0,0 +1,75 @@
+#include "MainWindow.h"
+#include "ui_MainWindow.h"
+
+#include <QTreeWidgetItem>
+#include <QVBoxLayout>
+
+static void addWidgetToTree(QTreeWidgetItem *parentItem, QWidget *widget)
+{
+    if (!widget)
+        return;
+
+    auto *item = new QTreeWidgetItem(parentItem, {widget->objectName()});
+    item->setData(0, Qt::UserRole, QVariant::fromValue(static_cast<QObject *>(widget)));
+
+    const QList<QWidget *> children = widget->findChildren<QWidget *>(QString(), Qt::FindDirectChildrenOnly);
+    for (QWidget *child : children)
+        addWidgetToTree(item, child);
+}
+
+MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow), propertyGrid(this)
+{
+    ui->setupUi(this);
+
+    // Place propertyGrid inside the Properties dock
+    propertyGrid.layout()->setContentsMargins(0, 0, 0, 0);
+    ui->dockWidget_2->setWidget(&propertyGrid);
+
+    // Populate tree with central widget hierarchy
+    ui->treeWidget->setHeaderLabel("Objects");
+    ui->treeWidget->setSelectionMode(QAbstractItemView::ExtendedSelection);
+
+    // Instead of adding the central widget itself, add its direct children
+    const QList<QWidget *> children = ui->centralwidget->findChildren<QWidget *>(QString(), Qt::FindDirectChildrenOnly);
+    for (QWidget *child : children)
+        addWidgetToTree(ui->treeWidget->invisibleRootItem(), child);
+
+    // Expand everything by default
+    ui->treeWidget->expandAll();
+
+    // Default selection: first item
+    if (ui->treeWidget->topLevelItemCount() > 0)
+    {
+        ui->treeWidget->setCurrentItem(ui->treeWidget->topLevelItem(0));
+        QObject *obj = ui->treeWidget->topLevelItem(0)->data(0, Qt::UserRole).value<QObject *>();
+
+        if (obj)
+            propertyGrid.setSelectedObject(obj);
+    }
+
+    // Sync selection with property grid
+    connect(ui->treeWidget, &QTreeWidget::itemSelectionChanged, this, &MainWindow::objectsTreeSelectionChanged);
+}
+
+MainWindow::~MainWindow()
+{
+    delete ui;
+}
+
+void MainWindow::objectsTreeSelectionChanged()
+{
+    QList<QObject *> selectedObjects;
+    for (QTreeWidgetItem *item : ui->treeWidget->selectedItems())
+    {
+        QObject *obj = item->data(0, Qt::UserRole).value<QObject *>();
+        if (obj)
+            selectedObjects.append(obj);
+    }
+
+    if (selectedObjects.isEmpty())
+        propertyGrid.setSelectedObjects({});
+    else if (selectedObjects.size() == 1)
+        propertyGrid.setSelectedObject(selectedObjects.first());
+    else
+        propertyGrid.setSelectedObjects(selectedObjects);
+}

examples/object_property_grid/MainWindow.h

@@ -0,0 +1,30 @@
+#ifndef MAINWINDOW_H
+#define MAINWINDOW_H
+
+#include "ObjectPropertyGrid.h"
+
+#include <QMainWindow>
+
+namespace Ui
+{
+class MainWindow;
+}
+
+class MainWindow : public QMainWindow
+{
+    Q_OBJECT
+
+public:
+    explicit MainWindow(QWidget *parent = nullptr);
+    ~MainWindow();
+
+private slots:
+    void objectsTreeSelectionChanged();
+
+private:
+    Ui::MainWindow *ui;
+
+    ObjectPropertyGrid propertyGrid;
+};
+
+#endif // MAINWINDOW_H