DP44/docs/ai/DTS Viewer/DTS.Viewer.Reports/DTS.Viewer.PSDReport/Resources.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DTS Viewer/DTS.Viewer.Reports/DTS.Viewer.PSDReport/Resources/TranslateExtension.cs DTS Viewer/DTS.Viewer.Reports/DTS.Viewer.PSDReport/Resources/StringResources.Designer.cs	2026-04-17T16:12:01.659566+00:00	zai-org/GLM-5-FP8	1	e841c5ffb3f98572

Resources

Purpose

This module provides localization support for the PSD (Power Spectral Density) Report component within the DTS Viewer application. It exists to enable XAML-based string lookup for UI elements, allowing the report configuration interface to be localized. The module contains a WPF markup extension for direct XAML binding and a strongly-typed resource class with strings specific to PSD report settings, data selection, and modifications.

Public Interface

TranslateExtension class (public, inherits MarkupExtension)

• TranslateExtension(string key) - Constructor accepting the resource key to look up.
• override object ProvideValue(IServiceProvider serviceProvider) - Returns the localized string for the given _key. Returns #stringnotfound# if the key is null or empty, or #stringnotfound# <key> if the resource lookup fails.

StringResources class (internal sealed)

• static ResourceManager ResourceManager { get; } - Returns the cached ResourceManager instance for the DTS.Viewer.PSDReport.Resources.StringResources resource bundle.
• static CultureInfo Culture { get; set; } - Gets or sets the current thread's CurrentUICulture for resource lookups.
• static string DataHeader { get; } - Localized string "Data".
• static string DataSelectionHeader { get; } - Localized string "Data selection".
• static string GraphsDefaultTitle { get; } - Localized string "Graphs".
• static string ModificationsHeader { get; } - Localized string "Modify".
• static string PSDHeader { get; } - Localized string "PSD".
• static string PSDResultsHeader { get; } - Localized string "Results".
• static string PSDSettingsHeader { get; } - Localized string "PSD Settings".
• static string SettingsTitle { get; } - Localized string "Settings".
• static string TestsDefaultTitle { get; } - Localized string "Tests".

Invariants

• The TranslateExtension class is decorated with [MarkupExtensionReturnType(typeof(string))], guaranteeing it returns a string when used in XAML.
• The ProvideValue method never returns null; it returns a fallback string beginning with #stringnotfound# on lookup failure.
• The StringResources.ResourceManager property lazily initializes exactly once.
• All resource string properties in StringResources are internal and return non-null values if the .resx file is properly configured.

Dependencies

• Depends on: System (for IServiceProvider, String), System.Windows.Markup (for MarkupExtension, MarkupExtensionReturnTypeAttribute), System.Resources (for ResourceManager), System.Globalization (for CultureInfo).
• Depended on by: XAML files within DTS.Viewer.PSDReport that use {local:Translate KeyName} syntax, and any code in that assembly requiring localized strings.

Gotchas

• The TranslateExtension class is defined in namespace DTS.Viewer.PSDReport but references DTS.Viewer.PSDReport.Resources.StringResources. This namespace structure must be accounted for in XAML namespace declarations.
• The NotFound constant value #stringnotfound# is hardcoded and will appear in the UI if a resource key is missing, which may be visible to end users during development.
• The StringResources.Designer.cs file is auto-generated; manual changes will be overwritten. Edit the corresponding .resx file instead.
• The PSDResultsHeader resource exists in both DTS.Viewer.PSDReport.Resources and DTS.Viewer.PSDReportResults.Resources with the same default value "Results". This duplication may indicate shared terminology but could lead to inconsistency if localized differently.