60 lines
2.8 KiB
Markdown
60 lines
2.8 KiB
Markdown
|
---
|
||
|
|
source_files:
|
||
|
|
- Common/DTS.Common/Classes/ISO/ExtraProperties/TextPastedArgs.cs
|
||
|
|
generated_at: "2026-04-17T16:40:00.349676+00:00"
|
||
|
|
model: "zai-org/GLM-5-FP8"
|
||
|
|
schema_version: 1
|
||
|
|
sha256: "d715f67ccc715086"
|
||
|
|
---
|
||
|
|
|
||
|
|
# Documentation: TextPastedArgs
|
||
|
|
|
||
|
|
## 1. Purpose
|
||
|
|
|
||
|
|
`TextPastedArgs` is an event argument class that encapsulates data related to text paste operations within the ISO Extra Properties system. It implements `ITextPastedEventArgs` and serves as a data transfer object to communicate paste event details—including the pasted text content, the source extra property, an identifier, and an optional tag—between event producers and consumers.
|
||
|
|
|
||
|
|
## 2. Public Interface
|
||
|
|
|
||
|
|
### Class: `TextPastedArgs`
|
||
|
|
**Namespace:** `DTS.Common.ISO.ExtraProperties`
|
||
|
|
**Implements:** `ITextPastedEventArgs`
|
||
|
|
|
||
|
|
#### Properties
|
||
|
|
|
||
|
|
| Property | Type | Access | Description |
|
||
|
|
|----------|------|--------|-------------|
|
||
|
|
| `Text` | `string` | Read-only | The text content that was pasted. |
|
||
|
|
| `Sender` | `object` | Read-only | The source object of the paste event. Set from the `extraProperty` constructor parameter. |
|
||
|
|
| `Id` | `string` | Read-only | An identifier associated with the paste event. |
|
||
|
|
| `Tag` | `object` | Read-only | An arbitrary object for additional context or data. |
|
||
|
|
|
||
|
|
#### Constructor
|
||
|
|
|
||
|
|
```csharp
|
||
|
|
public TextPastedArgs(string text, IExtraProperty extraProperty, string id, object tag)
|
||
|
|
```
|
||
|
|
|
||
|
|
Creates a new `TextPastedArgs` instance with the specified values. The `extraProperty` parameter is assigned to the `Sender` property.
|
||
|
|
|
||
|
|
## 3. Invariants
|
||
|
|
|
||
|
|
- All properties are immutable after construction (read-only getters with no setters).
|
||
|
|
- `Sender` is always assigned from an `IExtraProperty` instance passed to the constructor, though the property type is `object`.
|
||
|
|
- No null validation is performed in the constructor; any parameter may be `null`.
|
||
|
|
|
||
|
|
## 4. Dependencies
|
||
|
|
|
||
|
|
### This module depends on:
|
||
|
|
- `DTS.Common.Events` — Likely contains event infrastructure or the `ITextPastedEventArgs` interface definition.
|
||
|
|
- `DTS.Common.Interface.ISO.ExtraProperties` — Provides `ITextPastedEventArgs` and `IExtraProperty` interfaces.
|
||
|
|
|
||
|
|
### What depends on this module:
|
||
|
|
- Cannot be determined from this source file alone.
|
||
|
|
|
||
|
|
## 5. Gotchas
|
||
|
|
|
||
|
|
1. **Naming mismatch:** The constructor parameter is named `extraProperty` but is assigned to the `Sender` property. This naming inconsistency may cause confusion about the intended semantics of the property.
|
||
|
|
|
||
|
|
2. **Unused imports:** The file imports `System.Collections.Generic`, `System.Linq`, and `System.Text`, none of which are used in the current implementation. This may indicate dead code or remnants from previous refactoring.
|
||
|
|
|
||
|
|
3. **No null guards:** The constructor performs no validation. Callers should be aware that `Text`, `Id`, `Sender`, and `Tag` may all be `null` depending on what is passed in.
|