138 lines
8.6 KiB
Markdown
138 lines
8.6 KiB
Markdown
---
|
|
source_files:
|
|
- Common/DTS.CommonCore/Converters/BooleanToBorderThicknessConverter.cs
|
|
- Common/DTS.CommonCore/Converters/BooleanToBorderBrushConverter.cs
|
|
- Common/DTS.CommonCore/Converters/BooleanOrMultiConverter.cs
|
|
- Common/DTS.CommonCore/Converters/BooleanToGreenBorderConverter.cs
|
|
- Common/DTS.CommonCore/Converters/DateTimeWithMillisecondsToStringConverter.cs
|
|
- Common/DTS.CommonCore/Converters/EnumVisibilityConverter.cs
|
|
- Common/DTS.CommonCore/Converters/InverseEnumVisibilityConverter.cs
|
|
- Common/DTS.CommonCore/Converters/ActiveContentConverter.cs
|
|
- Common/DTS.CommonCore/Converters/FaultedTextConverter.cs
|
|
- Common/DTS.CommonCore/Converters/TriggerTextConverter.cs
|
|
- Common/DTS.CommonCore/Converters/NullableFloatConverter.cs
|
|
- Common/DTS.CommonCore/Converters/TriggerColorConverter.cs
|
|
- Common/DTS.CommonCore/Converters/FaultedColorConverter.cs
|
|
- Common/DTS.CommonCore/Converters/DateConverter.cs
|
|
- Common/DTS.CommonCore/Converters/InverseEnumEnabledConverter.cs
|
|
- Common/DTS.CommonCore/Converters/IsLessThanConverter.cs
|
|
- Common/DTS.CommonCore/Converters/ListToStringConverter.cs
|
|
- Common/DTS.CommonCore/Converters/IsGreaterThanConverter.cs
|
|
- Common/DTS.CommonCore/Converters/NonZeroToColorConverter.cs
|
|
- Common/DTS.CommonCore/Converters/HeightConverter.cs
|
|
- Common/DTS.CommonCore/Converters/ErrorToBooleanConverter.cs
|
|
- Common/DTS.CommonCore/Converters/WidthConverter.cs
|
|
- Common/DTS.CommonCore/Converters/StringListToVisibilityConverter.cs
|
|
- Common/DTS.CommonCore/Converters/StatusToBorderThicknessConverter.cs
|
|
- Common/DTS.CommonCore/Converters/ArrayVisibilityConverter.cs
|
|
- Common/DTS.CommonCore/Converters/ErrorToColorConverter.cs
|
|
- Common/DTS.CommonCore/Converters/GreaterThanToBoolConverter.cs
|
|
- Common/DTS.CommonCore/Converters/BooleanToColorConverter.cs
|
|
- Common/DTS.CommonCore/Converters/BooleanToItalicFontStyleConverter.cs
|
|
- Common/DTS.CommonCore/Converters/IntervalToVisibilityConverter.cs
|
|
- Common/DTS.CommonCore/Converters/DiagStatusShuntColorConverter.cs
|
|
- Common/DTS.CommonCore/Converters/DiagStatusOffsetColorConverter.cs
|
|
- Common/DTS.CommonCore/Converters/InverseBooleanToOpacityConverter.cs
|
|
- Common/DTS.CommonCore/Converters/StatusToColorConverter.cs
|
|
- Common/DTS.CommonCore/Converters/ColorToSolidColorBrushConverter .cs
|
|
- Common/DTS.CommonCore/Converters/BooleanAndToVisibiltyMultiConverter.cs
|
|
- Common/DTS.CommonCore/Converters/BooleanOrToVisibilityMultiConverter.cs
|
|
- Common/DTS.CommonCore/Converters/DoubleFromThousandthUnitToBaseUnit.cs
|
|
- Common/DTS.CommonCore/Converters/BooleanToOpacityConverter.cs
|
|
- Common/DTS.CommonCore/Converters/DASStatusArmTextConverter.cs
|
|
- Common/DTS.CommonCore/Converters/EnumBooleanConverter.cs
|
|
- Common/DTS.CommonCore/Converters/InitialOffsetToIEPESensorOffsetConverter.cs
|
|
- Common/DTS.CommonCore/Converters/DASStatusColorConverter.cs
|
|
- Common/DTS.CommonCore/Converters/DASStatusArmColorConverter .cs
|
|
- Common/DTS.CommonCore/Converters/PercentConverter.cs
|
|
- Common/DTS.CommonCore/Converters/NumericStringFormatConverter.cs
|
|
- Common/DTS.CommonCore/Converters/VisibilityToRowHeightConverter.cs
|
|
- Common/DTS.CommonCore/Converters/GroupImportErrorToStringConverter.cs
|
|
- Common/DTS.CommonCore/Converters/GroupNameToVisibilityConverter.cs
|
|
- Common/DTS.CommonCore/Converters/FilePathsToShortStringConverter.cs
|
|
- Common/DTS.CommonCore/Converters/InverseBooleanConverter.cs
|
|
- Common/DTS.CommonCore/Converters/EnumDescriptionTypeConverter.cs
|
|
- Common/DTS.CommonCore/Converters/TestDataToRegionOfInterestMaximumConverter.cs
|
|
generated_at: "2026-04-16T12:00:34.413877+00:00"
|
|
model: "zai-org/GLM-5-FP8"
|
|
schema_version: 1
|
|
sha256: "8cec2e1657d13038"
|
|
---
|
|
|
|
# Documentation: DTS.Common.Converters
|
|
|
|
## 1. Purpose
|
|
|
|
This module provides a comprehensive library of WPF value converters (implementing `IValueConverter` and `IMultiValueConverter`) for the DTS application. It facilitates the binding of UI elements to backend data models by transforming data types (e.g., Booleans to Visibility or Colors, Enums to Strings, numeric formatting) and applying conditional logic within XAML. It serves as the bridge between raw data properties and presentation logic, supporting the MVVM architectural pattern.
|
|
|
|
## 2. Public Interface
|
|
|
|
This module contains the following classes:
|
|
|
|
### Boolean Converters
|
|
|
|
* **`BooleanToBorderThicknessConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `1` if `value` is `true`, otherwise `2`.
|
|
* `ConvertBack`: Returns `null`.
|
|
* **`BooleanToBorderBrushConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `BrushesAndColors.Brush_Warning` if `value` is `true`, otherwise `Brushes.Transparent`.
|
|
* `ConvertBack`: Returns `null`.
|
|
* **`BooleanToGreenBorderConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `BrushesAndColors.BrushApplicationStatusPowerGreen` if `value` is `true`, otherwise `BrushesAndColors.BrushFlatControlDarkForeground`.
|
|
* `ConvertBack`: Returns `null`.
|
|
* **`BooleanOrMultiConverter`** (`IMultiValueConverter`)
|
|
* `Convert`: Returns `true` if any value in the `values` array is `true`. Returns `false` if any value is not a `bool`.
|
|
* `ConvertBack`: Throws `NotImplementedException`.
|
|
* **`BooleanToColorConverter`** (`IValueConverter`)
|
|
* Properties: `Background` (bool), `Inverted` (bool), `AttentionBrush` (bool), `WarningBrush` (bool).
|
|
* `Convert`: Returns specific brushes based on boolean `value` and configured properties. Defaults to error/attention brushes for `false`.
|
|
* `ConvertBack`: Returns `null`.
|
|
* **`BooleanToItalicFontStyleConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `FontStyles.Italic` if `value` is `true`, otherwise `FontStyles.Normal`.
|
|
* `ConvertBack`: Returns `null`.
|
|
* **`BooleanToOpacityConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `0.5` if `value` is `true`, otherwise `1`.
|
|
* `ConvertBack`: Returns `null`.
|
|
* **`InverseBooleanToOpacityConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `1.0` if `value` is `true`, otherwise `0.5`.
|
|
* `ConvertBack`: Returns `null`.
|
|
* **`InverseBooleanConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns the logical negation of the boolean `value`.
|
|
* `ConvertBack`: Returns the logical negation of the boolean `value`.
|
|
* **`BooleanAndToVisibilityMultiConverter`** (`IMultiValueConverter`)
|
|
* `Convert`: Returns `Visibility.Visible` if all values are `true`. Supports parameter flags "FALSE" (inverts logic) and "HIDE" (uses `Hidden` instead of `Collapsed`).
|
|
* `ConvertBack`: Throws `NotImplementedException`.
|
|
* **`BooleanOrToVisibilityMultiConverter`** (`IMultiValueConverter`)
|
|
* `Convert`: Returns `Visibility.Visible` if any value is `true`. Supports parameter flags "FALSE" and "HIDE".
|
|
* `ConvertBack`: Throws `NotImplementedException`.
|
|
|
|
### Enum Converters
|
|
|
|
* **`EnumVisibilityConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `Visibility.Visible` if `value.Equals(parameter)`, otherwise `Visibility.Hidden`.
|
|
* `ConvertBack`: Returns `parameter` if `value` is `Visibility.Visible`, otherwise `Binding.DoNothing`.
|
|
* **`InverseEnumVisibilityConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `Visibility.Hidden` if `value.Equals(parameter)`, otherwise `Visibility.Visible`.
|
|
* `ConvertBack`: Returns `parameter` if `value` is `Visibility.Hidden`, otherwise `Binding.DoNothing`.
|
|
* **`InverseEnumEnabledConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `false` if `value.Equals(parameter)`, otherwise `true`.
|
|
* `ConvertBack`: Returns `parameter` if `value` is `false`, otherwise `Binding.DoNothing`.
|
|
* **`EnumBooleanConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `value.Equals(parameter)`.
|
|
* `ConvertBack`: Returns `parameter` if `value` is `true`, otherwise `Binding.DoNothing`.
|
|
* **`EnumDescriptionTypeConverter`** (`EnumConverter`)
|
|
* `ConvertTo`: Returns the `DescriptionAttribute` value of the enum, looking up the string in `Strings.Strings.ResourceManager`.
|
|
* `GetEnumDescription`: Static helper to retrieve description string for an Enum value.
|
|
|
|
### Numeric & Comparison Converters
|
|
|
|
* **`IsLessThanConverter`** (`IValueConverter`)
|
|
* `Convert`: Parses `value` and `parameter` as decimals. Returns `true` if `left < right`.
|
|
* `ConvertBack`: Returns `DependencyProperty.UnsetValue`.
|
|
* **`IsGreaterThanConverter`** (`IValueConverter`)
|
|
* `Convert`: Parses `value` and `parameter` as decimals. Returns `true` if `left > right`.
|
|
* `ConvertBack`: Returns `DependencyProperty.UnsetValue`.
|
|
* **`GreaterEqualThanToBoolConverter`** (`IValueConverter`)
|
|
* `Convert`: Returns `true` if `value >= parameter`. Handles `int`, `double`, and `ushort`.
|
|
* `ConvertBack`: Returns `false`.
|
|
* **` |