# Het handboek van &karm;

Jonathan
Singer

    jsinger@leeta.net

Mark
Bucciarelli

    mark@hubcapconsulting.com

Sirtaj
Singh
Kang

    taj@kde.org

Lauri
Watts
Nalezer

    lauri@kde.org

&Tom.Albers;&Sander.Koning;
2000-2004
Jonathan Singer
2004-2005
Mark Bucciarelli
&FDLNotice;
2005-02-02
1.5.0

&karm; houdt de tijd bij die besteed wordt aan verschillende taken.

KDE
karm
kdeutils
tijd
bijhouder
project

## Voorwoord

&karm; houdt de tijd bij die besteed wordt aan verschillende taken. Het is nuttig om de tijd bij te houden van taken die bijvoorbeeld aan klanten gefactureerd moet worden en kan de bestede tijd per taak en dag rapporteren.

Deze tijdsgeschiedenis kan naar een komma-gescheiden tekstbestand uitgevoerd worden om dit in andere facturerings- of projectbeheer-hulpmiddelen in te lezen.

&karm; detecteerd wanneer uw toetsenbord en muis ongebruikt zijn en kan verschillende taken aan diverse bureaubladen koppelen, twee hulpmiddelen die kunnen helpen bij het correct bijhouden van de taken.

&karm; is in eerste instantie geschreven door Sirtaj Singh Kang. Het woord karm betekent werk of daden in het Punjaabs, de moedertaal van de auteur, en is hetzelfde woord (maar een betere transcriptie) als karma.

## &karm; gebruiken

### &karm; starten

Tik `karm` in op de commandoregel of kies Tijdsregistratie uit de groep Hulpmiddelen van het KDE start menu. De standaard &Qt; en &kde; parameters zijn beschikbaar. Een overzicht van beschikbare parameters kan verkregen worden door ``karm` `--help`` op de commandoregel.

&karm; biedt een additionele opdrachtoptie waarmee u de naam van het iCalendar-bestand kunt opgeven dat gebruikt wordt om uw werkgeschiedenis in op te slaan. U kunt een extern iCalendar-bestand opgeven door "http" of "ftp" als deel van de bestandsnaam te gebruiken, bijvoorbeeld http://www.mijnsite.com/mijndata/mijnwerk.ics

### Taken

Probleem: U bent een softwareconsultant met veel klanten. Sommige klanten hebben meerdere projecten. Gedurende een dag schakelt u heen en weer tussen de verschillende projecten. U moet uw tijd bijhouden om maandelijkse rekeningen te kunnen maken.

Probleem: Maak een topniveau-taak voor elke klant en een subtaak voor elk project. Voor projecten die gedetailleerder bijgehouden moeten worden, maakt u een lijst van project-subtaken. U houdt de tijd bij door te dubbelklikken op de taak waar u op het moment aan werkt.

&karm; biedt grote flexibiliteit in het bijhouden van uw tijd door een ongelimiteerd aantal taken en taakdiepten. Tijd kan bij elke taak worden bijgehouden en meer dan één taak kan tegelijk actief zijn.

Om een topniveau-taak aan te maken kiest u &Ctrl;N Taak Nieuw Om een subtaak aan te maken kiest u de bovenliggende taak en kiest u &Ctrl;&Alt;N Taak Nieuwe subtaak

Als &karm; afsluit wordt de takenlijst opgeslagen in het bestand dat opgegeven is in Instellingen KArm instellen . Bij de volgende start wordt de takenlijst uit hetzelfde bestand geladen.

&karm; kan taken importeren en exporteren om uw werk te minimaliseren. Zie Andere systemen.

### Timers

Probleem: Om al uw uitgaven te kunnen doen, moet u een gemiddelde van vijf uur per dag factureren. Om ervoor te zorgen dat u dit haalt, houdt u uw dag- en weektotalen in de gaten.

Oplossing: Reset de sessie-timer aan het begin van elke werkdag en reset alle timers aan het begin van elke week.

&karm; maakt het bijhouden van tijd eenvoudig. Om tijd van een taak bij te houden dubbelklikt u op de taak. Om het bijhouden te stoppen, dubbelklikt u opnieuw op de taak. Actieve taken worden aangegeven door een klokje in de kolom Sessietijd.

Een andere visuele aanwijzing van activiteit is het systeemvakpictogram van &karm;. Als er een taak actief is, beweegt de secondewijzer in het pictogram. Als u de muispijl op dit pictogram laat rusten, wordt de naam van de actieve taak in een hulpballon weergegeven. Als er meer dan één taak actief is, worden de taaknamen in de hulpballon gescheiden door komma's.

&karm; houdt twee timers bij voor elke taak: één voor de sessietijd en één voor de totale tijd. In de standaardinstelling geeft &karm; twee kolommen voor elke timer weer, hetgeen op vier kolommen voor elke taak uitkomt:

Sessietijd

  De tijd die aan de taak werd besteed sinds het begin van de sessie.

Totale sessietijd

  De tijd die aan de taak en alle subtaken ervan besteed is sinds het begin van de sessie.

Tijd

  De tijd die aan de taak is besteed sinds alle tijden gereset zijn.

Totale tijd

  De tijd die aan de taak en alle subtaken ervan is besteed sinds alle tijden zijn gereset.

Om een nieuwe sessie te starten, kiest u Bestand Nieuwe sessie starten .

Om alle tijden te resetten, kiest u Bestand Alle tijden resetten .

#### Bureaubladen volgen

Probleem: U hebt twee hoofdprojecten waartussen u elke dag schakelt. Om uw werk te organiseren houdt u de bestanden van project 1 op bureaublad 1 en die van project 2 op bureaublad 2.

Oplossing: Verbind de taak van project 1 met bureaublad 1 en de taak van project 2 met bureaublad 2. Als u van bureaublad 2 naar bureaublad 1 overschakelt, stopt &karm; automatisch de taak van project 2 en start de taak van project 1.d

Om een taak met één of meer bureaubladen te verbinden, kiest u &Ctrl;E Taak Bewerken . Schakel Automatisch volgen in en kies de bureaubladen waar u de taak aan wilt verbinden. Als één van de gekozen bureaubladen actief wordt, begint &karm; na korte tijd automatisch de tijd voor die taak bij te houden.

#### Inactiviteitsdetectie

Probleem: U gaat vroeg van uw werk weg op vrijdag om een bericht te bezorgen en vergeet de timer stop te zetten. Als u terugkomt op maandag loopt de timer nog steeds.

Oplossing: Schakel inactiviteitsdetectie in.

&karm; kan ingesteld worden om inactiviteit van muis en toetsenbord te detecteren. Als de muis en het toetsenbord langer dan de ingestelde tijd inactief zijn, toont &karm; het volgende dialoogvenster:

Inactiviteitsdetectie van &karm;
Het dialoogvenster Inactiviteitsdetectie van &karm;

Terugdraaien & stoppen

  Trek de hoeveelheid inactieve tijd van alle actieve timers af en stop deze.

  U was niet aan de taken aan het werken toen uw computer inactief was en u bent nog steeds niet aan het werk.

Terugdraaien & doorgaan

  Trek de hoeveelheid inactieve tijd van alle actieve timers af maar laat ze wel lopen.

  U was niet aan het werk toen uw computer inactief was, maar bent nu wel aan het werk.

Doorgaan met tijd opnemen

  Pas de inactieve tijd toe op alle actieve timers en laat ze lopen.

  U was aan de taken aan het werk toen uw computer inactief was en bent nog steeds aan het werk.

### Rapportage

&karm; biedt drie manieren om de bijgehouden tijd te rapporteren. U kunt de sessie- en tijdstotalen naar de printer sturen, de tijdstotalen naar het klembord kopiëren, of de tijdsgeschiedenis naar het klembord kopiëren.

#### Totalen afdrukken

Om het totalenrapport voor de printer te genereren, kiest u &Ctrl;P Bestand Afdrukken . Dit genereert een rapport met drie kolommen voor de complete takenlijst. De eerste kolom is de taaknaam, de tweede kolom is de Totale sessietijd en de derde kolom is de Totale tijd.

#### Totalen op klembord

Om het totalenrapport naar het klembord te kopiëren, kiest u &Ctrl;C Bestand Totalen kopiëren naar klembord .

Dit rapport wordt gegenereerd voor de huidige taak en alle subtaken ervan. Als de huidige taak een topniveau-taak is, vraagt &karm; u of u het rapport voor de huidige taak en subtaken wilt genereren, of voor de hele takenlijst.

&karm; Kopieer deze taak
Het dialoogvenster "Kopieer deze taak" in &karm;

Als het rapport gegenereerd is, opent u KEdit of een andere editor en plakt u de rapportdata.

    Taaktotaal
    2004-07-10 02:26

      Tijd    Taak
    ----------------------------------------------
      9:14    kde
       9:14    karm
        1:08    bugs
        0:00    wijzigingen
       0:00    promo
       0:00    web zaken
    ----------------------------------------------
      9:14 Totaal

De eerste kolom is de Totale tijd en is ingesprongen (net als de taaknamen) om taak-/subtaak-relaties aan te geven. De gerapporteerde tijden zijn includief subtaaktijden.

#### Geschiedenis op klembord

Om het totalenrapport op het klembord te plaatsen, kiest u &Ctrl;R Bestand Geschiedenis kopiëren naar klembord .

U dient de optie Loggeschiedenis in Instellingen KArm instellen in te schakelen. Anders houdt &karm; alleen totalen bij en niet de gedetailleerde taakgeschiedenis.

Dit rapport wordt voor de huidige taak en subtaken gegenereerd. In tegenstelling tot het totalenrapport kunt u bij dit rapport niet de hele takenlijst laten rapporteren. U kunt alleen rapporteren op de huidige taak en subtaken.

Als u het geschiedenisrapport kiest, vraagt &karm; u eerst om de datumbereik voor het rapport in te voeren.

&karm; Datumbereik
&karm; Datumbereik invoeren

Na het invoeren van een datumbereik opent u KEdit of een andere editor en plakt u daar de rapportdata.

    Taakgeschiedenis
    Van donderdag 01 juli 2004 tot maandag 12 juli 2004
    Afgedrukt op: 2004-07-12 17:18

                                   Week van maandag 05 juli 2004
         5     6     7     8     9    10    11
    -------------------------------------------------------------------------
                                                 0:00 kde
                                                 0:00  dc
                  1:22  1:46  3:14  1:44         8:06  karm
                                                 0:00   3.2 planning
                  1:08                           1:08   bugs
                                                 0:00   wijzigingen
                                                 0:00  promo
                                                 0:00  web-dingen
    -------------------------------------------------------------------------
                  2:30  1:46  3:14  1:44         9:14 Totaal

De taakgeschiedenis wordt opgeteld voor elke dag en taak, gegroepeerd per week. De eerste zeven kolommen zijn maandag tot en met zondag. De achtste kolom is het weektotaal en de negende kolom is de taaknaam. De taaknamen worden ingesprongen om de taak-/subtaak-relaties aan te geven.

### Andere systemen

#### KOrganizer

&karm; gebruikt net als KOrganizer en Apple's iCal de industriestandaard iCalendar als formaat voor gegevens. &karm; kan takenlijsten van deze twee toepassingen lezen en schrijven.

Als zowel &karm; als KOrganizer hetzelfde bestand geopend hebben, riskeert u gegevensverlies als u het bestand met KOrganizer bewerkt. Bewerk voor de veiligheid het bestand slechts met één applicatie tegelijk.

#### Planner

Als een typisch voorbeeld wilt u wellicht een project plannen met het projectbeheergereedschap Imendio Planner (van planner.imendio.org) en de taken daaruit importeren in &karm;, om ze in het industrie-standaardformaat iCalendar te hebben. Als u dat gedaan hebt kunt u de taken in KOrganizer inroosteren en de tijd die u eraan besteed hebt in &karm; bijhouden. Dat is één manier om ervoor te zorgen dat uw project op tijd en binnen budget afkomt.

#### &DCOP;

&DCOP; is het mechanisme waarmee KDE-programma's met elkaar communiceren. Een KDE-programma biedt een lijst van functies die andere programma's (zoals een Bash-script) kunnen gebruiken.

##### Bash-script dat de versie van &karm; weergeeft

    DCOPID=`dcop | grep karm`
            if [ $DCOPID ]
            then
                    VERS=`dcop $DCOPID KarmDCOPIface version`
                    echo "&karm; versie is $VERS"
            else
                    echo "&karm; niet actief"
            fi

&karm;'s huidige &DCOP;-interface wordt momenteel vooral gebruikt voor geautomatiseerd testen en is dus erg beperkt. Zie voor de volledige interfacedefinitie &DCOP;-interface appendix.

Om de volledige &DCOP;-interface te zien van de &karm;-versie die op uw systeem staat, voert u het volgende Bash-script uit:

##### &karm;'s &DCOP;-interface op het scherm weergeven

    DCOPID=`dcop | grep karm`
            if [ $DCOPID ]
            then
                    dcop $DCOPID KarmDCOPIface
            else
                    echo "&karm; niet actief"
            fi

#### Totalen exporteren naar CSV

&karm; kan zowel totalen als geschiedenis naar een komma-gescheiden bestand exporteren. Om totalen te exporteren, kiest u Bestand Importeren/Exporteren Exporteren naar CSV-bestand en &karm; toont het volgende dialoogvenster:

&karm; CSV-exportdialoogvenster
&karm; CSV-exportdialoogvenster

Voer het bestand in waarnaar u de data wilt exporteren, en wijzig de andere instellingen indien nodig. Merk op dat het datumbereik niet ingesteld kan worden aangezien u de totalen exporteert, niet de geschiedenis. Klik Exporteren en &karm; exporteert de totalen voor alle taken naar het gekozen bestand.

Hier is een voorbeeld van het uitvoerformaat:

    "kde",,,,,0.00,0.00,6.88,9.83
    ,"karm",,,,6.88,8.70,6.88,9.83
    ,,"3.2 plan",,,0.00,0.00,0.00,0.00
    ,,"bugs",,,0.00,1.13,0.00,1.13
    ,,"wijzigingen - vertalingen",,,0.00,0.00,0.00,0.00
    ,,"tijdrapport",,,0.00,0.00,0.00,0.00
    ,"kopete",,,,0.00,0.00,0.00,0.00
    ,"promo",,,,0.00,0.00,0.00,0.00
    ,"web-dingen",,,,0.00,0.00,0.00,0.00

Topniveau-taken staan in de eerste kolom, subtaken in de tweede, en zo door. De tijdsdata wordt uitgevoerd na de maximale taakdiepte (vijf in dit voorbeeld). De eerste tijdskolom is Sessietijd, de tweede Tijd, de derde Totale sessietijd en de vierde de Totale tijd.

#### Geschiedenis naar CSV exporteren

Om taakgeschiedenis te exporteren, kiest u Bestand Importeren/exporteren Geschiedenis naar CSV-bestand exporteren... en &karm; toont hetzelfde exporteerdialoogvenster als hierboven.

Voer het bestand in waarnaar u de data wilt exporteren, en kies een datumbereik waarvan u de taakgeschiedenis wilt. Wijzig de andere instellingen indien nodig. Klik Exporteren en &karm; exporteert de taakgeschiedenis voor alle taken naar het gekozen bestand.

Hier is een voorbeeld van het uitvoerformaat:

    Taakgeschiedenis
    Van dinsdag 06 juli 2004 tot dinsdag 13 juli 2004
    Afgedrukt op: 2004-07-13 18:10
    2004-07-06,2004-07-07,2004-07-08,2004-07-09,2004-07-10,2004-07-11,2004-07-12,2004-07-13,
    ,,,,,,,,0.00,"kde"
    ,,1.77,3.23,1.73,,1.37,0.82,8.95,,"karm"
    ,,,,,,,,0.00,,,"3.2 plan"
    ,1.13,,,,,,,1.13,,,"bugs"
    ,,,,,,,,0.00,,,"wijzigingen - vertalingen"
    ,,,,,,,,0.00,,,"tijdrapportt"
    ,,,,,,,,0.00,,"kopete"
    ,,,,,,,,0.00,,"promo"
    ,,,,,,,,0.00,,"web-dingen"

De eerste drie regels geven aan wanneer het rapport gegenereerd is en voor welk datumbereik. De vierde regel is een komma-gescheiden lijst met de datums in het bereik in ISO 8601 formaat (jjjj-mm-dd). Alle volgende rijen geven de tijd weer die per taak gelogd is. De laatste numerieke kolom is het rijtotaal over alle dagen. De taaknaam wordt afgedrukt na de totaalkolom en is ingesprongen om taak-/subtaakrelaties aan te geven. Namen van topniveau taken verschijnen in de eerste kolom na het totaal.

## Het uiterlijk van &karm;

Het hoofdvenster van &karm; bestaat uit de volgende onderdelen: menubalk, werkbalk, taak- en tijdvak en een statusbalk.

&karm; scherm
&karm; scherm

### Het taak- en tijdvak

De verschillende taken worden in dit vak weergegeven, tesamen met de tijd die aan deze taak is besteed. Zowel de tijd van de sessie als de totaal besteedde tijd. Taken die op dit moment gestart zijn hebben een kleine klok bij de sessietijd staan.

Voor iedere taak kunnen er subtaken gecreërd worden. Door het plus- en minteken voor de hoofdtaak kan de weergave van de subtaken aan- en uitgezet worden. De totale tijd van een hoofdtaak is de tijd van de taak zelf en van de subtaken tesamen.

### De menubalk van &karm;

#### Het menu Bestand

&Ctrl;S Bestand Opslaan

  Bewaart de huidige taken en subtaken, met de bijbehorende tijden

&Ctrl;P Bestand Afdrukken

  Drukt het &karm;-scherm af

Bestand Nieuwe sessie starten

  Zet alle sessietijden op nul

Bestand Alle tijden resetten

  Zet alle tijden op nul

Bestand Importeren/exporteren Oud "plat" bestand importeren...

  Importeert bestanden in het oude &karm;-formaat (&karm; slaat nu in het iCalendar-formaat op).

Bestand Importeren/exporteren Taken uit planner importeren...

  Importeer een imendio planner-project (zie planner.imendio.org). Alle taken, subtaken en de vlag "voltooid" worden geïmporteerd uit een .planner-bestand. U kunt ze importeren als een subtaak door een subtaak te creëren, deze geselecteerd te laten en dan te importeren.

Bestand Importeren/exporteren Naar CSV-bestand exporteren...

  Exporteer Totale sessietijd, Sessietijd, Tijd en Totale tijd naar een tekstbestand.

Bestand Importeren/exporteren Geschiedenis naar CSV-bestand exporteren...

  Exporteer taakgeschiedenis naar een tekstbestand.

&Ctrl;C Bestand Totalen kopiëren naar klembord

  Kopieert de huidige totaaltijd van de taak of alle taken naar het &kde;-klembord

&Ctrl;&Alt;C Bestand Geschiedenis kopiëren naar klembord

  Kopieert de dagelijkse sessietijden voor een gegeven periode naar het &kde;-klembord

&Ctrl;Q Bestand Afsluiten

  Sluit &karm; af

#### Het menu Klok

S Klok Starten

  Start het bijhouden van de tijd voor de geselecteerde taak

Klok Stoppen

  Stopt het bijhouden van de tijd voor de geselecteerde taak

&Esc; Klok Alle tijden stoppen

  Stopt het bijhouden van de tijd voor alle taken

#### Het menu Taak

&Ctrl;N Taak Nieuw

  Voegt een nieuwe taak toe

&Ctrl;&Alt;N Taak Nieuwe Subtaak

  Voegt een nieuwe subtaak toe

Del Taak Verwijderen

  Verwijdert de geselecteerde taak of subtaak

&Ctrl;E Taak Wijzigen

  Wijzigt de naam of de tijden van de huidige taak

  Er zijn twee manieren waarop de tijden gewijzigd kunnen worden. Door de absolute tijd te bewerken kan de tijd en de sessietijd onafhankelijk van elkaar bewerkt worden. Bij de relatieve tijd bewerken is het mogelijk tijd bij de huidige sessie en totaaltijd op te tellen of af te halen.

  Het Automatisch volgen aankruisvak maakt het mogelijk om de klok automatisch te starten en te stoppen wanneer naar een bepaalde &kde;-desktop geschakeld wordt.

#### Het menu Instellingen

Instellingen Sneltoetsen instellen...

  Opent een venster waarin het mogelijk is om de sneltoetsen aan te passen

Instellingen KArm instellen...

  Opent een venster waarmee het mogelijk is &karm; in te stellen

  Het venster bevat drie tabbladen. Bij Gedrag kunt u een waarschuwing voor inactiviteit opgeven en een waarschuwing voor het verwijderen van een verzameling taken, bij Weergave kunt u aangeven welke kolommen er getoond worden in het hoofdvenster, en Opslag geeft aan waar de gegevens moeten wordenopgeslagen, of de gegevens automatisch moeten worden opgeslagen en hoe vaak.

#### Het menu Help

&help.menu.documentation;

### De werkbalk

De werkbalk bevat pictogrammen voor de volgende acties:

(De functionaliteit is overigens identiek aan de opties uit het menu)

- Starten

- Stoppen

- Nieuwe taak

- Nieuwe subtaak

- Verwijderen

- Wijzigen

### De statusbalk

Laat de totaal verstreken tijd in de huidige sessie zien.

## Dankbetuigingen en licentie

&karm;

Programma copyright:

- 1997-2000 Sirtaj Singh Kang taj@kde.org.

- 2001-2002 Tomas Pospisek tpo_deb@sourcepole.ch

- 2003-2004 Mark Bucciarellimark@hubcapconsulting.com

Bijdragen door (in alfabetische volgorde)

- Allen Winter winterz@verizon.net

- David Faure faure@kde.org

- Espen Sand espen@kde.org

- Gioele Barabucci gioele@gioelebarabucci.com

- Jan Schaumann jschauma@netmeister.org

- Jesper Pedersen blackie@ifad.dk

- Kalle Dalheimer kalle@kde.org

- Klarälvdalens Datakonsult AB

- Mark Bucciarelli mark@hubcapconsulting.com

- Thorsten Stärk dev@staerk.de

- Tomas Pospisek tpo_deb@sourcepole.ch

- Willi Richert w.richert@cox.net

De auteur van &karm; is geinspireerd door de applicatie titrax van Harald Tveit Alvestrand. Het nadeel van die applicatie is echter dat het gebaseerd is op de Xt-toolkit.

Documentatie copyright 2000-2004 Jonathan Singer jsinger@leeta.net en Sirtaj Singh Kang taj@kde.org.

&underFDL; &underGPL;
actieve taak

  Een taak waarvan een timer loopt.

&DCOP;

  Het communicatieprotocol dat tussen KDE-processen gebruikt worden. Kort voor Desktop COmmunication Protocol.

bureaublad

  GNU/Linux, FreeBSD en andere systemen die X Windows draaien hebben meerdere bureaubladen. U hebt normaal gesproken vier verschillende bureaubladen. Elk bureaublad kan een eigen verzameling programma's en bestanden weergeven. Als KDE opstart ziet u bureaublad 1. Als u &Alt;F2 drukt, ziet u bureaublad 2. Met &Alt;F1 brengt u bureaublad 1 terug.

geschiedenis

  Als &karm; ingesteld is om geschiedenis te loggen, wordt elke start- of stopgebeurtenis onthouden. Deze geschiedenis wordt niet geschoond als de tijden worden gereset en wordt onthouden totdat de taak wordt verwijderd.

sessie

  Een gebruikergedefinieerd beginpunt voor de sessietimers. Een nieuwe sessie begint als u Bestand Nieuwe sessie starten kiest. Sessiedata wordt niet opgeslagen als u een nieuwe sessie start.

Sessietijd

  De tijd die aan de taak werd besteed sinds het begin van de sessie.

systeemvak

  Het systeemvak bevindt zich in de balk die standaard onderaan uw scherm verschijnt. In dit systeemvak is het &karm;-pictogram hetgene helemaal rechts.

topniveau-taak

  Een taak met geen bovenliggende taken.

Totale sessietijd

  De tijd die aan de taak en alle subtaken ervan besteed is sinds het begin van de sessie.

Tijd

  De tijd die aan de taak is besteed sinds alle tijden gereset zijn.

Totale tijd

  De tijd die aan de taak en alle subtaken ervan is besteed sinds alle tijden zijn gereset.

## Installatie

### &karm; verkrijgen

&install.intro.documentation; &install.compile.documentation;

## &DCOP;-interface

version

### version

Retourneer de versie van &karm;

    QString version()

#### Beschrijving

`version()` is een &DCOP;-aanroep die &karm;'s versienummer retourneert; bijvoorbeeld 1.5.0. Het versienummer wordt geretourneerd als een tekenreeks in het standaard GNU-formaat hoofdversie.subversie.bugfix.

quit

### quit

Retourneer &karm;'s afsluiting.

    QString quit()

#### Beschrijving

`quit()` is een &DCOP;-aanroep die een manier biedt waarmee een extern programma &karm; beschaafd kan afsluiten.

hastodo

### hastodo

Controleer of topniveau taak bestaat.

    QString hastodo(QString taskname)

#### Parameters

`taskname`

  De naam van de taak waarnaar gekeken moet worden.

#### Beschrijving

`hastodo(QString taskname)` is een &DCOP;-aanroep die een gegeven naam opzoekt. Als deze gevonden wordt, wordt de bijbehorende iCalendar-UID van de taak geretourneerd. Als deze niet gevonden wordt, wordt de lege tekenreeks geretourneerd.

Het iCalendar-bestand dat &karm; momenteel open heeft is het bestand dat doorzocht wordt. Alle taakbomen worden doorzocht, niet alleen topniveau taken. Als meer dan één taak een overeenkomende naam heeft, wordt de eerste geretourneerd.

addtodo

### addtodo

Een nieuwe taak toevoegen.

    QString addtodo(QString todoname)

#### Parameters

`todoname`

  De naam van de nieuwe taak.

#### Beschrijving

`addtodo(QString todoname)` is een &DCOP;-aanroep die een nieuwe topniveau taak aan het huidige bestand toevoegt. De UID van de nieuwe taak wordt geretourneerd.

&documentation.index;