====== API: Osnovni kontrolniki ======

API-referenca za osnovne UI kontrolnike.

===== TWvdSLabel =====

Prikaz besedila brez 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>

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Text | string | '' | Prikazano besedilo |
^ FontWeight | TWvdSFontWeight | fwNormal | Normal, Bold |
^ FontStyle | TWvdSFontStyle | fsNormal | Normal, Italic |
^ Foreground | TWvdSColor | clDefault | Barva besedila |
^ TextWrapping | TWvdSTextWrapping | twNoWrap | NoWrap, Wrap, WrapWithOverflow |
^ TextAlignment | TWvdSTextAlignment | taLeft | Left, Center, Right |

==== Dogodki ====

Brez (ni interaktiven).

----

===== TWvdSButton =====

Standardni gumb za uporabniska dejanja.

==== 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>

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Caption | string | '' | Besedilo gumba |
^ IsDefault | Boolean | False | Tipka Enter sprozi klik |
^ IsCancel | Boolean | False | Tipka Escape sprozi klik |
^ IsEnabled | Boolean | True | Omogocen/Onemogocen |
^ Command | IWvdSCommand | nil | Vezan ukaz |
^ CommandParameter | TValue | nil | Parameter za ukaz |
^ ImageSource | TWvdSImageSource | nil | Neobvezna ikona |

==== Dogodki ====

| Dogodek | Podpis | Opis |
^ OnClick | TNotifyEvent | Gumb je bil kliknjen |

==== Primer ====

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

----

===== TWvdSTextBox =====

Enostavno enovrsticno besedilno 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>

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Text | string | '' | Trenutno besedilo |
^ PlaceholderText | string | '' | Nadomestno besedilo |
^ MaxLength | Integer | 0 | Maks. znakov (0=neomejeno) |
^ IsReadOnly | Boolean | False | Nacin samo za branje |
^ IsPassword | Boolean | False | Nacin za geslo (*****) |
^ SelectionStart | Integer | 0 | Polozaj kurzorja |
^ SelectionLength | Integer | 0 | Izbrani znaki |

==== Dogodki ====

| Dogodek | Podpis | Opis |
^ OnTextChanged | TNotifyEvent | Besedilo je bilo spremenjeno |
^ OnKeyDown | TKeyEventHandler | Tipka pritisnjena |

----

===== TWvdSCheckBox =====

Potrditveno polje za Boolean vrednosti.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Content | string | '' | Oznaka |
^ IsChecked | Boolean? | False | Oznaceno, Neoznaceno, Nedoloceno |
^ IsThreeState | Boolean | False | Tretje stanje dovoljeno |

==== Dogodki ====

| Dogodek | Podpis | Opis |
^ OnCheckedChanged | TNotifyEvent | Stanje spremenjeno |

----

===== TWvdSRadioButton =====

Izbirni gumb za medsebojno izkljucujoco izbiro.

==== 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>

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Content | string | '' | Oznaka |
^ IsChecked | Boolean | False | Izbrano |
^ GroupName | string | '' | Ime skupine |

==== Dogodki ====

| Dogodek | Podpis | Opis |
^ OnCheckedChanged | TNotifyEvent | Izbira spremenjena |

----

===== 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>

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Source | TWvdSImageSource | nil | Vir slike |
^ Stretch | TWvdSStretch | sNone | None, Fill, Uniform, UniformToFill |

==== TUI-opomba ====

<note>V TUI-targetu se uporablja Kitty Graphics ali Sixel. Nadomestek: Placeholder z okvirjem.</note>

----

===== TWvdSProgressBar =====

Prikaz napredka.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Value | Double | 0 | Trenutna vrednost |
^ Minimum | Double | 0 | Minimalna vrednost |
^ Maximum | Double | 100 | Maksimalna vrednost |
^ IsIndeterminate | Boolean | False | Nedoloceni nacin |
^ Orientation | TWvdSOrientation | oHorizontal | Horizontal, Vertical |

----

===== TWvdSSlider =====

Drsnik za izbiro vrednosti.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Value | Double | 0 | Trenutna vrednost |
^ Minimum | Double | 0 | Minimalna vrednost |
^ Maximum | Double | 100 | Maksimalna vrednost |
^ SmallChange | Double | 1 | Majhen korak |
^ LargeChange | Double | 10 | Velik korak |
^ TickFrequency | Double | 0 | Razmik oznak |
^ IsSnapToTickEnabled | Boolean | False | Zaklep na oznake |
^ Orientation | TWvdSOrientation | oHorizontal | Horizontal, Vertical |

==== Dogodki ====

| Dogodek | Podpis | Opis |
^ OnValueChanged | TNotifyEvent | Vrednost spremenjena |

----

===== TWvdSToggleButton =====

Vklop/izklop stikalo.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ IsChecked | Boolean | False | Vklop/izklop stanje |
^ ContentOn | string | 'ON' | Besedilo pri vklopu |
^ ContentOff | string | 'OFF' | Besedilo pri izklopu |

==== Dogodki ====

| Dogodek | Podpis | Opis |
^ OnToggled | TNotifyEvent | Stanje preklopljeno |

----

===== TWvdSHyperlink =====

Klikljiva povezava.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Text | string | '' | Besedilo povezave |
^ NavigateUri | string | '' | Ciljni URL |
^ Command | IWvdSCommand | nil | Alternativni ukaz |

==== Dogodki ====

| Dogodek | Podpis | Opis |
^ OnClick | TNotifyEvent | Povezava kliknjena |

----

===== TWvdSBorder =====

Okvir in vsebnik.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ BorderThickness | TWvdSThickness | 0 | Debelina okvirja |
^ BorderBrush | TWvdSBrush | nil | Barva okvirja |
^ Background | TWvdSBrush | nil | Ozadje |
^ CornerRadius | TWvdSCornerRadius | 0 | Polmer vogalov |
^ Padding | TWvdSThickness | 0 | Notranji odmik |
^ Child | TWvdSFrameworkElement | nil | Vsebina |

----

===== TWvdSSeparator =====

Vizualna locilna crta.

==== Namespace ====

''WvdS.UI.Controls.Basic''

==== PXAML ====

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

==== Lastnosti ====

| Lastnost | Tip | Privzeto | Opis |
^ Orientation | TWvdSOrientation | oHorizontal | Horizontal, Vertical |
^ Stroke | TWvdSBrush | nil | Barva crte |
^ StrokeThickness | Double | 1 | Debelina crte |

----

===== Glejte tudi =====

  * [[.:control-bibliothek|Knjiznica kontrolnikov]]
  * [[.:api-controls-editors|API urejevalnih kontrolnikov]]
  * [[.:control-architektur|Arhitektura kontrolnikov]]