<?xml version="1.0"  encoding="UTF-8" ?>

<sect1 id="widgets">
<sect1info>
<title
>Vidinad</title>
<authorgroup>
<author
><firstname
></firstname
> <surname
></surname
> <affiliation
><address
> <email
></email>
</address
></affiliation>
</author>

<othercredit role="translator"
><firstname
>Marek</firstname
> <surname
>Laane</surname
> <affiliation
><address
><email
>bald@smail.ee</email
></address
> </affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 

</authorgroup>
</sect1info>

<title
>Vidinad</title>

<para
>&kommander;i dialoogi ehituskivideks on vidinad. Need sarnanevad kõigi muude &Qt; ja &kde; teekide vidinatega, ainult et neile on lisatud mõningaid võimalusi, et neil võiks olla <quote
>tekstiseosed</quote
>. See tähendab, et tekst seostatakse vidina olekuga või selle populatsioonipesaga. Olekute arv sõltub vidinast. Kui vidinal on ainult üks olek, nimetatakse seda vaikeolekuks. </para>

<para
>Vidina tekst ....</para>

<para
>Dialoogil on &kommander;i teksti mõttes kaks eriolekut: initsialiseerimine ja hävitamine. Nagu nimed ütlevad, käivitatakse need vastavalt dialoogi initsialiseerimisel ja hävitamisel. Need kaitsevad avamisel niinimetatud <quote
>võidujooksu</quote
> (race) probleemide eest, mistõttu sa ei pea kogu aeg muretsema mingite spetsiaalsete sulgemisprotseduuride pärast.</para>


<variablelist>
<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="buttongroup.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Nupugrupp </term>
<listitem>
<para
>Konteiner mitme nupu organiseerimiseks ühe grupina. Tiitliomadusega saab soovi korral määrata nupugrupi nime. Raami saab kohendada omadusega lineWidth. Nupugrupi võib määrata välistavaks, kui anda vastavale omadusele väärtus 'tõene'. See tähendab, et kui grupis klõpsatakse mingit nuppu, see aktiveeritakse ning teised nupud deaktiveeritakse. Erandiks on siinkohal raadionupud, mis on alati vastastikku välistavad isegi juhul, kui gruppi ei ole välistavaks määratud. Raadinuppe saab määrata mittevälistavaks omadusega radioButtonExclusive (aga tegelikult pole ma eriti kindel, et see omadus üldse midagi teeb). </para>
<para
>Nupugrupil on üks olek - seega on see vaikeolek.</para>
<para
>Nupugrupi vidina tekst kujutab endast iga nupu tekstiseoseid sellises järjekorras, nagu nad nupugrupis esinevad. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="checkbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Märkekast </term>
<listitem>
<para
>Nupp, mida saab sisse ja välja lülitada. See võib olla ka poolmärgitud, kui kolmeolekuline omadus on märgitud tõeseks. Märkekastiga seotud pealdis määratakse kindlaks tekstiomadusega. Märgitud omaduse määramine paneb märkekasti algselt märgitud olekusse. </para>
<para
>Märkekastil on kolm olekut: märgitud, poolmärgitud ja märkimata. </para>
<para
>Märkekasti vidina tekst on tekstiomaduse väärtus. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Sulgemisnupp </term>
<listitem>
<para
>Nupp, millel klõpsates käivitatakse selle tekstiseis ja seejärel suletakse dialoog. Nupu pealdise saab määrata tekstiomadusega. Tekstiseose väljund saadetakse standardväljundise, kui omadus writeStdout on määratud tõeseks. Nupp võib olla dialoogi vaiketoiming, kui vaikeväärtuse omadus on määratud tõeseks. </para>
<para
>Sulgemisnupul on üks olek - seega vaikeolek. </para>
<para
>Sulgemisnupuga pole seotud mingit vidina teksti. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="combobox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Liitkast </term>
<listitem>
<para
>Liitkast on valikuvidin, mis ühendab endas nupu ja hüpikmenüü. See näitab kasutajale valikute nimekirjast parajasti sobivat valikut minimaalse ruumiga. Elemente saab nimekirja lisada redigeerimisaknas. Kui redigeerimisomadus on määratud tõeseks, saab kasutaja oma suva järgi kasti stringe sisestada. </para>
<para
>Liitkastil on üks olek - seega vaikeolek. </para>
<para
>Liitkasti vidina tekst on valitud elemendi tekst. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Käivitamisnupp </term>
<listitem>
<para
>Nupp, millele klõpsates käivitatakse selle tekstiseos. Nupu pealdise saab määrata tekstiomadusega. Tekstiseose väljund saadetakse standardväljundise, kui omadus writeStdout on määratud tõeseks. Nupp võib olla dialoogi vaiketoiming, kui vaikeväärtuse omadus on määratud tõeseks. </para>
<para
>Käivitamisnupul on üks olek - seega vaikeolek. </para>
<para
>Käivitamisnupuga pole seostatud mingit vidina teksti. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Failivalija </term>
<listitem>
<para
>Failivalija vidin kombineerib tekstikasti nupuga, millel klõpsates saab kasutaja avada dialoogi failide/kataloogide valimiseks. Valitud fail/kataloog salvestatakse tekstikastis. Failivalija tüüp määratakse omadusega selectionType. Võimalikud variandid on Open (avamine), Save (salvestamine) ja Directory (kataloog). Mitut faili/kataloogi on võimalik valida, kui määrata tõeseks omadus selectionOpenMultiple. Failivalija pealdise võib määrata omadusega selectionCaption. See on näidatava dialoogiakna tiitel. Kui pealdist ei määrata, näidatakse tiitliribal valikutüüpi. Dialoogis näidatavaid faile saab piirata omadusega selectionFilter. </para>
<para
>Failivalijal on üks olek - seega vaikeolek. </para>
<para
>Failivalija vidina tekst on tekstikastis sisalduv tekst (kasutaja valitud fail). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="groupbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Grupikast </term>
<listitem>
<para
>Konteinervidin, mis sisaldab muid vidinaid. Raami saab kohendada omadusega lineWidth. Tiitli saab lisada tiitliomadust määrates. </para>
<para
>Grupikastil on üks olek - seega vaikeolek. </para>
<para
>Grupikasti vidina tekst on kõigi selles sisalduvate vidinate tekstiseosed üheskoos. Need on järjekorras, nagu nad esinevad grupikastis. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Tekstikast </term>
<listitem>
<para
>Tekstikast on ührealine tekstiredaktor. See lubab kasutajal sisestada ja muuta ühtainust tekstirida. Tekstiomadusega saab määrata redaktori esialgse teksti. Omadusega readOnly saab vidina määrata ainult vaadatavaks, mitte muudetavaks. Vidinal võib olla kolm režiimi: normaalne (Normal), kajata (NoEcho) ja parool (Password). Režiimi saab määrata omadusega echoMode. </para>
<para
>Tekstikastil on üks olek - seega vaikeolek. </para>
<para
>Tekstikasti vidina tekst on redaktoris sisalduv tekst. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Loendikast </term>
<listitem>
<para
>Loendikasti vidin pakub välja valitavate elementide loendi. Tavaliselt saab valida ühe elemendi või mitte ühtegi. Seda saab muuta omadusega selectionMode. Elemendid lisatakse loendikasti redigeerimisaknas. </para>
<para
>Loendikastil on ainult üks olek - seega vaikeolek. </para>
<para
>Loendikasti vidina tekst on loendikastis leiduvad elemendid. @selectedWidgetText tagastab ainult parajasti valitud elemendid. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Loendivaade </term>
<listitem>
<para
>See element &kommander;is teeb sama, mis puuvidin, nii et vaata sealt lähemalt. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pixlabel.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Pildipealdis </term>
<listitem>
<para
>Lihtne pildi- või tekstipealdist sisaldav vidin. Näidatava pildi määrab omadus pixmap. Teksti määrab tekstiomadus. Korraga saab määrata ainult ühe neist omadusest. Kui scaledContents on tõene, skaleeritakse pilt vidina suurusele vastavaks. Teksti vorminduse saab määrata omadusga textFormat. </para>
<para
>See element &kommander;is ei tööta ning tal ei ole seega ka ühtegi olekut ega vidina teksti. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="radiobutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Raadionupp </term>
<listitem>
<para
>Nupp, mida võib märkida või märke eemaldada, tavaliselt kasutatakse nupugrupis välistava valiku langetamiseks. Nupuga seostatud teksti määrab tekstiomadus. Nupu saab initsialiseerida märgituna, kui anda omadusele checked tõene väärtus. Kui nupugrupis peaks kõigil raadionuppudel olema omadus checked märgitud tõeseks, märgitakse tegelikult ära viimane nupp. </para>
<para
>Raadionupul on kaks olekut: märgitud ja märkimata. </para>
<para
>Raadionupuga pole seostatud mingit vidina teksti. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="richtextedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> RichText redaktor </term>
<listitem>
<para
>See vidin pakub tekstiredaktori,mis võimaldab lihtsamat teksti vormindamist. </para>
<para
>RichText redaktoril on üks olek - seega vaikeolek. </para>
<para
>RichText redaktori vidina tekst on redaktori rikkalikus tekstivormingus tekst. Valitud teksti võib tagastada @selectedWidgetText. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Kerimiskast </term>
<listitem>
<para
>See vidin lubab kasutajal muuta täisarvulist väärtust kas üles ja alla osutavaid nooli vajutades või arvu kasti sisestades. Vidina miinimum- ja maksimumväärtuse saab määrata omadustega minValue ja maxValue. Omadusega specialValueText saab määrata miinimumväärtuse asemel näidata tekstilise väärtuse. </para>
<para
>Sellel vidinal on ainult üks olek - seega vaikeolek. </para>
<para
>Kerimiskasti vidina tekst on parajasti näidatav täisarv. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="frame.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Alamdialoog </term>
<listitem>
<para
>Nupp, mis käivitab vajutamisel uue &kommander;i dialoogi. Käivitatava dialoogi määrab omadus kmdrFile. Kui omadus default on määratud tõeseks, käivitatakse dialoog juhul, kui vajutatakse klahvi Enter ajal, mid dialoog on fookuses. </para>
<para
>Alamdialoogil on üks olek - seega vaikeolek. </para>
<para
>Alamdialoogi vidina tekst on käivitatava dialoogi tekstiseos. </para>
<note
><para
>See oli mõeldud sisaldama dialoogi, kuid nüüd on seda asendanud uus projektikontseptsioon. Praegu on igatahes lahtine, mida sellega ette võtta.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="tabwidget.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Kaardividin </term>
<listitem>
<para
>Vidin, mis pakub mitu kaarti, mis kõik võivad sisaldada omakorda vidinaid. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="multilineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TextEdit </term>
<listitem>
<para
>Lihtne mitmerealine tekstiredaktor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="label.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Tekstipealdis </term>
<listitem>
<para
>Lihtne teksti sisaldav vidin. </para>
<para
>Praegusel hetkel toimib see vidin vaid osaliselt ning võib kasutada väliseid DCOP väljakutseid. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Puuvidin </term>
<listitem>
<para
>Vidin, mis pakub loendit puukujulisena. Selle abil saab elemente puust eemaldada või neid sinna lisada. Lisada saab alamelemente ja mitmeveerulisi andmeid. Praegu ei saa veel muuta veerge. Järglassõlme lisamiseks kasuta eraldajana <quote
>/</quote
>. Veeruandmete lisamiseks kasuta veergude vahel paomärgiga tabulaatorimärki <quote
>\t</quote
>. </para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
