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

API-referenca za osnovne UI-kontrole.

===== TWvdSLabel =====

Prikaz teksta bez interakcije.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== Sintaksa ====

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

==== PXAML ====

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

==== Properties ====

| Property | Tip | Default | Opis |
^ Text | string | '' | Tekst za prikaz |
^ FontWeight | TWvdSFontWeight | fwNormal | Normal, Bold |
^ FontStyle | TWvdSFontStyle | fsNormal | Normal, Italic |
^ Foreground | TWvdSColor | clDefault | Boja teksta |
^ TextWrapping | TWvdSTextWrapping | twNoWrap | NoWrap, Wrap, WrapWithOverflow |
^ TextAlignment | TWvdSTextAlignment | taLeft | Left, Center, Right |

==== Events ====

Nema (nije interaktivan).

----

===== TWvdSButton =====

Standardni gumb za korisničke akcije.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== Sintaksa ====

<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 | Tip | Default | Opis |
^ Caption | string | '' | Tekst gumba |
^ IsDefault | Boolean | False | Enter-tipka aktivira Click |
^ IsCancel | Boolean | False | Escape-tipka aktivira Click |
^ IsEnabled | Boolean | True | Aktiviran/Deaktiviran |
^ Command | IWvdSCommand | nil | Povezani Command |
^ CommandParameter | TValue | nil | Parametar za Command |
^ ImageSource | TWvdSImageSource | nil | Opcionalna ikona |

==== Events ====

| Event | Signatura | Opis |
^ OnClick | TNotifyEvent | Gumb je kliknut |

==== Primjer ====

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

----

===== TWvdSTextBox =====

Jednostavno jednolinijsko tekstualno polje.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== Sintaksa ====

<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 | Tip | Default | Opis |
^ Text | string | '' | Trenutni tekst |
^ PlaceholderText | string | '' | Placeholder tekst |
^ MaxLength | Integer | 0 | Max. znakova (0=neograničeno) |
^ IsReadOnly | Boolean | False | Samo za čitanje |
^ IsPassword | Boolean | False | Password-način (*****) |
^ SelectionStart | Integer | 0 | Pozicija kursora |
^ SelectionLength | Integer | 0 | Broj odabranih znakova |

==== Events ====

| Event | Signatura | Opis |
^ OnTextChanged | TNotifyEvent | Tekst je promijenjen |
^ OnKeyDown | TKeyEventHandler | Tipka pritisnuta |

----

===== TWvdSCheckBox =====

Potvrdni okvir za Boolean-vrijednosti.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Properties ====

| Property | Tip | Default | Opis |
^ Content | string | '' | Oznaka |
^ IsChecked | Boolean? | False | Checked, Unchecked, Indeterminate |
^ IsThreeState | Boolean | False | Treće stanje dopušteno |

==== Events ====

| Event | Signatura | Opis |
^ OnCheckedChanged | TNotifyEvent | Stanje promijenjeno |

----

===== TWvdSRadioButton =====

Radio gumb za međusobno isključiv odabir.

==== 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 | Tip | Default | Opis |
^ Content | string | '' | Oznaka |
^ IsChecked | Boolean | False | Odabrano |
^ GroupName | string | '' | Naziv grupe |

==== Events ====

| Event | Signatura | Opis |
^ OnCheckedChanged | TNotifyEvent | Odabir promijenjen |

----

===== TWvdSImage =====

Prikaz slike.

==== 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 | Tip | Default | Opis |
^ Source | TWvdSImageSource | nil | Izvor slike |
^ Stretch | TWvdSStretch | sNone | None, Fill, Uniform, UniformToFill |

==== TUI-napomena ====

<note>U TUI-targetu koristi se Kitty Graphics ili Sixel. Fallback: Placeholder s okvirom.</note>

----

===== TWvdSProgressBar =====

Traka napretka.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Properties ====

| Property | Tip | Default | Opis |
^ Value | Double | 0 | Trenutna vrijednost |
^ Minimum | Double | 0 | Minimalna vrijednost |
^ Maximum | Double | 100 | Maksimalna vrijednost |
^ IsIndeterminate | Boolean | False | Neodređeni način |
^ Orientation | TWvdSOrientation | oHorizontal | Horizontal, Vertical |

----

===== TWvdSSlider =====

Klizač za odabir vrijednosti.

==== 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 | Tip | Default | Opis |
^ Value | Double | 0 | Trenutna vrijednost |
^ Minimum | Double | 0 | Minimalna vrijednost |
^ Maximum | Double | 100 | Maksimalna vrijednost |
^ SmallChange | Double | 1 | Mali korak |
^ LargeChange | Double | 10 | Veliki korak |
^ TickFrequency | Double | 0 | Razmak oznaka |
^ IsSnapToTickEnabled | Boolean | False | Hvatanje za oznake |
^ Orientation | TWvdSOrientation | oHorizontal | Horizontal, Vertical |

==== Events ====

| Event | Signatura | Opis |
^ OnValueChanged | TNotifyEvent | Vrijednost promijenjena |

----

===== TWvdSToggleButton =====

Prekidač Uklj/Isklj.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Properties ====

| Property | Tip | Default | Opis |
^ IsChecked | Boolean | False | Stanje Uklj/Isklj |
^ ContentOn | string | 'ON' | Tekst kad je uključeno |
^ ContentOff | string | 'OFF' | Tekst kad je isključeno |

==== Events ====

| Event | Signatura | Opis |
^ OnToggled | TNotifyEvent | Stanje promijenjeno |

----

===== TWvdSHyperlink =====

Klikabilna veza.

==== 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 | Tip | Default | Opis |
^ Text | string | '' | Tekst veze |
^ NavigateUri | string | '' | Ciljni URL |
^ Command | IWvdSCommand | nil | Alternativni Command |

==== Events ====

| Event | Signatura | Opis |
^ OnClick | TNotifyEvent | Veza kliknuta |

----

===== TWvdSBorder =====

Okvir i kontejner.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Properties ====

| Property | Tip | Default | Opis |
^ BorderThickness | TWvdSThickness | 0 | Debljina okvira |
^ BorderBrush | TWvdSBrush | nil | Boja okvira |
^ Background | TWvdSBrush | nil | Pozadina |
^ CornerRadius | TWvdSCornerRadius | 0 | Radijus kutova |
^ Padding | TWvdSThickness | 0 | Unutarnji razmak |
^ Child | TWvdSFrameworkElement | nil | Sadržaj |

----

===== TWvdSSeparator =====

Vizualna razdjelna linija.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Properties ====

| Property | Tip | Default | Opis |
^ Orientation | TWvdSOrientation | oHorizontal | Horizontal, Vertical |
^ Stroke | TWvdSBrush | nil | Boja linije |
^ StrokeThickness | Double | 1 | Debljina linije |

----

===== Vidi također =====

  * [[.:control-bibliothek|Biblioteka kontrola]]
  * [[.:api-controls-editors|Editor Controls API]]
  * [[.:control-architektur|Arhitektura kontrola]]