# Das &kmyapplication; Handbuch

## Einführung

&kmyapplication; ist ein Programm zum erweiterten Herunterfahren in &kde;.

Fähigkeiten:

- Computer abschalten (ausloggen und anhalten des Systems)

- Computer Neustart (ausloggen und neu booten des Systems)

- Sitzung sperren (sperrt den Bildschirm mit dem Bildschirmschoner)

- Beendet aktive Sitzung (Beendet die aktive Sitzung in &kde; und loggt den Benutzer aus)

- Extras (zusätzliche, Benutzereingaben)

- Zeit und Verzögerungsoptionen

- Kommandozeilen- und DCOP- Unterstützung

- System tray

- Visuelle und Klangbenachrichtigungen

- &kde; Kiosk Unterstützung

## Benutzen von &kmyapplication;

### Hauptfenster

- Benutzen Sie das erste Aufklappmenü um eine Aktion auszuwählen (Computer ausschalten, Extras, usw).

- Benutzen Sie das zweite Aufklappmenü um die Verzögerung einzustellen (Keine, Zeit ab jetzt, usw).

- Klicken Sie den Start Knopf um eine ausgewählte Aktion zu aktivieren. Die Aktion wird zur angegebenen Zeit gestartet.

- Klicken Sie den Stop Knopf oder die Esc Taste um die Aktion zu stoppen.

&kmyapplication; Hauptfenster Hauptfenster

### System Tray

- Linker Mausknopf - versteckt/zeigt Hauptfenster

- Mittlerer Mausknopf - zeigt das Menü mit den Aktionen (Keine Verzögerung!)

- Rechter Mausknopf - Zeigt das Kontextmenü

## Kommandozeile

    Anmerkung: Die Optionen werden in Englisch angezeigt!
    Auf der Kommandozeile kshutdown mit den gewünschten Optionen, ohne Klammern, angeben.

    Benutzung: kshutdown [TQt-options] [TDE-options] [options] [time]

    A Shut Down Utility for TDE

    Generic options:
      --help                    Show help about options		Hilfe Optionen
      --help-tqt                Show TQt specific options		TQt-spezifische Optionen
      --help-kde                Show TDE specific options		TDE-spezifische Optionen
      --help-all                Show all options			Alle Optionen
      --author                  Show author information		Informationen über den Author
      -v, --version             Show version information		Versionsinformationen
      --license                 Show license information		Lizenzinformationen
      --                        End of options			Ende der Optionen

    Options:
      -s, --shutdown            Turn off computer			Computer abschalten
      -h, --halt                Turn off computer			    "       "
      -r, --reboot              Restart computer			Computer neu starten
      -k, --lock                Lock session			Sitzung sperren
      -l, --logout              End current session			Sitzung beenden
      --confirm                 Confirm command line action		Bestätigung für Kommandozeilen Aktionen
      --standard                Show standard logout dialog		Zeigt Standard Abmelden Dialog
      -c, --cancel              Cancel an active action		Bricht eine aktive Aktion ab
      --init                    Don't show window at startup	Zeigt kein Fenster beim Start
      --test                    Enable test mode			Aktiviert Testmodus
      --default                 Disable test mode			Deaktiviert Testmodus

    Arguments:
      time                      Time; Examples: 01:30 - absolute time (HH:MM); 10 - number of minutes to wait from now

## Kiosk

&kde; Kiosk erlaubt Ihnen die Kontrolle über sämtliche kritische Funktionen, wie zum Beispiel Computer Ausschalten oder Computer neu starten. Wollen Sie diese Restriktionen einschalten, können Sie eine globale Konfigurationsdatei namens `kshutdownrc` im allgemeinen &kde; Verzeichnis anlegen. Dieses liegt in (`[prefix]/share/config`).

In den meisten Fällen müssen Sie &kmyapplication; neu starten damit die neuen Einstellungen übernommen werden.

Seit Version 0.3.1 Beta ist allen Schlüsseln eine "kshutdown_" Zeichenkette vorangestellt.

### Beispiel kshutdownrc Datei mit den Einschränkungen

    [TDE Aktionseinschränkungen][$i]
    # [$i] - Benutzer kann Gruppe nicht Überschreiben
    # false - Feature deaktiviert
    # true - Feature aktiviert
    # Standard ist angeschaltet
    Mit "false" verbieten, mit "true" erlauben.

    # Deaktiviert die Aktion "Computer ausschalten"
    kshutdown_action_shutdown=false
    # kshutdown_action_shutdown=true <- "true" aktiviert diese Aktion

    # Computer neu starten
    kshutdown_action_reboot=true

    # Bilschirm sperren
    kshutdown_action_lockscreen=true

    # Sitzung beenden
    kshutdown_action_logout=true

    # "Extras" Aktionen
    kshutdown_action_extras=true

    # Deaktiviert die Aktionen Seite in den Einstellungen
    kshutdown_settings_actions=true

    # Deaktiviert "Zeit auswählen" Aufklappmenü und das Kommandozeilenargument dazu
    # and the command line "time" argument
    kshutdown_tab_time=true

    # Deaktiviert den Statistik Dialog
    kshutdown_tab_stats=true

## DCOP API (KShutdownIface)

### Einführung

1. Achten Sie darauf das &kmyapplication; gestartet ist.

2. Tippen Sie `kshutdown --init` zum Starten von &kmyapplication; ohne Hauptfenster.

3. Zum Auflisten aller DCOP Functionen, tippen Sie `dcop kshutdown KShutdownIface`.

4. Mit `dcop kshutdown MMainWindow hide` verstecken Sie das Hauptfenster.

5. Mit `dcop kshutdown MMainWindow show` machen Sie das Hauptfenster wieder sichtbar.

### Funktionen

#### ASYNC cancel()

Stoppt eine aktive Aktion.

#### bool shutDown(), bool shutdown()

Fährt das System herunter.

#### bool reboot()

Startet den Rechner neu.

#### bool lockScreen()

Sperrt den Bildschirm.

#### bool logout()

Beendet die Sitzung und meldet den Benutzer ab.

#### ASYNC configure()

[Seit 0.6] Zeigt den Einstellungen Dialog.

#### TQString getStatusInfo()

Zeigt &kmyapplication; Status Informationen.

#### ASYNC makeVisible()

[Since 0.6] Macht das Hauptfenster auf der aktuellen Arbeitsfläche sichtbar.

#### ASYNC setTestMode(bool yes)

De-/aktiviert den Testmodus.

##### Aktiviert Testmodus

    dcop kshutdown KShutdownIface setTestMode true

##### Deaktiviert Testmodus

    dcop kshutdown KShutdownIface setTestMode false

## Danksagung und Lizenz

&kmyapplication;

Program Copyright 2005 Konrad Twardowski kdtonline@poczta.onet.pl

Documentation Copyright © 2005 Konrad Twardowski kdtonline@poczta.onet.pl

Czech FAQ Copyright © Robert Kratky

Siehe Hilfe | Über &kmyapplication; für mehr Informationen.

&underFDL; &underGPL;
&documentation.index;