.. highlightlang:: us

.. index:: Objekt bearbeiten=>Platzhalter-Dialog
.. index:: y^edit-object-place-holder-dialog

.. _objekt-bearbeitenplatzhalter-dialog:
.. _edit-object-place-holder-dialog:

Objekt bearbeiten=>Platzhalter-Dialog
-------------------------------------

Mit diesem Dialogfeld können die Platzhalter der Seite in einem Dialogfeld
bearbeitet werden. Platzhalter sind in Dollar-Zeichen eingeschlossene
Texte. Platzhalter können in Tabellen und Text-Objekten enthalten sein.

.. image:: S:/uniplot-obj/images/EditPlaceholder-de.*

.. us.dialog

.. index::  Objekt bearbeiten=>Platzhalter

.. us.dlgitem

**Text**
   In der ersten Spalte steht der Platzhaltername ohne die umschließenden
   Dollar-Zeichen ($). In der zweiten Spalte steht der Text des Platzhalters, der
   bearbeitet werden kann.

.. us.dialog

.. us.comment

**Kommentar**

Normalerweise wird bei einem Doppelklick auf einen Text ein Dialogfeld 
angezeigt, in dem der Text bearbeitet werden kann. 

Damit dieses Dialogfeld anstatt des Default-Dialogs nach einem Doppelklick auf 
einen Text angezeigt wird, muss man die Option 
``Dialogbox für Platzhalterwerte verwenden`` im Dialogfeld 
:ref:`objekt-bearbeitentabellen-eigenschaften` einschalten oder mindestens
zwei einfache Textobjekte zu einem Objekt gruppiert werden 
(siehe :ref:`symbolleistezeichnen`).

Sollen die Texte der Platzhalter aus einer NC-Datei geladen werden, muss
der in $-Zeichen eingeschlossene Text exakt mit einem Attributnamen 
in der konvertierten NC-Datei übereinstimmen. Die Platzhalter können mit Hilfe
der NC Browsers (:ref:`dateidaten-importieren`) geladen werden. Im Browser-Dialog
muss dann als Typ **Text: Platzhalter laden** ausgewählt werden.

Falls der Attributwert mehrere Elemente enthält (Vektor), so werden die einzelnen 
Elemente durch ein Komma, gefolgt von einem Leerzeichen getrennt. 
Beispiel: "1, 2". 

Zahlenwerte werden in Text umgewandelt.

Um auf die Attribute einer bestimmten Variablen zuzugreifen, wird der Name der
Variablen durch einen Punkt vom Attributnamen getrennt. Beispiel: ``$Mom.long_name$``.

UniPlot konvertiert alle Messdaten-Dateien in das netCDF-Format. Die 
erzeugten Dateien haben die Namenserweiterung .nc. Da die Namen in den 
netCDF-Dateien keine Sonderzeichen enthalten dürfen, werden diese Zeichen bei 
der Konvertierung durch Unterstriche ersetzt. Die erzeugten Namen kann man 
über das Dialogfeld :ref:`dateidaten-importieren` anschauen.
Vor dem Attributnamen kann noch ein Datei-Alias getrennt durch einen Doppelpunkt 
gestellt werden, z. B.: ``$File1:Vers_Nr$``. Der Platzhalter ``$File2:Vers_Nr$``
wird z. B. durch den Text des Attributs ``Vers_Nr`` aus der zweiten Daten-Datei
ersetzt. Der Datei-Alias setzt sich zusammen aus dem Wort ``File`` und einer
folgenden Nummer. Die Nummerierung beginnt mit 1.

Siehe auch: :ref:`text-placeholder`

Beispiele für Platzhalter:

.. list-table::
   :header-rows: 1

   * - Platzhalter
     - Beschreibung
   * - ``$Bearbeiter$``
     - Globales NC-Attribut mit dem Namen ``Bearbeiter``.
   * - ``$Origin$``
     - Globales Attribut mit dem Namen ``Origin``.
   * - ``$Title$``
     - Globales Attribut mit dem Namen ``Title``.
   * - ``$n_Mot.units$``
     - Attribut ``units`` des Kanals ``n_Mot``.
   * - ``$File1:Origin$``
     - Globales Attribut mit dem Namen ``Origin`` aus der ersten Datendatei.
   * - ``$File2:n_Mot.units$``
     - Kanalattribut ``units`` des Kanal ``n_Mot`` aus der zweiten Datendatei.
   * - ``$n_Mot.1$``
     - Erster Kanalwert des Kanals ``n_Mot`` aus der ersten Datendatei.
   * - ``$File3:n_Mot.1;%.1lf$``
     - Erster Kanalwert des Kanals ``n_Mot`` aus der dritten Datendatei. Der Wert wird mit einer Nachkommastelle angezeigt. Eine Beschreibung der Formatanweisung finden Sie in der Dokumentation von :ref:`printf`.
   * - ``$File1:n_Mot.-2; %.2lf$``
     - Vorletzter Datenpunkt des Kanals ``n_Mot``. Der Wert wird mit zwei Nachkommastelle angezeigt.

Falls das Dokument mehrere Seiten mit Platzhaltern enthält, können Sie über die 
Funktion :ref:`diagramm-weitere-diagramm-funktionen-dokument-platzhalter-auswahlen` 
auswählen, welche Platzhalter in allen Seiten den gleichen Text anzeigen sollen.

.. seealso::
   :ref:`objekt-bearbeitentabellen-eigenschaften`,
   :ref:`diagrammweitere-diagramm-funktionenplatzhalter-daten-aus-datei-lesen`,
   :ref:`diagramm-weitere-diagramm-funktionen-dokument-platzhalter-auswahlen`,
   :ref:`textobjekte`,
   :ref:`feldfunktionen`

:sub:`id-1113067`