.. highlightlang:: us

.. index:: Überblick Grafik-Dokumente, Grafik-Dokumente 

.. _uberblick-graphik-dokumente:

Überblick Grafik-Dokumente
==========================

Dieser Überblick zeigt die Arbeit mit Grafik-Dokumenten. Ein Grafik-Dokument
enthält eine oder mehrere Seiten. Die Seiten enthalten Diagramme, die wiederum 
Datensätze (Kurven) und Zeichenobjekte (z. B. Textfelder) enthalten. Es 
gibt also die hierarchische Ordnung:

* Dokumente enthalten Seiten

* Seiten enthalten Diagramme

* Diagramme enthalten Datensätze und Zeichenobjekte

.. image:: S:/uniplot-obj/images/_Overview-Graph.*

Falls Diagramme automatisch erzeugt werden sollen, werden die hier beschriebenen
Funktionen normalerweise nicht verwendet. Man verwendet dazu die sogenannten
batch-Funktionen (siehe :ref:`uberblick-automatisierung-der-diagrammerstellung`). 
Die hier beschriebenen Funktionen sind die Basis-Funktionen, auf denen die
Batch-Funktionen aufbauen.

In den folgenden Abschnitten soll an Beispielen die Verwendung der Funktionen
gezeigt werden.

.. _laden-eines-dokuments-von-der-festplatte:

Laden eines Dokuments von der Festplatte
----------------------------------------

Mit der Funktion :ref:`DocCreate` werden Dateien von der Festplatte gelesen und
in UniPlot geöffnet. Die Funktion wird auch dazu verwendet neue Dokumente zu
erzeugen.

.. us.example

**Beispiel**

Der folgende Funktionsaufruf lädt die Datei :file:`Sample.ipw` von der Festplatte.

::

   hDoc = DocCreate("c:/UniPlot/Samples/Sample.ipw")

Die Funktion gibt eine Zahl zurück (*hDoc*) mit der weitere Funktionen auf das
Dokument zugreifen können. Diese Zahl wird als Handle (sprich händel) oder
Zugriffsnummer bezeichnet. Falls ein Fehler beim Aufruf der Funktion
:ref:`DocCreate` aufgetreten ist, hat *hDoc* den Wert 0. Falls die Funktion
erfolgreich ausgeführt werden konnte, ist *hDoc* eine ganze Zahl größer als 0.
Gültige Zugriffsnummern sind immer größer als 0.

.. us.example

**Beispiel**

Der folgende Funktionsaufruf schließt das Dokument :file:`Sample.ipw` wieder.

::

   DocDestroy(hDoc)

Die Datei wird dabei nicht von der Festplatte gelöscht, sondern nur aus dem
Speicher. Die Funktion :ref:`DocDestroy` löscht dabei auch alle Objekte, die in
dem Dokument enthalten sind, also alle Seiten, Diagramme, Datensätze und
Zeichenobjekte.

.. _dokumente-und-seiten:

Dokumente und Seiten
--------------------

Es soll nun eine Funktion geschrieben werden, die die Seiten in einem Dokument
als Windows-Metadateien (WMF-Datei) speichert. WMF-Datei können z. B. in die
Dokumente der meisten Textverarbeitungsprogramme eingefügt werden.

.. us.example

**Beispiel**

::

   def SaveAsWMF(hDoc)
   {
       nPages = DocGetPageCount(hDoc);
       ssFileName = DocGetPathName(hDoc);
       if (ssFileName == "") {
           error("You must save the document first");
       }
       ssPath = sum(SplitPath(ssFileName)[1:2]);
       nSaved = 0;
       for (i in 1:nPages) {
           hPage = DocGetPageHandle(hDoc, i);
           ssTitle = PageGetTitle(hPage);
           ssFile = ssPath + ssTitle + ".WMF";
           if (PageSaveAsMetafile(hPage, ) == FALSE) {
               Event_Warning("SaveAsWMF", sprintf("Can't save %s", ssFile));
               break;
           }
           nSaved = nSaved + 1;
       }
       return nPages;
   }

.. us.example

**Beispiel**

::

   hDoc = DocCreate("c:/UniPlot/Samples/Sample.ipw")
   SaveAsWMF(hDoc)

.. _diagramme-und-datensatze:

Diagramme und Datensätze
------------------------

.. us.example

**Beispiel**

::

   hDoc = DocCreate()
   hPage = PageCreate()
   DocAddPage(hDoc, hPage)
   hLayer = LayerCreate()
   PageAddLayer(hPage, hLayer)
   x = [1, 2, 3]
   y = [1, 5, 2]
   hData = XYCreate("sample", x, y)
   LayerAddDataset(hLayer, hData)
   PageReplot(hPage)

.. _funktionen-fur-graphik-dokumente:

Funktionen für Grafik-Dokumente
-------------------------------

*  :ref:`uberblick-dokumente`

*  :ref:`uberblick-dokument-seiten`

*  :ref:`uberblick-diagramme`

.. _datensatze:

Datensätze
----------

*  :ref:`uberblick-xy-datensatze`

*  :ref:`uberblick-xyz-datensatze`

.. _zeichenobjekte-overview:

Zeichenobjekte
--------------

*  :ref:`uberblick-zeichenobjekte`

*  :ref:`uberblick-textobjekte`

*  :ref:`uberblick-linien-und-pfeile`

*  :ref:`uberblick-kreise-und-ellipsen`

*  :ref:`uberblick-rechteckobjekte`

.. _attribut-objekte:

Attribut-Objekte
----------------

*  :ref:`uberblick-pens`

*  :ref:`uberblick-fonts`

*  :ref:`uberblick-schraffuren`

*  :ref:`uberblick-marker`

.. seealso::
   :ref:`funktionen-eingeteilt-in-kategorien`

:sub:`id-574694`