Add C API and example for MessageDialog

Introduces a C API for MessageDialog with creation, property access, modality, open/close, and resource management functions. Adds a comprehensive C example demonstrating usage and updates build files to include the new example and API header.

Author: lijy91

CMakeLists.txt

@@ -15,6 +15,7 @@ add_subdirectory(examples/keyboard_example)
 add_subdirectory(examples/menu_example)
 add_subdirectory(examples/menu_c_example)
 add_subdirectory(examples/message_dialog_example)
+add_subdirectory(examples/message_dialog_c_example)
 add_subdirectory(examples/storage_example)
 add_subdirectory(examples/storage_c_example)
 add_subdirectory(examples/tray_icon_example)

examples/message_dialog_c_example/CMakeLists.txt

@@ -0,0 +1,29 @@
+cmake_minimum_required(VERSION 3.10)
+
+project(message_dialog_c_example VERSION 0.0.1 LANGUAGES CXX)
+
+# Set C++ standard
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# Add example program
+add_executable(message_dialog_c_example
+  "main.c"
+)
+
+# Link main library
+target_link_libraries(message_dialog_c_example PRIVATE nativeapi)
+
+# Set example program properties
+set_target_properties(message_dialog_c_example PROPERTIES
+  OUTPUT_NAME "message_dialog_c_example"
+)
+
+# Set example program compile options (macOS only)
+if(APPLE)
+    set_source_files_properties("main.c"
+    PROPERTIES
+    COMPILE_FLAGS "-x objective-c++"
+  )
+endif()
+

examples/message_dialog_c_example/main.c

@@ -0,0 +1,158 @@
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include "../../src/capi/application_c.h"
+#include "../../src/capi/message_dialog_c.h"
+#include "../../src/capi/string_utils_c.h"
+
+int main() {
+  printf("=== MessageDialog C API Example ===\n\n");
+
+  // Initialize application
+  native_application_t app = native_application_get_instance();
+  if (!app) {
+    fprintf(stderr, "Failed to get application instance\n");
+    return 1;
+  }
+
+  printf("Application instance obtained successfully\n\n");
+
+  // Example 1: Create a simple informational dialog
+  printf("1. Creating a simple informational dialog...\n");
+  native_message_dialog_t info_dialog = native_message_dialog_create(
+      "Information",
+      "This is an informational message dialog.\n\n"
+      "MessageDialog can be used to display various types of messages to users.");
+
+  if (!info_dialog) {
+    fprintf(stderr, "Failed to create informational dialog\n");
+    return 1;
+  }
+
+  // Get and print dialog properties
+  char* title = native_message_dialog_get_title(info_dialog);
+  char* message = native_message_dialog_get_message(info_dialog);
+  if (title) {
+    printf("Dialog title: %s\n", title);
+    free_c_str(title);
+  }
+  if (message) {
+    printf("Dialog message: %s\n", message);
+    free_c_str(message);
+  }
+
+  // Set modality to Application modal
+  native_message_dialog_set_modality(info_dialog, NATIVE_DIALOG_MODALITY_APPLICATION);
+  native_dialog_modality_t modality = native_message_dialog_get_modality(info_dialog);
+  printf("Modality: %s\n",
+         modality == NATIVE_DIALOG_MODALITY_APPLICATION ? "Application" : "Unknown");
+
+  printf("Opening dialog...\n");
+  if (native_message_dialog_open(info_dialog)) {
+    printf("Dialog was opened successfully\n\n");
+  } else {
+    printf("Failed to open dialog\n\n");
+  }
+
+  // Clean up first dialog
+  native_message_dialog_destroy(info_dialog);
+
+  // Example 2: Create a warning dialog
+  printf("2. Creating a warning dialog...\n");
+  native_message_dialog_t warning_dialog = native_message_dialog_create(
+      "Warning",
+      "This is a warning message.\n\n"
+      "Warning dialogs are used to alert users about potential issues.");
+
+  if (warning_dialog) {
+    native_message_dialog_set_modality(warning_dialog, NATIVE_DIALOG_MODALITY_APPLICATION);
+    native_message_dialog_open(warning_dialog);
+    native_message_dialog_destroy(warning_dialog);
+  }
+  printf("\n");
+
+  // Example 3: Create a dialog with updated content
+  printf("3. Creating a dialog with updated content...\n");
+  native_message_dialog_t dynamic_dialog =
+      native_message_dialog_create("Update Available", "Initial message");
+
+  if (dynamic_dialog) {
+    // Update the title and message before opening
+    native_message_dialog_set_title(dynamic_dialog, "System Update");
+    native_message_dialog_set_message(dynamic_dialog,
+                                      "A new version of the application is available.\n\n"
+                                      "Version 2.0 includes:\n"
+                                      "• Improved performance\n"
+                                      "• New features\n"
+                                      "• Bug fixes\n\n"
+                                      "Would you like to update now?");
+
+    title = native_message_dialog_get_title(dynamic_dialog);
+    if (title) {
+      printf("Updated title: %s\n", title);
+      free_c_str(title);
+    }
+
+    native_message_dialog_set_modality(dynamic_dialog, NATIVE_DIALOG_MODALITY_APPLICATION);
+    printf("Opening updated dialog...\n");
+    native_message_dialog_open(dynamic_dialog);
+    native_message_dialog_destroy(dynamic_dialog);
+  }
+  printf("\n");
+
+  // Example 4: Demonstrate different modality types
+  printf("4. Demonstrating different modality types...\n");
+
+  // Non-modal dialog
+  native_message_dialog_t non_modal_dialog = native_message_dialog_create(
+      "Non-Modal Dialog",
+      "This dialog does not block interaction.\n\n"
+      "The application continues running and users can interact with other windows.");
+  if (non_modal_dialog) {
+    native_message_dialog_set_modality(non_modal_dialog, NATIVE_DIALOG_MODALITY_NONE);
+    modality = native_message_dialog_get_modality(non_modal_dialog);
+    printf("Modality: %s (non-modal)\n",
+           modality == NATIVE_DIALOG_MODALITY_NONE ? "None" : "Unknown");
+    native_message_dialog_open(non_modal_dialog);
+    native_message_dialog_destroy(non_modal_dialog);
+  }
+
+  // Application modal dialog
+  native_message_dialog_t app_modal_dialog = native_message_dialog_create(
+      "Application Modal",
+      "This dialog blocks interaction with all windows in the current application.");
+  if (app_modal_dialog) {
+    native_message_dialog_set_modality(app_modal_dialog, NATIVE_DIALOG_MODALITY_APPLICATION);
+    modality = native_message_dialog_get_modality(app_modal_dialog);
+    printf("Modality: %s\n",
+           modality == NATIVE_DIALOG_MODALITY_APPLICATION ? "Application" : "Unknown");
+    native_message_dialog_open(app_modal_dialog);
+    native_message_dialog_destroy(app_modal_dialog);
+  }
+
+  // Window modal dialog (behaves as Application on macOS)
+  native_message_dialog_t window_modal_dialog = native_message_dialog_create(
+      "Window Modal",
+      "This dialog blocks interaction with a specific parent window.\n\n"
+      "Note: On macOS, this behaves as Application.");
+  if (window_modal_dialog) {
+    native_message_dialog_set_modality(window_modal_dialog, NATIVE_DIALOG_MODALITY_WINDOW);
+    modality = native_message_dialog_get_modality(window_modal_dialog);
+    printf("Modality: %s\n", modality == NATIVE_DIALOG_MODALITY_WINDOW ? "Window" : "Unknown");
+    native_message_dialog_open(window_modal_dialog);
+    native_message_dialog_destroy(window_modal_dialog);
+  }
+
+  printf("\n=== MessageDialog C API Example Complete ===\n");
+  printf("This example demonstrated:\n");
+  printf("1. Creating MessageDialog instances\n");
+  printf("2. Setting and getting title and message\n");
+  printf("3. Updating dialog content programmatically\n");
+  printf("4. Opening dialogs with different modality types (None, Application, Window)\n");
+  printf("5. Modal vs non-modal dialog behavior\n");
+  printf("6. Proper cleanup of dialog resources\n");
+
+  printf("\nExiting MessageDialog C API Example...\n");
+  return 0;
+}

examples/message_dialog_example/main.cpp

@@ -12,44 +12,42 @@ int main() {
 
   try {
     std::cout << "\n1. Creating a simple informational dialog..." << std::endl;
-    
+
     // Create a simple informational message dialog
     auto info_dialog = std::make_shared<MessageDialog>(
         "Information",
         "This is an informational message dialog.\n\n"
         "MessageDialog can be used to display various types of messages to users.");
-    
+
     info_dialog->SetModality(DialogModality::Application);
-    
+
     std::cout << "Dialog title: " << info_dialog->GetTitle() << std::endl;
     std::cout << "Dialog message: " << info_dialog->GetMessage() << std::endl;
     std::cout << "Opening dialog..." << std::endl;
-    
+
     // Open the dialog (this will block until user dismisses it)
     if (info_dialog->Open()) {
       std::cout << "Dialog was opened successfully" << std::endl;
     } else {
       std::cout << "Failed to open dialog" << std::endl;
     }
-    
+
     std::cout << "\n2. Creating a warning dialog..." << std::endl;
-    
+
     // Create a warning dialog
     auto warning_dialog = std::make_shared<MessageDialog>(
         "Warning",
         "This is a warning message.\n\n"
         "Warning dialogs are used to alert users about potential issues.");
-    
+
     warning_dialog->SetModality(DialogModality::Application);
     warning_dialog->Open();
-    
+
     std::cout << "\n3. Creating a dialog with updated content..." << std::endl;
-    
+
     // Create a dialog and update its content
-    auto dynamic_dialog = std::make_shared<MessageDialog>(
-        "Update Available",
-        "Initial message");
-    
+    auto dynamic_dialog = std::make_shared<MessageDialog>("Update Available", "Initial message");
+
     // Update the title and message before opening
     dynamic_dialog->SetTitle("System Update");
     dynamic_dialog->SetMessage(
@@ -59,15 +57,15 @@ int main() {
         "• New features\n"
         "• Bug fixes\n\n"
         "Would you like to update now?");
-    
+
     dynamic_dialog->SetModality(DialogModality::Application);
-    
+
     std::cout << "Updated title: " << dynamic_dialog->GetTitle() << std::endl;
     std::cout << "Opening updated dialog..." << std::endl;
     dynamic_dialog->Open();
-    
+
     std::cout << "\n4. Demonstrating different modality types..." << std::endl;
-    
+
     // Non-modal dialog (default)
     auto non_modal_dialog = std::make_shared<MessageDialog>(
         "Non-Modal Dialog",
@@ -76,15 +74,15 @@ int main() {
     non_modal_dialog->SetModality(DialogModality::None);
     std::cout << "Modality: None (non-modal)" << std::endl;
     non_modal_dialog->Open();
-    
+
     // Application modal dialog
     auto app_modal_dialog = std::make_shared<MessageDialog>(
         "Application Modal",
         "This dialog blocks interaction with all windows in the current application.");
     app_modal_dialog->SetModality(DialogModality::Application);
     std::cout << "Modality: Application" << std::endl;
     app_modal_dialog->Open();
-    
+
     // Window modal dialog (behaves as Application on macOS)
     auto window_modal_dialog = std::make_shared<MessageDialog>(
         "Window Modal",
@@ -93,15 +91,16 @@ int main() {
     window_modal_dialog->SetModality(DialogModality::Window);
     std::cout << "Modality: Window" << std::endl;
     window_modal_dialog->Open();
-    
+
     std::cout << "\n=== MessageDialog Example Complete ===" << std::endl;
     std::cout << "This example demonstrated:" << std::endl;
     std::cout << "1. Creating MessageDialog instances" << std::endl;
     std::cout << "2. Setting title and message" << std::endl;
     std::cout << "3. Updating dialog content programmatically" << std::endl;
-    std::cout << "4. Opening dialogs with different modality types (None, Application, Window)" << std::endl;
+    std::cout << "4. Opening dialogs with different modality types (None, Application, Window)"
+              << std::endl;
     std::cout << "5. Modal vs non-modal dialog behavior" << std::endl;
-    
+
     std::cout << "\nExiting MessageDialog Example..." << std::endl;
     return 0;
 
@@ -110,4 +109,3 @@ int main() {
     return 1;
   }
 }
-

include/nativeapi.h

@@ -5,10 +5,10 @@
 #include "../src/accessibility_manager.h"
 #include "../src/application.h"
 #include "../src/application_event.h"
+#include "../src/dialog.h"
 #include "../src/display.h"
 #include "../src/display_event.h"
 #include "../src/display_manager.h"
-#include "../src/dialog.h"
 #include "../src/foundation/event.h"
 #include "../src/foundation/event_emitter.h"
 #include "../src/foundation/geometry.h"
@@ -38,6 +38,7 @@
 #include "../src/capi/image_c.h"
 #include "../src/capi/keyboard_monitor_c.h"
 #include "../src/capi/menu_c.h"
+#include "../src/capi/message_dialog_c.h"
 #include "../src/capi/preferences_c.h"
 #include "../src/capi/run_example_app_c.h"
 #include "../src/capi/secure_storage_c.h"