<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&ksnapshot;">
  <!ENTITY package "kdegraphics">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Dutch "INCLUDE"
> <!-- change language only here -->
]>

<book id="ksnapshot" lang="&language;">

<bookinfo>
<title
>Het handboek van &ksnapshot;</title>

<authorgroup>
<author
><firstname
>Richard</firstname
> <othername
>J.</othername
> <surname
>Moore</surname
> <affiliation
> <address
>&Richard.J.Moore.mail;</address>
</affiliation>
</author>

<author
><firstname
>Robert</firstname
> <othername
>L.</othername
> <surname
>McCormick</surname
> <affiliation
> <address
>&Robert.L.McCormick.mail;</address>
</affiliation>
</author>

<author
><firstname
>Brad</firstname
> <surname
>Hards</surname
> <affiliation
> <address
>&Brad.Hards.mail;</address>
</affiliation>
</author>

<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
> <address
>&Lauri.Watts.mail;</address>
</affiliation>
<contrib
>Nalezer</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Richard</firstname
> <othername
>J</othername
> <surname
>Moore</surname
> <affiliation
> <address
>&Richard.J.Moore.mail;</address>
</affiliation>
<contrib
>Ontwikkelaar</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Matthias</firstname
> <surname
>Ettrich</surname
> <affiliation
> <address
>&Matthias.Ettrich.mail;</address>
</affiliation>
<contrib
>Ontwikkelaar</contrib>
</othercredit>

&Niels.Reedijk;&Sander.Koning; 
</authorgroup>

<copyright>
<year
>1997-2000</year>
<holder
>&Richard.J.Moore;</holder>
</copyright>

<copyright>
<year
>2000</year>
<holder
>&Matthias.Ettrich;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2013-05-22</date>
<releaseinfo
>0.8.2 (&kde; 4.11)</releaseinfo>

<abstract>
<para
>&ksnapshot; is een eenvoudig toepassing voor het maken van schermafdrukken. Het kan afbeeldingen van het gehele bureaublad, een enkel venster, een sectie van een venster, een geselecteerd rechthoekig of vrij gekozen gebied maken. De afbeeldingen kunnen dan in een aantal formaten worden opgeslagen.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KSnapshot</keyword>
<keyword
>kdegraphics</keyword>
<keyword
>schermafdruk</keyword>
<keyword
>schermafbeelding</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Inleiding</title>

<para
>&ksnapshot; is een eenvoudig toepassing voor het maken van schermafdrukken. Het kan afbeeldingen van het gehele bureaublad, een enkel venster, een sectie van een venster, een geselecteerd rechthoekig of vrij gekozen gebied maken. De afbeeldingen kunnen dan in een aantal formaten worden opgeslagen.</para>

<para
>Rapporteer problemen of verzoeken aan het <ulink url="http://bugs.kde.org/"
>&kde;-bug-opsporingssysteem</ulink
>.</para>

</chapter>

<chapter id="using-ksapshot">
<title
>&ksnapshot; gebruiken</title>

<para
>Dit hoofdstuk beschrijft het gebruik van &ksnapshot; voor het maken van schermafdrukken.</para>

<sect1 id="starting">
<title
>&ksnapshot; starten</title>

<para
>&ksnapshot; kan op diverse manieren gestart worden, zoals hieronder beschreven.</para>

<itemizedlist>
<listitem>
<para
>U kunt &ksnapshot; starten door uit het programma-startmenu <menuchoice
> <guisubmenu
>Programma's</guisubmenu
><guisubmenu
>Grafisch</guisubmenu
> <guimenuitem
>Schermafdrukprogramma &ksnapshot;</guimenuitem
></menuchoice
> te kiezen. </para
></listitem>
<listitem>
<para
>U kunt &ksnapshot; starten door het volgende op de opdrachtregel in te voeren:</para>
<screen width="40"
><prompt
>%</prompt
> <command
>ksnapshot &amp;</command
>
</screen>
</listitem>
<listitem
><para
>De mini-opdrachtregel &krunner; (opgeroepen met <keycombo action="simul"
>&Alt;<keycap
>F2</keycap
></keycombo
>) kan ook gebruikt worden om &ksnapshot; te starten.</para
></listitem>
</itemizedlist>

<para
>Als &ksnapshot; start, ziet u een venster als het onderstaande: <mediaobject>
<imageobject>
<imagedata fileref="window.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Voorbeeldvenster van &ksnapshot;</phrase>
</textobject>
</mediaobject>
</para>

</sect1>

<sect1 id="taking-snapshot">
<title
>Een schermafdruk maken</title>

<para
>&ksnapshot; maakt een schermafdruk van uw gehele bureaublad direct nadat het gestart is, maar voordat het zichzelf op uw scherm toont. Hiermee kunt u snel schermafdrukken van uw volledige bureaublad maken.</para>

<para
>De schermafdruk die door &ksnapshot; gemaakt is wordt in het voorbeeldvenster getoond, dat zich in de bovenaan het toepassingsvenster van &ksnapshot; bevindt. Hieronder ziet u een voorbeeld van het voorbeeldvenster van &ksnapshot;. Uw voorbeeldweergave zal verschillen, afhankelijk van wat u op uw bureaublad heeft.</para>

<mediaobject>
<imageobject>
<imagedata fileref="preview.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Voorbeeldvenster van &ksnapshot;</phrase>
</textobject>
</mediaobject>

<para
>De schermafdruk kan opgeslagen worden door op de knop <guibutton
>Opslaan als...</guibutton
> te klikken (<keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
>) . Dit opent het standaardvenster voor het opslaan van bestanden, waarin u de bestandsnaam, map, en format voor het bestand kunt kiezen. Als er meerdere schermafdrukken worden gemaakt, wordt de bestandsnaam automatisch opgehoogd om te voorkomen dat u vorige schermafdrukken overschrijft. U kunt echter de bestandsnaam wijzigen in alles dat u wilt, ook in de naam van een vorige schermafdruk. </para>

<para
>Om een schermafdruk van een enkel venster te maken, kiest u<guilabel
>Venster onder muiscursor</guilabel
> uit de lijst <guilabel
>Hoe de afdruk te nemen</guilabel
> en daarna klikt u op de knop <guibutton
>Een nieuwe schermafdruk maken</guibutton
> (ook met <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
>).</para>

<para
>Afhankelijk van uw instellingen voor <guilabel
>Vertraging voor schermafdruk</guilabel
> krijgt u een kruis als muispijl (bij <guilabel
>Geen vertraging</guilabel
>) of kunt u doorwerken met een programma totdat de vertragingsperiode voorbij is en de schermafdruk gemaakt wordt.</para>

<para
>Met <guilabel
>Geen vertraging</guilabel
> wordt de schermafdruk onmiddellijk gemaakt zodra u in een venster klikt.</para>

<para
>&ksnapshot; toont de nieuwe schermafdruk in de voorbeeldweergave, waarna u kunt kiezen om de nieuwe afbeelding op te slaan (met de knop <guibutton
>Opslaan als...</guibutton
>) of een nieuwe afbeelding te maken, met de knop <guibutton
>Een nieuwe schermafdruk maken</guibutton
>.</para>

<para
>Om een schermafdruk van het gehele bureaublad te maken, kiest u de optie <guilabel
>Volledig scherm</guilabel
>, en klikt u op <guibutton
>Een nieuwe schermafdruk maken</guibutton
>. &ksnapshot; zal dan het gehele bureaublad in de schermafdruk plaatsen als u op de knop <guibutton
>Een nieuwe schermafdruk maken </guibutton
> klikt.</para>

<para
>Analoog hieraan maakt u een schermafdruk van een rechthoekig gebied door <guilabel
>Rechthoekig gebied</guilabel
> uit de lijst te kiezen, en de <guilabel
>Vertraging voor schermafdruk</guilabel
> op <guilabel
>Geen vertraging</guilabel
> in te stellen, en dan op de knop <guibutton
>Een nieuwe schermafdruk maken</guibutton
> te klikken. De muiscursor verandert in een kruis en u kunt de muis gebruiken om het gebied voor de schermafdruk te selecteren. Om een schermafdruk te maken drukt u op toets &Enter; of dubbelklik. Druk op &Esc; om te annuleren.</para>

<para
>Misschien wilt u een schermafdruk van een niet rechthoekig gebied maken. U kunt dat doen door <guilabel
>Vrij gebied</guilabel
> uit de lijst te kiezen, en de <guilabel
>Vertraging voor schermafdruk</guilabel
> op <guilabel
>Geen vertraging</guilabel
> in te stellen, en dan op de knop <guibutton
>Een nieuwe schermafdruk maken</guibutton
> te klikken. De muiscursor verandert in een kruis en u kunt de muis gebruiken om het gebied voor de schermafdruk te tekenen. Om een schermafdruk te maken drukt u op toets &Enter; of dubbelklik. Druk op &Esc; om te annuleren.</para>

<para
>Om een schermafdruk te nemen van een gedeelte van een venster, selecteer dan <guilabel
>Gedeelte van venster</guilabel
> uit de combobox en klik op de knop <guibutton
>Een nieuwe schermafdruk maken</guibutton
>. Met <guilabel
>Geen vertraging</guilabel
> krijgt u een kruis als muisaanwijzer en moet u één keer met de &LMB; op een venster klikken. Het deel van het venster onder de muiscursor wordt nu aangeduid met een rode rand. Verplaats de muis naar de gewenste sectie en klik op de &LMB; om de schermafdruk te maken. </para>

<para
>Als u meerdere schermen hebt, dan maakt <guilabel
>Huidig scherm</guilabel
> een afdruk van het scherm waar de muiscursor staat op het moment van nemen van de afdruk.</para>

<para
>Bij het open houden van &ksnapshot; om verschillende schermafdrukken te maken met <guibutton
>Rechthoekig gebied</guibutton
> of <guibutton
>Gebied uit de vrije hand</guibutton
>, zullen de volgende schermafdrukken geïnitialiseerd worden met de laatste vorm gebruikt met deze functie (sinds &ksnapshot; hebt gestart). U hebt dan de mogelijkheid om de handvatten van de rechthoekige vorm aan te passen, het gebied uit de vrije hand te verplaatsen of de vorm geheel te vervangen door een nieuwe op een andere plaats van het scherm te tekenen.</para>
</sect1>

<sect1 id="additional-features">
<title
>Verdere mogelijkheden</title>

<sect2 id="delay">
<title
>Vertraging voor schermafdruk</title>

<para
>In het veld <guilabel
>Vertraging voor schermafdruk</guilabel
> kunt u een vertragingstijd invullen, in seconden, tussen het moment dat u de knop <guibutton
>Een nieuwe schermafdruk maken</guibutton
> klikt en het moment dat de schermafdruk gemaakt wordt.</para>

<para
>Als er een vertraging is ingesteld, hoeft u niet op de muisknop te klikken om een schermafdruk te maken. Hiermee kunt u een afrolmenu openen om daar een afbeelding van te maken.</para>

</sect2>

<sect2 id="window-decoration">
<title
>Vensterdecoratie niet opnemen</title>

<para
><guilabel
>Vensterdecoratie ook opnemen</guilabel
> is standaard ingeschakeld in de modus <guilabel
>Venster onder cursor</guilabel
>.</para>

<para
>Als u alleen de toepassing zelf en niet de omringende vensterdecoratie wilt opnemen, schakelt u deze optie uit en maakt u een nieuwe schermafdruk.</para>

</sect2>

<sect2 id="mouse-pointer">
<title
>Muisaanwijzer ook meenemen</title>

<para
><guilabel
>Muisaanwijzer ook meenemen</guilabel
> is standaard uitgeschakeld. Deze instelling is niet aanwezig in de modi <guilabel
>Rechthoekig gebied</guilabel
> en <guilabel
>Vrij gebied</guilabel
>.</para>

<para
>Als u de muisaanwijzer in uw schermafdruk mee wilt nemen, schakelt dan deze optie in en maak een nieuwe schermafdruk.</para>

</sect2>

<!-- not in 4.1
<sect2 id="print-snapshot">
<title
>Print</title>

<para
>When you want to print your snapshot from the preview, just click
<guibutton
>Print...</guibutton
> and you get the standard &kde; Print dialog, from
where you can directly print your snapshot.</para>
</sect2>
-->


<sect2 id="bottom-buttons">
<title
>Knoppen</title>

<para
>Er bevinden zich vier knoppen onderaan het venster van &ksnapshot;. Hun functie wordt hieronder beschreven.</para>

<variablelist>
<varlistentry>
<term
><guibutton
>Help</guibutton
></term>
<listitem
><para
>Geeft u een menu waaruit u het <guimenuitem
>Handboek van &ksnapshot;</guimenuitem
> kunt openen, een bug kunt rapporteren, de taal van &ksnapshot; kunt omschakelen of meer informatie kunt krijgen <guimenuitem
>Over &kde;</guimenuitem
> en <guimenuitem
>Over &ksnapshot;</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Verzenden naar...</guibutton
></term>
<listitem
><para
>Dit stelt u in staat om direct de schermafdruk te open in alle programma's die geassocieerd zijn met het PNG (Portable Network Graphics) MIME-type. Afhankelijk van welke programma's zijn geïnstalleerd, kunt u de schermafdruk openen en bewerken in uw grafische toepassingen.</para>
<para
>Verder, als u de <application
>KIPI-plugins</application
> hebt geïnstalleerd dan kunt u uw schermafdrukken afdrukken, met e-mail verzenden en direct exporteren naar een sociale netwerken en websites, zoals wordt getoond op de onderstaande schermafdruk.</para>
<mediaobject>
<imageobject>
<imagedata fileref="send-to-menu.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>&ksnapshot; menu Verzenden naar... met kipi-plugins geïnstalleerd</phrase>
</textobject>
</mediaobject>
</listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Kopiëren</guibutton
></term>
<listitem
><para
>Indien u uw schermafdruk wil bewerken in een ander programma zonder de afdruk op te slaan, klikt u op <guibutton
>Kopiëren</guibutton
> (<keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>) en voeg de afbeelding in uw programma naar keuze in.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Opslaan als...</guibutton
></term>
<listitem
><para
>De schermafdruk opslaan naar een bestand in het geselecteerde formaat.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="drag-and-drop">
<title
>Slepen en neerzetten</title>
<para
>Een gevangen afbeelding kan versleept worden naar een andere toepassing of document. Als de toepassing afbeeldingen kan behandelen, dan zal een kopie van de volledige afbeelding daar ingevoegd worden. </para>
<para
>Als u een schermafdruk naar een venster van een bestandsbeheerder versleept, zal er een dialoogvenster verschijnen waarin u de bestandsnaam kunt bewerken en het afbeeldingsformat kunt selecteren en het bestand zal ingevoegd worden in de actuele map. </para>
<para
>Als u de schermafdruk naar een tekstvak versleept, dan zal het pad naar het tijdelijk opgeslagen bestand ingevoegd worden. Dit is bijvoorbeeld nuttig bij het uploaden van een schermafdruk via webformulieren of om schermafdrukken in bugrapporten bij te voegen in de <ulink url="https://bugs.kde.org/"
>&kde; bugtracker</ulink
>. </para>
<para
>Dit werkt met alle clients die niet de gegevens van de afbeelding oppakken, maar alleen kijken naar een &URL; in de versleepte mime-gegevens. </para>
 </sect2>
 
</sect1>
</chapter>

<chapter id="dcop">

<title
>&DBus;-interface</title>

<para
>&ksnapshot; kan in een script worden gebruikt via zijn &DBus;-interface.</para>

<para
>Er zijn twee manieren om het &DBus;-interface te gebruiken: &Qt;'s &GUI; <application
>qdbusviewer</application
> en de commandoregel <application
>qdbus</application
>. </para>

<para
>Voorbeelden: <itemizedlist mark='opencircle'>

<listitem
><para
><prompt
>&percnt;</prompt
> <command
>qdbus</command
> toont alle beschikbare services. </para
></listitem>

<listitem
><para
><prompt
>&percnt;</prompt
> <command
>qdbus</command
> <option
>org.kde.ksnapshot-`pidof -s ksnapshot`</option
> toont het &DBus;-interface voor &ksnapshot;. </para
></listitem>

<listitem
><para
><prompt
>&percnt;</prompt
> <command
>qdbus</command
> <option
>org.kde.ksnapshot-`pidof -s ksnapshot` /KSnapshot</option
> toont methoden voor het besturen van &ksnapshot;. </para
></listitem>

</itemizedlist>
</para>

<para
>Voor meer informatie, bezoek het <ulink url="http://techbase.kde.org/Development/Tutorials/D-Bus/Introduction"
>&DBus;-leerboek</ulink
>. </para>

<!--
kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484
/
/KDebug
/KSnapshot
/MainApplication
kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /
method QString org.freedesktop.DBus.Introspectable.Introspect()

kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /KSnapshot
method void org.kde.ksnapshot.slotGrab()
method void org.kde.ksnapshot.slotOpen(QString application)
method void org.kde.ksnapshot.slotSave()
method QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
method void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
method QString org.freedesktop.DBus.Introspectable.Introspect()

kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /MainApplication
method void org.kde.KApplication.quit()
method void org.kde.KApplication.reparseConfiguration()
method void org.kde.KApplication.updateUserTimestamp()
method void org.kde.KApplication.updateUserTimestamp(int time)
property readwrite int com.trolltech.Qt.QApplication.cursorFlashTime
property readwrite int com.trolltech.Qt.QApplication.doubleClickInterval
property readwrite QSize com.trolltech.Qt.QApplication.globalStrut
property readwrite int com.trolltech.Qt.QApplication.keyboardInputInterval
property readwrite bool com.trolltech.Qt.QApplication.quitOnLastWindowClosed
property readwrite int com.trolltech.Qt.QApplication.startDragDistance
property readwrite int com.trolltech.Qt.QApplication.startDragTime
property readwrite QString com.trolltech.Qt.QApplication.styleSheet
property readwrite int com.trolltech.Qt.QApplication.wheelScrollLines
property readwrite QString com.trolltech.Qt.QCoreApplication.applicationName
property readwrite QString com.trolltech.Qt.QCoreApplication.applicationVersion
property readwrite QString com.trolltech.Qt.QCoreApplication.organizationDomain
property readwrite QString com.trolltech.Qt.QCoreApplication.organizationName
method QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
method void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
method QString org.freedesktop.DBus.Introspectable.Introspect()

kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /KDebug
method void org.kde.KDebug.notifyKDebugConfigChanged()
method void org.kde.KDebug.printBacktrace()
method QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
method void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
method QString org.freedesktop.DBus.Introspectable.Introspect()
-->
<!-- dbus-launch ksnapshot-->
<!-- ksnapshot qdbus org.kde.ksnapshot-20985-->
<!--
<para
>To start &ksnapshot; and obtain the right argument, use
<command
>dcopstart ksnapshot</command
>, which returns the 
argument (such as <computeroutput
>ksnapshot-20594</computeroutput
>) on
standard output.</para>

<para
>You can get a list of the available &DCOP; interfaces, use
the right arguments, as shown in this example:
<screen width="60"
>
<prompt>$</prompt> <command>dcop `dcopstart ksnapshot` interface</command><computeroutput>
QCStringList interfaces()
QCStringList functions()
QString url()
void slotGrab()
void slotPrint()
void slotSave()
bool save(QString filename)
void slotSaveAs()
void slotCopy()
void setTime(int newTime)
int timeout()
void setURL(QString newURL)
void setGrabMode(int grab)
int grabMode()
void slotMovePointer(int x,int y)
void exit()
</computeroutput>
</screen>
</para>

<para>
In the examples following, the process is always
<computeroutput
>ksnapshot-23151</computeroutput
>.
</para>

<sect1 id="dcop-settings">

<title
>&DCOP; Access to Settings</title>

<para
>For each of the settings that you can control with the
&GUI;, you can both obtain the current status of that setting,
and modify the setting, using &DCOP;.
</para>

<para
>You can obtain the current capture mode using 
<literal
>grabMode</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface grabMode</command>
</screen>
This will return <computeroutput
>0</computeroutput
> for full-screen capture,
<computeroutput
>1</computeroutput
> for window capture, and <computeroutput
>2</computeroutput>
for region capture.
</para>

<para
>You can set the capture mode using <literal
>setGrabMode</literal
>,
which requires an argument to identify the mode required (as for <literal
>grabMode</literal
>).
So you can set window capture mode (<command
>1</command
>), using:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface setGrabMode 1</command>
</screen>
</para>

<para
>You can obtain the current timeout setting (the <guilabel
>Snapshot delay:</guilabel>
&GUI; item) using <literal
>timeout</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface timeout</command>
</screen>
This will return the timeout setting in seconds, or zero if there is no delay
(capture on click).
</para>

<para
>You can set the timeout using <literal
>setTime</literal
>,
which requires an argument to identify the timeout duration. So you can
set a delay of 4 seconds using:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface setTime 4</command>
</screen>
</para>

<para
>You can obtain the path that the snapshot will be saved to using 
<literal
>url</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt><command>dcop ksnapshot-23151 interface url</command>
</screen>
This will return the filename, as a &URL; (eg as 
<computeroutput
>file:///home/bradh/test2.png</computeroutput
>).
</para>

<para
>You can set the path using <literal
>setURL</literal
>,
which requires a string argument to identify the new path. So you can
set the path to <literal
>file:///home/bradh/snapshot.jpg</literal>
using:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface setURL file:///home/bradh/snapshot.jpg</command>
</screen>
</para>

</sect1>

<sect1 id="dcop-snapshot">
<title
>Taking Screenshots with &DCOP;</title>

<para>
The key to taking screenshots with &DCOP; is use of <literal
>slotGrab</literal
>,
as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotGrab</command>
</screen>
</para>

<para>
This will take a snapshot using the current snapshot mode and timeout settings
(as described above). If you want to save the snapshot image, there are a
number of calls you can use. If you just want to save the image to the current
path (as returned by <literal
>url</literal
> or changed by
<literal
>setURL</literal
>), you can use <literal
>slotSave</literal
>, as shown
below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotSave</command>
</screen>
</para>

<para>
If you want the user to be able to specify a filename (and path), you can use
<literal
>slotSaveAs</literal
>, which will bring up a standard &kde; file
save dialog.</para>

<para>
If you want to save the image to a different name (or path) without
changing the path with <literal
>setURL</literal
>, you can use
<literal
>save</literal
>, providing the &URL; to save to as an argument. So if you
want to save the snapshot to <filename
>file:///tmp/tempshot.png</filename
>, you
can do the following:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface save file:///tmp/tempshot.png</command>
</screen>
Note that this will return true if the snapshot was successfully saved, and false
otherwise. Also, you should be aware that if the file already exists, the user
will get a standard &kde; dialog that requires the user to decide whether to overwrite
or not.
</para>

<para>
In addition to saving the snapshot, you can also copy it to the clipboard, using 
<literal
>slotCopy</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotCopy</command>
</screen>
</para>

<para>
If you need to select a window that may not be under the mouse cursor, you
can use <literal
>slotMovePointer</literal
>, passing the x position
(in screen pixels) and the y position (also in screen pixels) as arguments.
So to move the mouse to the top left hand corner of the screen (0,0), you
can do the following:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotMoveMouse 0 0</command>
</screen>
</para>
</sect1>

<sect1 id="dcop-print">
<title
>Printing Screenshots with &DCOP;</title>

<para>
You can print the current screenshot (which may or may not have been saved)
using <literal
>printSlot</literal
>, as shown below:
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotPrint</command>
</screen>
</para>

<para>
Note that this will bring up the normal &kde; print dialog, which may require
user interaction.
</para>

</sect1>

<sect1 id="dcop-exit">
<title
>&DCOP; Application control</title>

<para>
You can cause &ksnapshot; to exit by using <literal
>exit</literal
>,
as shown below.
<screen width="60"
>
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface exit</command>
</screen>
</para>

</sect1>
-->
</chapter>

<chapter id="credits">

<title
>Dankbetuigingen en licentie</title>

<para
>Programma copyright</para>
<itemizedlist>
<listitem
><para
>1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;</para
></listitem>
<listitem
><para
>2000 &Matthias.Ettrich; &Matthias.Ettrich.mail;</para
></listitem>
</itemizedlist>

<para
>Documentatie gebaseerd op het origineel, copyright 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;</para>
&meld.fouten;&vertaling.niels;&vertaling.sander; 
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>

<!--
Local Variables:
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->




