56 lines
2.8 KiB
Markdown
56 lines
2.8 KiB
Markdown
|
---
|
||
|
|
source_files:
|
||
|
|
- DataPRO/Modules/SystemSettings/RealtimeSettings/Resources/TranslateExtension.cs
|
||
|
|
- DataPRO/Modules/SystemSettings/RealtimeSettings/Resources/StringResources.Designer.cs
|
||
|
|
generated_at: "2026-04-17T15:57:56.905149+00:00"
|
||
|
|
model: "zai-org/GLM-5-FP8"
|
||
|
|
schema_version: 1
|
||
|
|
sha256: "68b065923840220c"
|
||
|
|
---
|
||
|
|
|
||
|
|
# Documentation: RealtimeSettings.Resources
|
||
|
|
|
||
|
|
## 1. Purpose
|
||
|
|
|
||
|
|
This module provides localization infrastructure for the RealtimeSettings feature within the DataPRO SystemSettings module. It consists of a XAML markup extension (`TranslateExtension`) for declarative string lookup in UI markup, and a strongly-typed resource class (`StringResources`) that wraps a `.resx` resource file containing user-facing strings for realtime data acquisition settings such as sample rates, polling delays, and meter mode configuration.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. Public Interface
|
||
|
|
|
||
|
|
### `TranslateExtension` (class)
|
||
|
|
**Namespace:** `RealtimeSettings.Resources`
|
||
|
|
**Inheritance:** `System.Windows.Markup.MarkupExtension`
|
||
|
|
|
||
|
|
A XAML markup extension that enables inline resource string lookup using the syntax `{Resources:Translate KeyName}`.
|
||
|
|
|
||
|
|
| Member | Signature | Description |
|
||
|
|
|--------|-----------|-------------|
|
||
|
|
| Constructor | `TranslateExtension(string key)` | Creates an instance with the specified resource key. The key is stored in a readonly field `_key`. |
|
||
|
|
| `ProvideValue` | `override object ProvideValue(IServiceProvider serviceProvider)` | Returns the localized string for `_key` from `StringResources.ResourceManager`. Returns `#stringnotfound#` if `_key` is null or empty. Returns `#stringnotfound# {key}` if the key is not found in resources. |
|
||
|
|
|
||
|
|
**Attribute:** `[MarkupExtensionReturnType(typeof(string))]`
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
### `StringResources` (class)
|
||
|
|
**Namespace:** `RealtimeSettings.Resources`
|
||
|
|
**Accessibility:** `internal`
|
||
|
|
|
||
|
|
An auto-generated strongly-typed resource class providing access to localized strings.
|
||
|
|
|
||
|
|
| Member | Signature | Description |
|
||
|
|
|--------|-----------|-------------|
|
||
|
|
| `ResourceManager` | `static ResourceManager ResourceManager { get; }` | Lazily-initialized cached `ResourceManager` instance for the `RealtimeSettings.Resources.StringResources` resource bundle. |
|
||
|
|
| `Culture` | `static CultureInfo Culture { get; set; }` | Overrides `CurrentUICulture` for resource lookups. Marked with `EditorBrowsableState.Advanced`. |
|
||
|
|
|
||
|
|
**Resource String Properties (all `internal static string`):**
|
||
|
|
|
||
|
|
| Property | Description (from source comments) |
|
||
|
|
|----------|-------------------------------------|
|
||
|
|
| `DelayBetweenPolls` | "Delay between polls" |
|
||
|
|
| `DelayBetweenPollsHelp` | Period between retrieving data from DAS (ms). Warns about data dropout vs. resource stress. |
|
||
|
|
| `HighDelay` | "High draw delay" |
|
||
|
|
| `HighDelayHelp` | Maximum time (ms) between UI updates when data is available. |
|
||
|
|
| `LowDelay` | "Low draw delay" |
|
||
|
|
| `LowDelayHelp`
|