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

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

<othercredit role="translator"
> <firstname
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@comhem.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 

</authorgroup>
</sect1info>

<title
>Grafiska komponenter</title>

<para
>Byggblocken i en &kommander; dialogruta är de grafiska komponenterna. De är som alla andra grafiska komponenter i &Qt;- och &kde;-biblioteken, utom att de har en del extra funktioner som möjliggör att de har en <quote
>textassociation</quote
>. Text associeras med ett tillstånd hos den grafiska komponenten eller dess ifyllnadslot. Antal tillstånd beror på den grafiska komponenten. Om en komponent bara har ett tillstånd, kallas det förvalt. </para>

<para
>Den grafiska komponentens text bla bla.</para>

<para
>Dialogrutan har två specialtillstånd för &kommander; text. De är Initiate och Destroy. De körs när dialogrutan initieras och när den förstörs. Dessa skyddar mot vad som är känt som <quote
>kapplöppningsproblem</quote
> vid öppning, och betyder att du inte behöver några speciella procedurer vid stängning för att hantera underhåll.</para>


<variablelist>
<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="buttongroup.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Knappgrupp </term>
<listitem>
<para
>En omslutande komponent för att organisera knappar i grupper. En valfri rubrik kan anges med egenskapen title. Ramen kan justeras med egenskapen lineWidth. Knappgruppen kan ställa in för alternativval genom att sätta egenskapen exclusive till true. Det betyder att om en växlande knapp klickas, avmarkeras alla andra växlande knappar med undantag för alternativknappar som alltid är ömsesidigt uteslutande även om gruppen inte är inställd för alternativval. Alternativknappar kan ställas in att inte använda alternativval med egenskapen radioButtonExclusive (Jag är inte helt säker på att egenskapen verkligen fungerar). </para>
<para
>Knappgrupp har ett tillstånd, det förvalda.</para>
<para
>Komponenttexten för en knappgrupp är texten som hör ihop med var och en av knapparna i den ordning de syns i knappgruppen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="checkbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Kryssruta </term>
<listitem>
<para
>En knapp som kan markeras eller avmarkeras. Den kan också vara halvmarkerad om egenskapen tristate sätts till true. Rubriken som hör ihop med kryssrutan ställs in med textegenskapen. Sätts egenskapen checked, är kryssrutan markerad från början. </para>
<para
>En kryssruta har tre tillstånd, markerad, halvmarkerad och omarkerad. </para>
<para
>Komponenttexten för en kryssruta är värdet på egenskapen text. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Stängknapp </term>
<listitem>
<para
>En knapp som kör sin associerade text när den klickas och därefter stänger dialogrutan. Knappens rubrik ställs in med textegenskapen. Utmatning från textassociationen (hur säger man) ekas till standardutmatningen om egenskapen writeStdout sätts till true. Knappen kan vara dialogrutans standardåtgärd om egenskapen default sätts till true. </para>
<para
>En stängknapp har ett tillstånd, det förvalda. </para>
<para
>Det finns inte någon komponenttext som hör till en stängknapp. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="combobox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Kombinationsruta </term>
<listitem>
<para
>Kombinationsruta är urvalskomponent som kombinerar en knapp och en meny. Den visar användarens nuvarande val i en lista med alternativ på minsta möjliga utrymme. Objekt läggs till i listan genom att använda redigeringsfönstret. Om egenskapen editable sätts till true, kan användaren skriva in godtyckliga strängar. </para>
<para
>En kombinationsruta har ett tillstånd, det förvalda. </para>
<para
>Komponenttexten för en kombinationsruta är texten i det valda objektet. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Körknapp </term>
<listitem>
<para
>En knapp som kör sin associerade text när den klickas. Knappens rubrik ställs in med textegenskapen. Utmatning från textassociationen (hur säger man) ekas till standardutmatningen om egenskapen writeStdout sätts till true. Knappen kan vara dialogrutans standardåtgärd om egenskapen default sätts till true. </para>
<para
>Körknapp har ett tillstånd, det förvalda. </para>
<para
>Det finns inte någon komponenttext som hör till en körknapp. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Filväljare </term>
<listitem>
<para
>Den grafiska komponenten filväljare kombinerar en radeditor med en knapp, som när den klickas visar användaren en dialogruta för att välja filer eller kataloger. Filen eller katalogen som väljes lagras i radeditorn. Filväljarens typ anges med egenskapen selectionType. Tillgängliga typer är Open, Save och Directory. Flera filer eller kataloger kan väljas om egenskapen selectionOpenMutliple sätts till true. En rubrik för filväljaren kan anges med egenskapen selectionCaption. Den visas i dialogrutans namnlist. Om en rubrik inte anges, visas väljarens typ i rubriken. Filerna som visas i dialogrutan kan begränsas med egenskapen selectionFilter. </para>
<para
>Filväljaren har ett tillstånd, det förvalda. </para>
<para
>Komponenttexten för en filväljare är texten som finns i radeditorn (filen som valts av användaren). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="groupbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Gruppruta </term>
<listitem>
<para
>En omslutande grafisk komponent som innehåller andra komponenter. Ramen kan justeras med egenskapen lineWidth. En rubrik kan läggas till genom att ange rubrikegenskapen. </para>
<para
>Grupprutan har ett tillstånd, det förvalda. </para>
<para
>Komponenttexten för grupprutan är de kombinerade textassociationerna för var och en av komponenterna som den innehåller. De är i den ordningen de syns i grupprutan. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Radeditor </term>
<listitem>
<para
>En radeditorkomponent är enraders texteditor. Den låter användaren skriva in och ändra en enda textrad. Ursprunglig text för editorn kan anges med textegenskapen. Komponenten kan ställas in till enbart läsbar med egenskapen readOnly. Det finns tre lägen för komponenten, Normal, NoEcho och Password. Läget anges med egenskapen echoMode. </para>
<para
>Radeditorn har ett tillstånd, det förvalda. </para>
<para
>Komponenttexten för radeditorn är texten som finns i editorn. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Listruta </term>
<listitem>
<para
>En listruta tillhandahåller en lista med objekt som kan markeras. Normalt är ett eller inget element markerade. Beteendet kan ändras med egenskapen selectionMode. Objekt läggs till i listrutan genom att använda redigeringsfönstret. </para>
<para
>En listruta har bara ett tillstånd, det förvalda. </para>
<para
>Komponenttexten för en listruta är objekten som finns i listrutan. @selectedWidgetText returnerar bara de objekt som för närvarande är markerade. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Listvy </term>
<listitem>
<para
>Den här komponenten är nu aktiverad i &kommander;. Dess funktion är likadan som trädkomponenten, så titta där. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pixlabel.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Punktavbildningsetikett </term>
<listitem>
<para
>En enkel grafisk komponent som innehåller en bild eller text. Punktavbildningen som ska visas anges i egenskapen pixmap. Texten anges i textegenskapen. Bara en av dessa egenskaper kan anges samtidigt (Tror jag. Jag kan inte få editorn att ange båda samtidigt). Om scaledContents sätts till true, skalas bilden så att den motsvarar den grafiska komponentens storlek. Textformatet kan anges med egenskapen textFormat. </para>
<para
>Den här komponenten är inte aktiverad i &kommander; och har inga tillstånd och ingen komponenttext. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="radiobutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Tryckknapp </term>
<listitem>
<para
>En knapp som kan markeras eller avmarkeras, som oftast används i en knappgrupp för att göra ett alternativval. En rubrik som hör ihop med knappen kan anges i textegenskapen. En knapp kan initieras som markerad genom att sätta egenskapen checked till true. Om alla alternativknappar i en knappgrupp har egenskapen checked satt till true, är det den sista knappen som blir markerad. </para>
<para
>Alternativknappen har två tillstånd, markerad och omarkerad. </para>
<para
>Det finns inte någon komponenttext som hör till en alternativknapp. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="richtextedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Rik texteditor </term>
<listitem>
<para
>Den här grafiska komponenten tillhandahåller en texteditor som tillåter enkel textformatering. </para>
<para
>Rik texteditor har ett tillstånd, det förvalda. </para>
<para
>Komponenttexten för Rik texteditor är texten som finns i editorn med rik-textformat. Markerad text kan returneras med @selectedWidgetText. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Nummerinmatningsruta </term>
<listitem>
<para
>En komponent som låter användaren ändra ett heltalsvärde genom att antingen trycka på uppåt- och neråtpilar eller skriva in ett värde i rutan. Minimum- och maximumvärden kan ställas in med egenskaperna minValue och maxValue. Egenskapen specialValueText används för att ange ett textvärde som visas istället för minimumvärdet. </para>
<para
>Den här grafiska komponenten har bara ett tillstånd, det förvalda. </para>
<para
>Komponenttexten för nummerinmatningsrutan är heltalet som för närvarande visas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="frame.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Deldialogruta </term>
<listitem>
<para
>En knapp som kör en annat &kommander; dialogruta när den klickas. Dialogrutan som ska köras ställs in med egenskapen kmdrFile. Om egenskapen default sätts till true, körs dialogrutan om returtangenten trycks när dialogrutan har fokus. Jag tror att den också kan användas som omslutande grafisk komponent. Jag behöver leka lite till med det här. </para>
<para
>Deldialogrutan har ett tillstånd, det förvalda. </para>
<para
>Komponenttexten för deldialogrutan är textassociationen för dialogrutan den kör. </para>
<note
><para
>Det var meningen att den skulle innehålla dialogrutan, vilket avråds från med det nya projektbegreppet. Ska vi lämna den med <function
>@dialog()</function
> i sin &kommander; text, eller göra oss av med den? Det är inte riktigt som det är.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="tabwidget.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Flikkomponent </term>
<listitem>
<para
>En grafisk komponent som tillhandahåller flera flikar, där var och en kan innehålla andra grafiska komponenter. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="multilineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Texteditor </term>
<listitem>
<para
>En enkel flerraders texteditor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="label.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Textetikett </term>
<listitem>
<para
>En enkel komponent som innehåller ett textstycke. Komponenten låter dig också ange en punktavbildning. Men editorn säger att båda är QLabel. Varför har vi två grafiska komponenter som ser ut att vara samma sak, men med olika namn? Planlagt att fixas i alfa 7. </para>
<para
>Från alfa 6 är den här grafiska komponenten delvis aktiverad, och kan ställas in med externa DCOP-anrop. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> Trädkomponent </term>
<listitem>
<para
>En komponent som tillhandahåller en lista i form av en trädstruktur. Den här komponenten är nu helt aktiverad för att lägga till eller ta bort objekt från och med alfa 6. Man kan lägga till underobjekt och flerkolumnsdata. För att lägga till ett underobjekt använd <quote
>/</quote
> som avskiljare. För att lägga till kolumndata använd tabulatortecknet <quote
>\t</quote
> mellan kolumner. </para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
