54 lines
3.5 KiB
Markdown
54 lines
3.5 KiB
Markdown
|
---
|
|||
|
|
source_files:
|
|||
|
|
- DataPRO/Modules/Menu/HamburgerMenu/Resources/TranslateExtension.cs
|
|||
|
|
- DataPRO/Modules/Menu/HamburgerMenu/Resources/StringResources.Designer.cs
|
|||
|
|
generated_at: "2026-04-16T04:48:26.109962+00:00"
|
|||
|
|
model: "Qwen/Qwen3-Coder-Next-FP8"
|
|||
|
|
schema_version: 1
|
|||
|
|
sha256: "846fd5844632234a"
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Resources
|
|||
|
|
|
|||
|
|
## Documentation: `TranslateExtension` Class
|
|||
|
|
|
|||
|
|
### 1. Purpose
|
|||
|
|
The `TranslateExtension` class is a WPF `MarkupExtension` that enables declarative localization of UI strings in XAML. It resolves a given resource key at runtime by querying the `StringResources` strongly-typed resource class and returns the corresponding localized string. If the key is missing or the lookup fails, it returns a placeholder string to make missing translations visually obvious during development. This module exists to support multi-language UIs in the HamburgerMenu module without requiring code-behind for simple string bindings.
|
|||
|
|
|
|||
|
|
### 2. Public Interface
|
|||
|
|
- **`TranslateExtension(string key)`**
|
|||
|
|
Constructor. Accepts a non-null resource key string used to look up a localized value.
|
|||
|
|
- *Parameter*: `key` (`string`) – The resource key (e.g., `"Table_NA"`). Must match a key in the `StringResources.resx` file.
|
|||
|
|
|
|||
|
|
- **`override object ProvideValue(IServiceProvider serviceProvider)`**
|
|||
|
|
Implements `MarkupExtension.ProvideValue`. Performs the resource lookup and returns the localized string or a placeholder.
|
|||
|
|
- *Behavior*:
|
|||
|
|
- If `_key` is `null` or empty → returns `"#stringnotfound#"`.
|
|||
|
|
- Else → attempts `StringResources.ResourceManager.GetString(_key)`.
|
|||
|
|
- If found → returns the string.
|
|||
|
|
- If not found (`null`) → returns `"#stringnotfound# " + _key` (e.g., `"#stringnotfound# MyKey"`).
|
|||
|
|
|
|||
|
|
### 3. Invariants
|
|||
|
|
- `_key` is immutable after construction (stored in a `readonly` field).
|
|||
|
|
- The returned value is always a `string` (per `[MarkupExtensionReturnType(typeof(string))]`).
|
|||
|
|
- Missing keys are *never* silently ignored; they always produce a visible placeholder string.
|
|||
|
|
- Resource lookup uses the current UI culture (`CultureInfo`) set on `StringResources.Culture`.
|
|||
|
|
|
|||
|
|
### 4. Dependencies
|
|||
|
|
- **Depends on**:
|
|||
|
|
- `System.Windows.Markup.MarkupExtension` (WPF framework)
|
|||
|
|
- `HamburgerMenu.Resources.StringResources` (strongly-typed resource class)
|
|||
|
|
- `System.Resources.ResourceManager` (via `StringResources.ResourceManager`)
|
|||
|
|
- **Used by**:
|
|||
|
|
- XAML files in the `HamburgerMenu` module (e.g., `<TextBlock Text="{local:Translate Table_NA}" />`).
|
|||
|
|
- No other C# code appears to depend on this class directly (it is XAML-only).
|
|||
|
|
|
|||
|
|
### 5. Gotchas
|
|||
|
|
- **Hardcoded placeholder**: The `"#stringnotfound#"` prefix is hardcoded; changing it requires modifying this class.
|
|||
|
|
- **No fallback chain**: If a key is missing, no secondary key or default value is attempted—only the placeholder is returned.
|
|||
|
|
- **No compile-time key validation**: Typos in XAML (e.g., `{local:Translate Tabl_NA}`) will only surface at runtime as `"#stringnotfound# Tabl_NA"`.
|
|||
|
|
- **Culture dependency**: Localization behavior relies on `StringResources.Culture` being set appropriately (e.g., via `Thread.CurrentThread.CurrentUICulture`). If unset, the default culture is used.
|
|||
|
|
- **Auto-generated resource class**: `StringResources.Designer.cs` is auto-generated; edits will be overwritten. Resource keys must be managed via `.resx` files.
|
|||
|
|
- **No async/safe fallback**: `GetString()` is synchronous and may throw if the underlying resource stream is corrupted (though this is rare).
|
|||
|
|
|
|||
|
|
None identified beyond the above.
|