DP44/enriched-partialglm/DTS Viewer/DTS.Viewer/Modules/Main/View.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DTS Viewer/DTS.Viewer/Modules/Main/View/MainView.xaml.cs DTS Viewer/DTS.Viewer/Modules/Main/View/ViewerShellView.xaml.cs DTS Viewer/DTS.Viewer/Modules/Main/View/MainViewLite.xaml.cs DTS Viewer/DTS.Viewer/Modules/Main/View/ExportMainView.xaml.cs DTS Viewer/DTS.Viewer/Modules/Main/View/ViewerMainView.xaml.cs DTS Viewer/DTS.Viewer/Modules/Main/View/ExportMainViewGrid.xaml.cs DTS Viewer/DTS.Viewer/Modules/Main/View/ViewerMainViewGrid.xaml.cs	2026-04-16T11:26:12.276849+00:00	zai-org/GLM-5-FP8	1	a7a3a3c725d7b68b

DTS Viewer Main Views Documentation

1. Purpose

This module contains the WPF view code-behind files for the main window and viewer components of the DTS Viewer application. It provides multiple view variants (standard, lite, export, and viewer modes) that implement a view-first MVVM architecture using Prism. The views handle UI initialization, event subscription for graph loading notifications, and PDF/image export functionality. These views serve as the visual containers for the application's primary user interface elements.

---

2. Public Interface

MainView

public partial class MainView : IMainView

• Constructor: MainView() - Initializes the WPF component via InitializeComponent().
• Implements IMainView interface from DTS.Common.Interface.

ViewerShellView

public partial class ViewerShellView : IViewerShellView

• Constructor: ViewerShellView() - Initializes the WPF component via InitializeComponent().
• Implements IViewerShellView interface from DTS.Common.Interface.

MainViewLite

public partial class MainViewLite : IMainViewerView

• Constructor: MainViewLite() - Initializes the WPF component via InitializeComponent().
• Implements IMainViewerView interface from DTS.Common.Interface.

ExportMainView

public partial class ExportMainView : IExportMainView

• Constructor: ExportMainView() - Initializes the WPF component via InitializeComponent().
• Implements IExportMainView interface from DTS.Common.Interface.

ViewerMainView

public partial class ViewerMainView : IViewerMainView

• Constructor: ViewerMainView() - Initializes the WPF component via InitializeComponent().
• Implements IViewerMainView interface from DTS.Common.Interface.
• Contains commented-out code for AvalonDock layout serialization/deserialization (referencing DockManager, XmlLayoutSerializer, and DataProViewerAvalonDock.config).

ExportMainViewGrid

public partial class ExportMainViewGrid : IExportMainViewGrid

• Constructor: ExportMainViewGrid() - Initializes component and subscribes to Loaded event.
• Implements IExportMainViewGrid interface from DTS.Common.Interface.
• Public Method: int SaveToPDF(string directory, string pdfFileName) - Renders the view to PDF and PNG files. Returns > 0 on success, < 0 on failure, or 0 if MainShell is not yet rendered.
• Private Property: IEventAggregator _eventAggregator - Resolved from container on load.
• Private Method: void SetFocus() - Empty implementation (no operation).
• Private Method: void ExportMainViewGrid_Loaded(object sender, RoutedEventArgs e) - Resolves IEventAggregator and subscribes to GraphLoadedCountNotification.
• Private Method: void OnGraphLoadedCountNotification(GraphLoadedCountNotificationArg arg) - Delays 3 seconds then invokes SetFocus via dispatcher.

ViewerMainViewGrid

public partial class ViewerMainViewGrid : IViewerMainViewGrid

• Constructor: ViewerMainViewGrid() - Initializes component and subscribes to Loaded event.
• Implements IViewerMainViewGrid interface from DTS.Common.Interface.
• Public Method: int SaveToPDF(string directory, string pdfFileName) - Renders the view to PDF and PNG files. Returns > 0 on success, < 0 on failure, or 0 if MainShell is not yet rendered.
• Private Property: IEventAggregator _eventAggregator - Resolved from container on load.
• Private Method: void SetFocus() - Selects and focuses chartOptTab element.
• Private Method: void ViewerMainViewGrid_Loaded(object sender, RoutedEventArgs e) - Resolves IEventAggregator and subscribes to GraphLoadedCountNotification.
• Private Method: void OnGraphLoadedCountNotification(GraphLoadedCountNotificationArg arg) - Validates DataContext matches arg.ParentVM, delays 3 seconds, then invokes SetFocus via dispatcher.

---

3. Invariants

• All views must call InitializeComponent() in their constructor (WPF code-behind requirement).
• SaveToPDF requires pdfFileName to end with .pdf extension; otherwise returns -1.
• SaveToPDF requires both directory and pdfFileName to be non-null and non-empty; otherwise returns -1.
• SaveToPDF returns 0 if MainShell.DesiredSize.Height or MainShell.DesiredSize.Width is 0 (control not yet rendered).
• OnGraphLoadedCountNotification only processes the event if DataContext is non-null and matches arg.ParentVM (cast to IBaseViewModel).
• Event subscription to GraphLoadedCountNotification occurs only after the Loaded event fires (ensures IEventAggregator is available).
• PDF export renders at 300 DPI resolution.
• PNG export is generated alongside PDF with .pdf extension replaced by .png.

---

4. Dependencies

External Dependencies

• Prism.Events - IEventAggregator for pub/sub event messaging.
• Prism.Ioc - ContainerLocator for service location.
• C1.WPF.Pdf - C1PdfDocument for PDF generation (ComponentOne library).
• System.Windows - WPF core types (RoutedEventArgs, Visual, Dispatcher, etc.).
• System.Windows.Media - RenderTargetBitmap, WriteableBitmap, PixelFormats, VisualTreeHelper.
• System.Windows.Media.Imaging - Bitmap rendering types.

Internal Dependencies

• DTS.Common.Interface - Interface definitions (IMainView, IViewerShellView, IMainViewerView, IExportMainView, IViewerMainView, IExportMainViewGrid, IViewerMainViewGrid).
• DTS.Common.Base - IBaseViewModel base interface.
• DTS.Common.Events - GraphLoadedCountNotification event and GraphLoadedCountNotificationArg argument class.
• DTS.Common.Utilities.Logging - APILogger.LogException(Exception) for error logging.
• DTS.Common.Utils.PNGImageUtil - SaveImage(FrameworkElement, string) static method for PNG export.

Consumers

• Unknown from source alone. These views are likely instantiated by a Prism bootstrapper or module initialization logic.

---

5. Gotchas

1. Hardcoded 3-second delay: Both ExportMainViewGrid and ViewerMainViewGrid use Thread.Sleep(TimeSpan.FromSeconds(3)) before setting focus. This is a magic number with no configuration, potentially causing timing issues on slower systems.

2. Empty SetFocus in ExportMainViewGrid: The SetFocus() method in ExportMainViewGrid is empty, making the 3-second delayed focus operation a no-op. This may be intentional or dead code.

3. Commented-out AvalonDock code: ViewerMainView contains significant commented-out code for layout serialization using XmlLayoutSerializer and a DockManager element. This suggests either incomplete feature implementation or removed functionality that wasn't cleaned up.

4. Multiple ReSharper disable directives: ExportMainView, ViewerMainView, ExportMainViewGrid, and ViewerMainViewGrid all suppress multiple ReSharper inspections, which may mask potential code quality issues.

5. Namespace inconsistency: All files declare namespace DTS.Viewer despite residing in different subdirectories (e.g., Modules/Main/View/). This is intentional but may cause confusion when locating files.

6. Event subscription without unsubscription: Neither ExportMainViewGrid nor ViewerMainViewGrid unsubscribe from GraphLoadedCountNotification. This could cause memory leaks if views are created/destroyed frequently.

7. PDF return value semantics: The SaveToPDF method uses a tri-state return value (>0, 0, <0) which is documented but unconventional. Callers must check for > 0 rather than a simple boolean.

8. Silent exception handling: SaveToPDF catches all exceptions, logs them via APILogger.LogException, and returns -1. The caller receives no exception details.