# Grafiska komponenter

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 textassociation. 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.

Huvuddialogrutan har två specialtillstånd för &kommander; text. De är Initialization 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 kapplöppningsproblem vid öppning, och betyder att du inte behöver några speciella procedurer vid stängning för att hantera underhåll.

I fallet när ett program baserat på ett huvudfönster (skapat med &Qt; Designer) används, finns det inte tillstånden Initialization och Destroy, instället kan signalerna initialize och destroy användas för att få information om när programmet skapas eller stängs.

Nedan är &kommander;s grafiska standardkomponenter. Var och en av dem har ett stort antal funktioner. Du kan ta reda på dem genom att titta på komponentfunktionerna i funktionsbläddraren. Många har dessutom signaler och slots. Dokumentation om dessa metoder finns i dokumentationen av programmeringsgränssnittet för &Qt; och &kde;. Varje &kommander;-komponent har en anmärkning om dess baskomponent.

Etikett

- En enkel grafisk komponent som innehåller en text. Komponenten låter dig också använda en punktavbildning.

  Se dokumentationen av QLabel för att ta reda på mer om textetiketter i &Qt;.

Punktavbildningsetikett

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

  Se dokumentationen av QLabel för att ta reda på mer om textetiketter i &Qt;.

Radeditor

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

  Radeditorn har ett tillstånd, det förvalda.

  Komponenttexten för radeditorn är texten som finns i editorn.

  Se dokumentationen av KLineEdit för att ta reda på mer om textetiketter i &kde;.

Texteditor

- En enkel flerraders texteditor.

  Se dokumentationen av KTextEdit för att ta reda på mer om flerraders texteditorer i &kde;.

Textbläddrare

- En enkel bläddrare för rik text med hyperlänknavigering.

  Se dokumentationen av KTextBrowser för att ta reda på mer om den.

Listruta

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

  En listruta har bara ett tillstånd, det förvalda.

  Komponenttexten för en listruta är objekten som finns i listrutan. @selectedWidgetText returnerar bara de objekt som för närvarande är markerade.

  Se dokumentationen av KListBox för att ta reda på mer om den.

Kombinationsruta

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

  En kombinationsruta har ett tillstånd, det förvalda.

  Komponenttexten för en kombinationsruta är texten i det valda objektet.

  Se dokumentationen av KComboBox för att ta reda på mer om den.

Trädkomponent

- En komponent som tillhandahåller en lista i form av en trädstruktur. Man kan lägga till underobjekt och flerkolumnsdata. Nuvarande begränsning är att man inte kan ändra kolumner. För att lägga till ett underobjekt använd / som avskiljare. För att lägga till kolumndata använd tabulatortecknet \t mellan kolumner.

  Se dokumentationen av KListView för att ta reda på mer om den.

Tabell

- En tabellkomponent som stöder olika grafiska komponenter i sina celler.

  Se dokumentationen av QTable för att ta reda på mer om den.

Körknapp

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

  Körknapp har ett tillstånd, det förvalda.

  Det finns inte någon komponenttext som hör till en körknapp.

  Se dokumentationen av KPushButton för att ta reda på mer om den.

Stängknapp

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

  En stängknapp har ett tillstånd, det förvalda.

  Det finns inte någon komponenttext som hör till en stängknapp.

  Se dokumentationen av KPushButton för att ta reda på mer om den.

Konsol

- En grafisk komponent som visar utmatningen från skript i en textbläddrare. Förvalt tillstånd körs, och utmatningen från dessa kommandon (interna och externa) visas i komponenten.

Filväljare

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

  Filväljaren har ett tillstånd, det förvalda.

  Komponenttexten för en filväljare är texten som finns i radeditorn (filen som valts av användaren).

Kryssruta

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

  En kryssruta har tre tillstånd, markerad, halvmarkerad och omarkerad.

  Komponenttexten för en kryssruta är värdet på egenskapen text.

  Se dokumentationen av KCheckBox för att ta reda på mer om den.

Tryckknapp

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

  Alternativknappen har två tillstånd, markerad och omarkerad.

  Det finns inte någon komponenttext som hör till en alternativknapp.

  Se dokumentationen av KRadioButton för att ta reda på mer om den.

Knappgrupp

- 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).

  Knappgrupp har ett tillstånd, det förvalda.

  Komponenttexten för en knappgrupp är texten som hör ihop med var och en av knapparna i den ordning de syns i knappgruppen.

Gruppruta

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

  Grupprutan har ett tillstånd, det förvalda.

  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.

Flikkomponent

- En grafisk komponent som tillhandahåller flera flikar, där var och en kan innehålla andra grafiska komponenter.

  Se dokumentationen av KTabWidget för att ta reda på mer om den.

Nummerinmatningsruta

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

  Den här grafiska komponenten har bara ett tillstånd, det förvalda.

  Komponenttexten för nummerinmatningsrutan är heltalet som för närvarande visas.

  Se dokumentationen av QSpinBox för att ta reda på mer om den.

Skjutreglage

- En grafisk komponent som tillhandahåller ett horisontellt eller vertikalt skjutreglage.

  Se dokumentationen av QSlider för att ta reda på mer om den.

Rik texteditor

- Den här grafiska komponenten tillhandahåller en texteditor som tillåter enkel textformatering.

  Rik texteditor har ett tillstånd, det förvalda.

  Komponenttexten för Rik texteditor är texten som finns i editorn med rik-textformat. Markerad text kan returneras med @selectedWidgetText.

Statusrad

- En grafisk komponent för att visa statusinformation, oftast använd längst ner i dialogrutor.

  Se dokumentationen av KStatusBar för att ta reda på mer om den.

Förloppsrad

- En grafisk komponent för att visa förloppsinformation.

  Se dokumentationen av KProgress för att ta reda på mer om den.

Skriptobjekt

- Detta är en pseudokomponent. Den visas inte när dialogrutan körs. Den kan betraktas som en funktion. Ett skriptobjekt innehåller kod som kan köras när som helst från dialogrutan genom att anropa funktionen execute. Argument kan skickas till skriptobjektet med metoden ovan och kommas åt inne i skriptobjektet som @Self.item(0), @Self.item(1), etc. med den gamla stilens tolk, eller Self.item(0, Self.item(1), etc. med den nya tolken.

  Signaler kan dessutom anslutas till funktionen execute, eftersom den också fungerar som en slot.

Tidtagare

- Detta är en pseudokomponent. Den visas inte när dialogrutan körs. Den kan användas för att utföra en åtgärd en gång efter en angiven tid, eller regelbundet. Ställ in tidsgränsen interval i millisekunder, välj om den ska köras en gång (singleShot) eller inte. Anslut signalen timeout till en slot, som kommer att köras när den angivna tiden har gått ut.

  Tidtagningen startas inte av sig själv. Kör funktionen execute för att starta den.

  Se dokumentationen av QTimer för att ta reda på mer om den.

Datumväljare

- En grafisk komponent använd för att välja ett datum. Förvalt datum kan ställas in med egenskapen date eller med funktionen setText med ISO-format: ÅÅÅÅ-MM-DD.

  Komponenttexten för är datumet som för närvarande visas.

  Se dokumentationen av KDatePicker för att ta reda på mer om den.

  Nytt i Kommander 1.3.

Om-dialogruta

- Detta är en pseudokomponent. Den visas inte när dialogrutan körs. Den lagrar information om programmet, upphovsmannen och licensen. Den visar om-dialogrutan när funktionen execute anropas.

  Funktionen initialize måste anropas innan någonting annat, inklusive funktionen execute.

  Nytt i Kommander 1.3.

Teckensnittsdialogruta

- En pseudokomponent som kan användas för att visa en dialogruta för att välja teckensnitt. Förvalt teckensnitt kan ställas in med funktionen setFont, och det valda teckensnittets egenskaper hämtas med funktionerna family, pointSize, bold, italic. Dialogrutan visas när funktionen execute anropas.

  Nytt i Kommander 1.3.

Sammanhangsberoende meny

- En pseudokomponent som kan användas för att visa en meny. Använd funktionerna insert... för att lägga till menyalternativ. Så fort användaren klickar på ett menyalternativ, körs funktionen execute i den angivna executeWidget. Det är möjligt att ansluta menyalternativ till den sammanhangsberoende menyns egen execute-funktion, vilket leder till att texten som är tilldelad tillståndet default körs. När menyalternativ läggs till kan du tilldela dem ett index, och hantera alla objekt i en meny i menykomponenten, eftersom en begäran skickar tillbaka detta index. För att se hur det fungerar, titta på det aktuella exemplet keyvaluecombo.kmdr.

  Använd popup för att visa menyn. Oftast ansluts den till signalen contextMenuRequested i en annan komponent.

  En meny kan innehålla andra sammanhangsberoende undermenyer.

  Nytt i Kommander 1.3.

Verktygslåda

- En omslutande komponent, liksom flikkomponenten. Den har flera sidor, där varje sida kan innehålla andra komponenter.

  Komponenten har ett fel i editorn, som inte påverkar dess användning vid körning, men påverkar dess användning i editorn. Om du försöker lägga till sidor i editorn blir den oläsbar. Gör inte det. Om du vill använda verktygslådan, fyll i komponenten i farten med kommandot `addWidget`. Om det finns tid, kommer ett exempel läggas till i utgåva 1.3, titta annars på webbplatsen.

  Se dokumentationen av QToolBox för att ta reda på mer om den.

  Nytt i Kommander 1.3.