====== API: Basic Controls ======

API-Referenz für grundlegende UI-Controls.

===== TWvdSLabel =====

Textanzeige ohne Interaktion.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== Syntax ====

<code pascal>
TWvdSLabel = class(TWvdSControl)
</code>

==== PXAML ====

<code xml>
<Label Text="Hello World" />
<Label Text="{Binding CustomerName}" FontWeight="Bold" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Text | string | '' | Anzuzeigender Text |
^ FontWeight | TWvdSFontWeight | fwNormal | Normal, Bold |
^ FontStyle | TWvdSFontStyle | fsNormal | Normal, Italic |
^ Foreground | TWvdSColor | clDefault | Textfarbe |
^ TextWrapping | TWvdSTextWrapping | twNoWrap | NoWrap, Wrap, WrapWithOverflow |
^ TextAlignment | TWvdSTextAlignment | taLeft | Left, Center, Right |

==== Events ====

Keine (nicht interaktiv).

----

===== TWvdSButton =====

Standard-Schaltfläche für Benutzeraktionen.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== Syntax ====

<code pascal>
TWvdSButton = class(TWvdSControl)
</code>

==== PXAML ====

<code xml>
<Button Caption="OK" OnClick="OnOkClick" />
<Button Caption="Save" Command="{Binding SaveCommand}" IsDefault="True" />
<Button Caption="Cancel" IsCancel="True" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Caption | string | '' | Schaltflächentext |
^ IsDefault | Boolean | False | Enter-Taste löst Click aus |
^ IsCancel | Boolean | False | Escape-Taste löst Click aus |
^ IsEnabled | Boolean | True | Aktiviert/Deaktiviert |
^ Command | IWvdSCommand | nil | Gebundener Command |
^ CommandParameter | TValue | nil | Parameter für Command |
^ ImageSource | TWvdSImageSource | nil | Optionales Icon |

==== Events ====

| Event | Signatur | Beschreibung |
^ OnClick | TNotifyEvent | Schaltfläche wurde geklickt |

==== Beispiel ====

<code pascal>
procedure TMainWindow.OnSaveClick(Sender: TObject);
begin
  if ValidateForm then
    SaveData;
end;
</code>

----

===== TWvdSTextBox =====

Einfaches einzeiliges Textfeld.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== Syntax ====

<code pascal>
TWvdSTextBox = class(TWvdSControl)
</code>

==== PXAML ====

<code xml>
<TextBox Text="{Binding Username, Mode=TwoWay}" />
<TextBox Text="" PlaceholderText="Enter name..." MaxLength="50" />
<TextBox Text="" IsReadOnly="True" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Text | string | '' | Aktueller Text |
^ PlaceholderText | string | '' | Platzhaltertext |
^ MaxLength | Integer | 0 | Max. Zeichen (0=unbegrenzt) |
^ IsReadOnly | Boolean | False | Nur-Lesen-Modus |
^ IsPassword | Boolean | False | Passwort-Modus (*****) |
^ SelectionStart | Integer | 0 | Cursor-Position |
^ SelectionLength | Integer | 0 | Selektierte Zeichen |

==== Events ====

| Event | Signatur | Beschreibung |
^ OnTextChanged | TNotifyEvent | Text wurde geändert |
^ OnKeyDown | TKeyEventHandler | Taste gedrückt |

----

===== TWvdSCheckBox =====

Kontrollkästchen für Boolean-Werte.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

<code xml>
<CheckBox Content="Remember me" IsChecked="{Binding RememberMe}" />
<CheckBox Content="I agree" IsThreeState="False" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Content | string | '' | Beschriftung |
^ IsChecked | Boolean? | False | Checked, Unchecked, Indeterminate |
^ IsThreeState | Boolean | False | Dritter Zustand erlaubt |

==== Events ====

| Event | Signatur | Beschreibung |
^ OnCheckedChanged | TNotifyEvent | Zustand geändert |

----

===== TWvdSRadioButton =====

Optionsfeld für gegenseitig ausschließende Auswahl.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

<code xml>
<StackPanel>
  <RadioButton Content="Option A" GroupName="options" IsChecked="True" />
  <RadioButton Content="Option B" GroupName="options" />
  <RadioButton Content="Option C" GroupName="options" />
</StackPanel>
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Content | string | '' | Beschriftung |
^ IsChecked | Boolean | False | Ausgewählt |
^ GroupName | string | '' | Gruppenname |

==== Events ====

| Event | Signatur | Beschreibung |
^ OnCheckedChanged | TNotifyEvent | Auswahl geändert |

----

===== TWvdSImage =====

Bildanzeige.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

<code xml>
<Image Source="logo.png" Width="100" Height="100" />
<Image Source="{Binding ProductImage}" Stretch="Uniform" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Source | TWvdSImageSource | nil | Bildquelle |
^ Stretch | TWvdSStretch | sNone | None, Fill, Uniform, UniformToFill |

==== TUI-Hinweis ====

<note>Im TUI-Target wird Kitty Graphics oder Sixel verwendet. Fallback: Placeholder mit Rahmen.</note>

----

===== TWvdSProgressBar =====

Fortschrittsanzeige.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

<code xml>
<ProgressBar Value="{Binding Progress}" Minimum="0" Maximum="100" />
<ProgressBar IsIndeterminate="True" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Value | Double | 0 | Aktueller Wert |
^ Minimum | Double | 0 | Minimalwert |
^ Maximum | Double | 100 | Maximalwert |
^ IsIndeterminate | Boolean | False | Unbestimmter Modus |
^ Orientation | TWvdSOrientation | oHorizontal | Horizontal, Vertical |

----

===== TWvdSSlider =====

Schieberegler für Werteauswahl.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

<code xml>
<Slider Value="{Binding Volume}" Minimum="0" Maximum="100" />
<Slider Value="50" TickFrequency="10" IsSnapToTickEnabled="True" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Value | Double | 0 | Aktueller Wert |
^ Minimum | Double | 0 | Minimalwert |
^ Maximum | Double | 100 | Maximalwert |
^ SmallChange | Double | 1 | Kleine Schrittweite |
^ LargeChange | Double | 10 | Große Schrittweite |
^ TickFrequency | Double | 0 | Tick-Abstand |
^ IsSnapToTickEnabled | Boolean | False | An Ticks einrasten |
^ Orientation | TWvdSOrientation | oHorizontal | Horizontal, Vertical |

==== Events ====

| Event | Signatur | Beschreibung |
^ OnValueChanged | TNotifyEvent | Wert geändert |

----

===== TWvdSToggleButton =====

Ein/Aus-Schalter.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

<code xml>
<ToggleButton IsChecked="{Binding DarkMode}" ContentOn="ON" ContentOff="OFF" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ IsChecked | Boolean | False | Ein/Aus-Zustand |
^ ContentOn | string | 'ON' | Text bei Ein |
^ ContentOff | string | 'OFF' | Text bei Aus |

==== Events ====

| Event | Signatur | Beschreibung |
^ OnToggled | TNotifyEvent | Zustand gewechselt |

----

===== TWvdSHyperlink =====

Klickbarer Link.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

<code xml>
<Hyperlink NavigateUri="https://example.com" Text="Visit Website" />
<Hyperlink Command="{Binding OpenHelpCommand}" Text="Help" />
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Text | string | '' | Linktext |
^ NavigateUri | string | '' | Ziel-URL |
^ Command | IWvdSCommand | nil | Alternativer Command |

==== Events ====

| Event | Signatur | Beschreibung |
^ OnClick | TNotifyEvent | Link geklickt |

----

===== TWvdSBorder =====

Rahmen und Container.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

<code xml>
<Border BorderThickness="1" BorderBrush="Gray" Padding="10">
  <Label Text="Content inside border" />
</Border>
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ BorderThickness | TWvdSThickness | 0 | Rahmendicke |
^ BorderBrush | TWvdSBrush | nil | Rahmenfarbe |
^ Background | TWvdSBrush | nil | Hintergrund |
^ CornerRadius | TWvdSCornerRadius | 0 | Eckenradius |
^ Padding | TWvdSThickness | 0 | Innenabstand |
^ Child | TWvdSFrameworkElement | nil | Inhalt |

----

===== TWvdSSeparator =====

Visuelle Trennlinie.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

<code xml>
<StackPanel>
  <Button Caption="Item 1" />
  <Separator />
  <Button Caption="Item 2" />
</StackPanel>
</code>

==== Properties ====

| Property | Typ | Default | Beschreibung |
^ Orientation | TWvdSOrientation | oHorizontal | Horizontal, Vertical |
^ Stroke | TWvdSBrush | nil | Linienfarbe |
^ StrokeThickness | Double | 1 | Liniendicke |

----

===== Siehe auch =====

  * [[.:control-bibliothek|Control-Bibliothek]]
  * [[.:api-controls-editors|Editor Controls API]]
  * [[.:control-architektur|Control-Architektur]]