<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kmyapplication "<application>KShutDown</application>">
<!ENTITY kappname "&kmyapplication;">
<!ENTITY package "kde-module">
<!ENTITY % addindex "IGNORE">
<!ENTITY % German "INCLUDE">
]>
<book lang="&language;">
<bookinfo>
<title>Das &kmyapplication; Handbuch</title>
<authorgroup>
<author>
<personname>
<firstname>Konrad</firstname>
<surname>Twardowski</surname>
</personname>
<email>kdtonline@poczta.onet.pl</email>
</author>
</authorgroup>
<copyright>
<year>2005</year>
<holder>Konrad Twardowski</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>
<date>2005-11-24</date>
<releaseinfo>1.08.00</releaseinfo><!-- sync. with KShutDown version -->
<abstract>
<para>&kmyapplication; ist ein Programm zum erweiterten Herunterfahren in &kde;.</para>
</abstract>
<keywordset>
<keyword>TDE</keyword>
<keyword>kshutdown</keyword>
<keyword>shutdown</keyword>
<keyword>shut</keyword>
<keyword>down</keyword>
<keyword>poweroff</keyword>
<keyword>reboot</keyword>
<keyword>lock</keyword>
<keyword>halt</keyword>
<keyword>exit</keyword>
<keyword>logout</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title>Einführung</title>
<para>&kmyapplication; ist ein Programm zum erweiterten Herunterfahren in &kde;.</para>
<para>
Fähigkeiten:
<itemizedlist>
<listitem><para>Computer abschalten (ausloggen und anhalten des Systems)</para></listitem>
<listitem><para>Computer Neustart (ausloggen und neu booten des Systems)</para></listitem>
<listitem><para>Sitzung sperren (sperrt den Bildschirm mit dem Bildschirmschoner)</para></listitem>
<listitem><para>Beendet aktive Sitzung (Beendet die aktive Sitzung in &kde; und loggt den Benutzer aus)</para></listitem>
<listitem><para>Extras (zusätzliche, Benutzereingaben)</para></listitem>
<listitem><para>Zeit und Verzögerungsoptionen</para></listitem>
<listitem><para><link linkend="command-line">Kommandozeilen-</link> und <link linkend="dcop">DCOP-</link> Unterstützung</para></listitem>
<listitem><para><link linkend="using-systray">System tray</link></para></listitem>
<listitem><para>Visuelle und Klangbenachrichtigungen</para></listitem>
<listitem><para><link linkend="kiosk">&kde; Kiosk Unterstützung</link></para></listitem>
</itemizedlist>
</para>
</chapter><!-- introduction -->
<chapter id="using-kapp">
<title>Benutzen von &kmyapplication;</title>
<sect1 id="using-mainwindow">
<title>Hauptfenster</title>
<itemizedlist>
<listitem><para>Benutzen Sie das erste Aufklappmenü um eine Aktion auszuwählen (Computer ausschalten, Extras, usw).</para></listitem>
<listitem><para>Benutzen Sie das zweite Aufklappmenü um die Verzögerung einzustellen (Keine, Zeit ab jetzt, usw).</para></listitem>
<listitem><para>Klicken Sie den <guibutton>Start</guibutton> Knopf um eine ausgewählte Aktion zu aktivieren. Die Aktion wird zur angegebenen Zeit gestartet.</para></listitem>
<listitem><para>Klicken Sie den <guibutton>Stop</guibutton> Knopf oder die <keycap>Esc</keycap> Taste um die Aktion zu stoppen.</para></listitem>
</itemizedlist>
<screenshot>
<screeninfo>&kmyapplication; Hauptfenster</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Hauptfenster</phrase>
</textobject>
</mediaobject>
</screenshot>
</sect1>
<sect1 id="using-systray">
<title>System Tray</title>
<itemizedlist>
<listitem><para>Linker Mausknopf - versteckt/zeigt Hauptfenster</para></listitem>
<listitem><para>Mittlerer Mausknopf - zeigt das Menü mit den Aktionen (Keine Verzögerung!)</para></listitem>
<listitem><para>Rechter Mausknopf - Zeigt das Kontextmenü</para></listitem>
</itemizedlist>
</sect1>
</chapter><!-- using-kapp -->
<chapter id="command-line">
<title>Kommandozeile</title>
<!-- copied from the kshutdown command line help -->
<programlisting>
Anmerkung: Die Optionen werden in Englisch angezeigt!
Auf der Kommandozeile kshutdown mit den gewünschten Optionen, ohne Klammern, angeben.
Benutzung: kshutdown [Qt-options] [TDE-options] [options] [time]
A Shut Down Utility for TDE
Generic options:
--help Show help about options Hilfe Optionen
--help-qt Show Qt specific options QT-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
</programlisting>
</chapter><!-- command-line -->
<chapter id="kiosk">
<title>Kiosk</title>
<para>
&kde; Kiosk erlaubt Ihnen die Kontrolle über sämtliche kritische Funktionen, wie zum Beispiel <guibutton>Computer Ausschalten</guibutton> oder <guibutton>Computer neu starten</guibutton>. Wollen Sie diese Restriktionen einschalten, können Sie eine globale Konfigurationsdatei namens <filename>kshutdownrc</filename> im allgemeinen &kde; Verzeichnis anlegen. Dieses liegt in (<filename>[prefix]/share/config</filename>).
</para>
<note>
<para>In den meisten Fällen müssen Sie &kmyapplication; neu starten damit die neuen Einstellungen übernommen werden.</para>
</note>
<note>
<para>Seit Version 0.3.1 Beta ist allen Schlüsseln eine "kshutdown_" Zeichenkette vorangestellt.</para>
</note>
<example>
<title>Beispiel kshutdownrc Datei mit den Einschränkungen</title>
<programlisting>
[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
</programlisting>
</example>
</chapter><!-- kiosk -->
<chapter id="dcop">
<title>DCOP API (KShutdownIface)</title>
<sect1 id="dcop-intro">
<title>Einführung</title>
<orderedlist>
<listitem><para>Achten Sie darauf das &kmyapplication; gestartet ist.</para></listitem>
<listitem><para>Tippen Sie <command>kshutdown --init</command> zum Starten von &kmyapplication; ohne Hauptfenster.</para></listitem>
<listitem><para>Zum Auflisten aller DCOP Functionen, tippen Sie <command>dcop kshutdown KShutdownIface</command>.</para></listitem>
<listitem><para>Mit <command>dcop kshutdown MMainWindow hide</command> verstecken Sie das Hauptfenster.</para></listitem>
<listitem><para>Mit <command>dcop kshutdown MMainWindow show</command> machen Sie das Hauptfenster wieder sichtbar.</para></listitem>
</orderedlist>
</sect1>
<sect1 id="dcop-func">
<title>Funktionen</title>
<sect2 id="dcop-func-cancel">
<title>ASYNC cancel()</title>
<para>Stoppt eine aktive Aktion.</para>
</sect2>
<sect2 id="dcop-func-shutdown">
<title>bool shutDown(), bool shutdown()</title>
<para>Fährt das System herunter.</para>
</sect2>
<sect2 id="dcop-func-reboot">
<title>bool reboot()</title>
<para>Startet den Rechner neu.</para>
</sect2>
<sect2 id="dcop-func-lock">
<title>bool lockScreen()</title>
<para>Sperrt den Bildschirm.</para>
</sect2>
<sect2 id="dcop-func-logout">
<title>bool logout()</title>
<para>Beendet die Sitzung und meldet den Benutzer ab.</para>
</sect2>
<sect2 id="dcop-func-config">
<title>ASYNC configure()</title>
<para>[Seit 0.6] Zeigt den Einstellungen Dialog.</para>
</sect2>
<sect2 id="dcop-func-status">
<title>QString getStatusInfo()</title>
<para>Zeigt &kmyapplication; Status Informationen.</para>
</sect2>
<sect2 id="dcop-func-makevisible">
<title>ASYNC makeVisible()</title>
<para>[Since 0.6] Macht das Hauptfenster auf der aktuellen Arbeitsfläche sichtbar.</para>
</sect2>
<sect2 id="dcop-func-test">
<title>ASYNC setTestMode(bool yes)</title>
<para>De-/aktiviert den Testmodus.</para>
<example>
<title>Aktiviert Testmodus</title>
<programlisting>dcop kshutdown KShutdownIface setTestMode true</programlisting>
</example>
<example>
<title>Deaktiviert Testmodus</title>
<programlisting>dcop kshutdown KShutdownIface setTestMode false</programlisting>
</example>
</sect2>
</sect1>
</chapter><!-- dcop -->
<chapter id="credits">
<title>Danksagung und Lizenz</title>
<para>&kmyapplication;</para>
<para>
Program Copyright 2005 Konrad Twardowski
<email>kdtonline@poczta.onet.pl</email>
</para>
<para>
Documentation Copyright © 2005 Konrad Twardowski
<email>kdtonline@poczta.onet.pl</email>
</para>
<para>Czech FAQ Copyright © Robert Kratky</para>
<para>Siehe <guimenuitem>Hilfe | Über &kmyapplication;</guimenuitem> für mehr Informationen.</para>
&underFDL;<!-- FDL: do not remove -->
&underGPL;<!-- GPL License -->
</chapter><!-- credits -->
&documentation.index;
</book>
