Files
DP44/docs/ai/Common/DTS.Common/obj/x86/Debug/Dialogs.md
2026-04-17 14:55:32 -04:00

5.5 KiB
Raw Blame History

source_files, generated_at, model, schema_version, sha256
source_files generated_at model schema_version sha256
Common/DTS.Common/obj/x86/Debug/Dialogs/NotificationWindow.g.i.cs
Common/DTS.Common/obj/x86/Debug/Dialogs/NotificationWindow.g.cs
Common/DTS.Common/obj/x86/Debug/Dialogs/ConfirmationWindow.g.cs
Common/DTS.Common/obj/x86/Debug/Dialogs/ConfirmationWindow.g.i.cs
2026-04-17T15:37:50.866970+00:00 zai-org/GLM-5-FP8 1 36f77dfe5ce8c20c

Documentation: DTS.Common.Dialogs

1. Purpose

This module provides WPF dialog window components for user interaction within the DTS.Common library. It contains auto-generated partial classes for NotificationWindow and ConfirmationWindow, which serve as standard UI dialogs for displaying notifications and confirmation prompts respectively. These classes are generated by the WPF build process from XAML definitions and implement IComponentConnector to support XAML element naming and event binding.


2. Public Interface

NotificationWindow

Class: DTS.Common.Dialogs.NotificationWindow
Inheritance: System.Windows.Window, System.Windows.Markup.IComponentConnector

Member Signature Description
InitializeComponent() public void InitializeComponent() Loads the XAML component from /DTS.Common;component/dialogs/notificationwindow.xaml. Idempotent—returns early if already called.
Connect(int, object) void IComponentConnector.Connect(int connectionId, object target) Internal method that wires named XAML elements to their code-behind fields and attaches event handlers. Not intended for direct use.

Internal Fields (XAML-named elements):

  • notificationWindow — Self-reference to the window instance (line 7 of XAML)
  • LayoutRootSystem.Windows.Controls.Grid container (line 45 of XAML)
  • OKButtonSystem.Windows.Controls.Button for dismissal (line 63 of XAML)

Event Handler (referenced):

  • CoppyToClibord_ClickSystem.Windows.RoutedEventHandler attached to an unnamed button's Click event (line 62 of XAML). Note: Implementation resides in the non-generated code-behind file (not provided).

ConfirmationWindow

Class: DTS.Common.Dialogs.ConfirmationWindow
Inheritance: System.Windows.Window, System.Windows.Markup.IComponentConnector

Member Signature Description
InitializeComponent() public void InitializeComponent() Loads the XAML component from /DTS.Common;component/dialogs/confirmationwindow.xaml. Idempotent—returns early if already called.
Connect(int, object) void IComponentConnector.Connect(int connectionId, object target) Internal method that wires named XAML elements to their code-behind fields. Not intended for direct use.

Internal Fields (XAML-named elements):

  • confirmationWindow — Self-reference to the window instance (line 6 of XAML)
  • LayoutRootSystem.Windows.Controls.Grid container (line 27 of XAML)
  • OKButtonSystem.Windows.Controls.Button for confirmation (line 45 of XAML)
  • CancelButtonSystem.Windows.Controls.Button for cancellation (line 53 of XAML)

3. Invariants

  • Single Initialization: InitializeComponent() must only be called once per instance. Subsequent calls return immediately without reloading the XAML.
  • Partial Class Requirement: Both NotificationWindow and ConfirmationWindow are partial classes. The actual business logic, event handler implementations, and additional members must be defined in companion code-behind files (e.g., NotificationWindow.xaml.cs).
  • XAML Resource Availability: The XAML resources at /DTS.Common;component/dialogs/notificationwindow.xaml and /DTS.Common;component/dialogs/confirmationwindow.xaml must be embedded in the assembly for Application.LoadComponent to succeed.
  • Connection IDs: The Connect method uses hardcoded connectionId values (14). These must remain synchronized with the XAML compilation output.

4. Dependencies

This module depends on:

  • System.Windows (WPF core)
  • System.Windows.Controls
  • System.Windows.Markup (IComponentConnector)
  • Microsoft.Xaml.Behaviors (behavior libraries referenced in imports)
  • Microsoft.Windows.Controls (extended controls)
  • PresentationBuildTasks (code generation, runtime version 4.0.30319.42000)

Consumers:

  • Unknown from source alone. These dialogs are likely consumed by other modules within the DTS system that require user notification or confirmation.

5. Gotchas

  1. Typo in Event Handler Name: The event handler CoppyToClibord_Click contains spelling errors ("Coppy" instead of "Copy", "Clibord" instead of "Clipboard"). This typo exists in the XAML and propagates to the generated code. The actual implementation method in the code-behind must match this exact spelling.

  2. Auto-Generated Files: The provided source files (.g.cs and .g.i.cs) are auto-generated and should not be manually edited. Any changes will be overwritten on recompilation. Modifications must be made in the corresponding .xaml and .xaml.cs files.

  3. Missing Code-Behind: The actual implementations of CoppyToClibord_Click and any additional logic are not present in these generated files. The behavior of these dialogs cannot be fully understood without the companion .xaml.cs files.

  4. Duplicate Files: Both .g.cs and .g.i.cs variants are provided for each window. These are functionally identical in content; the .g.i.cs variant is used for IntelliSense during design-time, while .g.cs is used at compile-time.