====== API: Editor Controls ======

API Reference for input and edit fields.

===== TWvdSTextEdit =====

Extended single-line text field with buttons.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<TextEdit Text="{Binding SearchText}"
          NullText="Search..."
          ShowClearButton="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Text | string | '' | Current text |
^ NullText | string | '' | Placeholder text |
^ ShowClearButton | Boolean | False | Show clear button |
^ Buttons | TWvdSButtonCollection | nil | Additional buttons |
^ EditMask | string | '' | Input mask |

==== Events ====

| Event | Signature | Description |
^ OnTextChanged | TNotifyEvent | Text changed |
^ OnButtonClick | TButtonClickEvent | Button clicked |

----

===== TWvdSMemoEdit =====

Multi-line text field.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<MemoEdit Text="{Binding Description}"
          Lines="10"
          WordWrap="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Text | string | '' | Complete text |
^ Lines | TStrings | nil | Line-by-line access |
^ MaxLines | Integer | 0 | Max lines (0=unlimited) |
^ WordWrap | Boolean | True | Word wrap |
^ ScrollBars | TWvdSScrollBars | ssBoth | None, Horizontal, Vertical, Both |

==== Events ====

| Event | Signature | Description |
^ OnTextChanged | TNotifyEvent | Text changed |

----

===== TWvdSSpinEdit =====

Numeric input with spinner buttons.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<SpinEdit Value="{Binding Quantity}"
          MinValue="1" MaxValue="100"
          Increment="1" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Double | 0 | Current value |
^ MinValue | Double | MinDouble | Minimum value |
^ MaxValue | Double | MaxDouble | Maximum value |
^ Increment | Double | 1 | Step size |
^ DecimalPlaces | Integer | 0 | Decimal places |
^ UseThousandSeparator | Boolean | False | Thousand separator |

==== Events ====

| Event | Signature | Description |
^ OnValueChanged | TNotifyEvent | Value changed |

----

===== TWvdSDateEdit =====

Date picker with calendar popup.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<DateEdit Date="{Binding BirthDate}"
          MinDate="1900-01-01"
          DateFormat="dd.MM.yyyy" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Date | TDateTime | 0 | Selected date |
^ MinDate | TDateTime | 0 | Earliest date |
^ MaxDate | TDateTime | 0 | Latest date |
^ DateFormat | string | 'dd.MM.yyyy' | Display format |
^ ShowWeekNumbers | Boolean | False | Show week numbers |

==== Events ====

| Event | Signature | Description |
^ OnDateChanged | TNotifyEvent | Date changed |

----

===== TWvdSTimeEdit =====

Time picker.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<TimeEdit Time="{Binding StartTime}"
          TimeFormat="HH:mm"
          Use24HourFormat="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Time | TDateTime | 0 | Selected time |
^ TimeFormat | string | 'HH:mm:ss' | Display format |
^ Use24HourFormat | Boolean | True | 24-hour format |
^ ShowSeconds | Boolean | True | Show seconds |

==== Events ====

| Event | Signature | Description |
^ OnTimeChanged | TNotifyEvent | Time changed |

----

===== TWvdSDateTimeEdit =====

Combined date and time picker.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<DateTimeEdit DateTime="{Binding AppointmentTime}"
              DateTimeFormat="dd.MM.yyyy HH:mm" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ DateTime | TDateTime | 0 | Date and time |
^ DateTimeFormat | string | 'dd.MM.yyyy HH:mm:ss' | Format |

----

===== TWvdSCalcEdit =====

Calculator input field.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<CalcEdit Value="{Binding Price}"
          DecimalPlaces="2"
          Prefix="$ " />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Double | 0 | Calculated value |
^ DecimalPlaces | Integer | 2 | Decimal places |
^ Prefix | string | '' | Prefix (e.g., currency) |
^ Suffix | string | '' | Suffix |

----

===== TWvdSColorEdit =====

Color picker.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<ColorEdit Color="{Binding ThemeColor}"
           ShowAlpha="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Color | TWvdSColor | clBlack | Selected color |
^ ShowAlpha | Boolean | False | Show alpha channel |
^ ColorPalette | TWvdSColorPalette | cpDefault | Predefined palette |

==== Events ====

| Event | Signature | Description |
^ OnColorChanged | TNotifyEvent | Color changed |

----

===== TWvdSMaskEdit =====

Masked input.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<MaskEdit EditMask="(000) 000-0000"
          Text="{Binding PhoneNumber}" />
<MaskEdit EditMask="00.00.0000"
          Text="{Binding Date}" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Text | string | '' | Formatted text |
^ EditValue | string | '' | Unformatted value |
^ EditMask | string | '' | Input mask |
^ MaskKind | TWvdSMaskKind | mkStandard | Standard, RegEx |
^ PlaceHolder | Char | '_' | Placeholder character |

==== Mask Syntax ====

| Character | Meaning |
^ 0 | Digit (required) |
^ 9 | Digit (optional) |
^ L | Letter (required) |
^ ? | Letter (optional) |
^ A | Alphanumeric (required) |
^ a | Alphanumeric (optional) |

----

===== TWvdSRichEdit =====

Formatted text editor.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<RichEdit Document="{Binding Content}"
          ShowToolbar="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Document | TWvdSDocument | nil | RTF/HTML document |
^ PlainText | string | '' | Plain text access |
^ ShowToolbar | Boolean | True | Formatting toolbar |

----

===== TWvdSTokenEdit =====

Tag/Token input.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<TokenEdit Tokens="{Binding Tags}"
           AllowDuplicates="False"
           MaxTokens="10" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Tokens | TStrings | nil | Token list |
^ AllowDuplicates | Boolean | False | Duplicates allowed |
^ MaxTokens | Integer | 0 | Max tokens (0=unlimited) |
^ Separator | Char | ',' | Separator on text input |

==== Events ====

| Event | Signature | Description |
^ OnTokenAdded | TTokenEvent | Token added |
^ OnTokenRemoved | TTokenEvent | Token removed |

----

===== TWvdSComboBoxEdit =====

Dropdown selection list.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<ComboBoxEdit SelectedItem="{Binding Country}"
              ItemsSource="{Binding Countries}"
              DisplayMember="Name" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Items | TStrings | nil | Static items |
^ ItemsSource | IEnumerable | nil | Bound data |
^ SelectedItem | TObject | nil | Selected item |
^ SelectedIndex | Integer | -1 | Selected index |
^ DisplayMember | string | '' | Display field |
^ ValueMember | string | '' | Value field |
^ DropDownStyle | TWvdSDropDownStyle | dsDropDown | DropDown, DropDownList |

==== Events ====

| Event | Signature | Description |
^ OnSelectedIndexChanged | TNotifyEvent | Selection changed |

----

===== TWvdSLookupEdit =====

Lookup dropdown with search.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<LookupEdit SelectedValue="{Binding CustomerId}"
            ItemsSource="{Binding Customers}"
            DisplayMember="Name"
            ValueMember="Id"
            SearchMode="Contains" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ ItemsSource | IEnumerable | nil | Data source |
^ SelectedValue | TValue | nil | Selected value |
^ DisplayMember | string | '' | Display field |
^ ValueMember | string | '' | Value field |
^ SearchMode | TWvdSSearchMode | smStartsWith | StartsWith, Contains |
^ PopupWidth | Integer | 0 | Popup width (0=Auto) |

----

===== TWvdSCheckedComboBox =====

Multi-select dropdown.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<CheckedComboBox ItemsSource="{Binding Categories}"
                 SelectedItems="{Binding SelectedCategories}"
                 DisplayMember="Name" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ ItemsSource | IEnumerable | nil | All items |
^ SelectedItems | IList | nil | Selected items |
^ SelectAllText | string | '(Select All)' | "Select all" text |

----

===== TWvdSMRUEdit =====

Most Recently Used input.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<MRUEdit Text="{Binding SearchText}"
         MaxItems="10"
         StorageKey="RecentSearches" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Text | string | '' | Current text |
^ Items | TStrings | nil | MRU list |
^ MaxItems | Integer | 10 | Max entries |
^ StorageKey | string | '' | Persistence key |

----

===== TWvdSPopupEdit =====

Input with custom popup.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<PopupEdit DisplayText="{Binding SelectedAddress.Display}">
  <PopupEdit.PopupContent>
    <AddressSelector Value="{Binding SelectedAddress}" />
  </PopupEdit.PopupContent>
</PopupEdit>
</code>

==== Properties ====

| Property | Type | Default | Description |
^ DisplayText | string | '' | Displayed text |
^ PopupContent | TWvdSFrameworkElement | nil | Popup content |
^ PopupWidth | Integer | 300 | Popup width |
^ PopupHeight | Integer | 200 | Popup height |

----

===== TWvdSRatingControl =====

Star rating.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<RatingControl Value="{Binding Rating}"
               ItemCount="5"
               AllowHalf="True" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ Value | Double | 0 | Rating (0-ItemCount) |
^ ItemCount | Integer | 5 | Number of stars |
^ AllowHalf | Boolean | False | Half stars allowed |
^ IsReadOnly | Boolean | False | Read-only |

----

===== TWvdSRangeTrackBar =====

Range selection slider.

==== Namespace ====

''WvdS.UI.Controls.Editors''

==== PXAML ====

<code xml>
<RangeTrackBar MinValue="{Binding PriceMin}"
               MaxValue="{Binding PriceMax}"
               Minimum="0" Maximum="1000" />
</code>

==== Properties ====

| Property | Type | Default | Description |
^ MinValue | Double | 0 | Lower bound |
^ MaxValue | Double | 100 | Upper bound |
^ Minimum | Double | 0 | Absolute minimum |
^ Maximum | Double | 100 | Absolute maximum |
^ Step | Double | 1 | Step size |

==== Events ====

| Event | Signature | Description |
^ OnRangeChanged | TRangeEvent | Range changed |

----

===== See Also =====

  * [[.:control-bibliothek|Control Library]]
  * [[.:api-controls-basic|Basic Controls API]]
  * [[.:api-controls-data|Data Controls API]]